sheetjs/docbits/54_shobject.md
SheetJS 5187bc0b63 Basic AutoFilter Read/Write
- XLSX/XLSB read/write autofilter
- XLS/XLML/*ODS read autofilter
- Workbook Properties override via Props option
- XLSB write sheet protection

Issues:
- fixes #472 h/t @nishthasb
- fixes #478 h/t @yonatannn
- see #623 h/t @jcarvin
2017-04-10 01:11:32 -04:00

2.8 KiB

Worksheet Object

In addition to the base sheet keys, worksheets also add:

  • ws['!cols']: array of column properties objects. Column widths are actually stored in files in a normalized manner, measured in terms of the "Maximum Digit Width" (the largest width of the rendered digits 0-9, in pixels). When parsed, the column objects store the pixel width in the wpx field, character width in the wch field, and the maximum digit width in the MDW field.

  • ws['!merges']: array of range objects corresponding to the merged cells in the worksheet. Plaintext utilities are unaware of merge cells. CSV export will write all cells in the merge range if they exist, so be sure that only the first cell (upper-left) in the range is set.

  • ws['protect']: object of write sheet protection properties. The password key specifies the password. The writer uses the XOR obfuscation method. The following keys control the sheet protection (same as ECMA-376 18.3.1.85):

key functionality disabled if value is true
selectLockedCells Select locked cells
selectUnlockedCells Select unlocked cells
formatCells Format cells
formatColumns Format columns
formatRows Format rows
insertColumns Insert columns
insertRows Insert rows
insertHyperlinks Insert hyperlinks
deleteColumns Delete columns
deleteRows Delete rows
sort Sort
autoFilter Filter
pivotTables Use PivotTable reports
objects Edit objects
scenarios Edit scenarios
  • ws['!autofilter']: AutoFilter object following the schema:
type AutoFilter = {
	ref:string; // A-1 based range representing the AutoFilter table range
}

Chartsheet Object

Chartsheets are represented as standard sheets. They are distinguished with the !type property set to "chart".

The underlying data and !ref refer to the cached data in the chartsheet. The first row of the chartsheet is the underlying header.