sheetjs/docbits/62_colrow.md
SheetJS dcee744e4e row and column size and visibility
- XLSX/XLSB/XLS/XLML/SYLK rows and columns
- corrected pixel/point calculations using PPI
- XLSX/XLSB generate sheet view
- clarified sheet protection default behavior
- fixed eslintrc semi check
2017-04-28 03:40:40 -04:00

2.0 KiB

Column Properties

Excel internally stores column widths in a nebulous "Max Digit Width" form. The Max Digit Width is the width of the largest digit when rendered. The internal width must be an integer multiple of the the width divided by 256. ECMA-376 describes a formula for converting between pixels and the internal width.

Given the constraints, it is possible to determine the MDW without actually inspecting the font! The parsers guess the pixel width by converting from width to pixels and back, repeating for all possible MDW and selecting the MDW that minimizes the error. XLML actually stores the pixel width, so the guess works in the opposite direction.

The !cols array in each worksheet, if present, is a collection of ColInfo objects which have the following properties:

type ColInfo = {
	MDW?:number;     // Excel's "Max Digit Width" unit, always integral
	width:number;    // width in Excel's "Max Digit Width", width*256 is integral
	wpx?:number;     // width in screen pixels
	wch?:number;     // intermediate character calculation
	hidden:?boolean; // if true, the column is hidden
};

Even though all of the information is made available, writers are expected to follow the priority order:

  1. use width field if available
  2. use wpx pixel width if available
  3. use wch character count if available

Row Properties

Excel internally stores row heights in points. The default resolution is 72 DPI or 96 PPI, so the pixel and point size should agree. For different resolutions they may not agree, so the library separates the concepts.

The !rows array in each worksheet, if present, is a collection of RowInfo objects which have the following properties:

type RowInfo = {
	hpx?:number;     // height in screen pixels
	hpt?:number;     // height in points
	hidden:?boolean; // if true, the row is hidden
};

Even though all of the information is made available, writers are expected to follow the priority order:

  1. use hpx pixel height if available
  2. use hpt point height if available