diff --git a/docz/docs/08-api/09-utilities.md b/docz/docs/08-api/09-utilities.md index ef4b78d..15b76ee 100644 --- a/docz/docs/08-api/09-utilities.md +++ b/docz/docs/08-api/09-utilities.md @@ -22,7 +22,7 @@ The examples are based on the following worksheet: -### Array of Arrays Input +## Array of Arrays Input **Create a worksheet from an array of arrays** @@ -105,7 +105,7 @@ XLSX.utils.sheet_add_aoa(ws, [[5,6,7], [6,7,8], [7,8,9]], {origin:{r:1, c:4}}); XLSX.utils.sheet_add_aoa(ws, [[4,5,6,7,8,9,0]], {origin: -1}); ``` -### Array of Objects Input +## Array of Objects Input **Create a worksheet from an array of objects** @@ -272,7 +272,7 @@ function SheetJSHeaderOrder() { ::: -### HTML Table Input +## HTML Table Input **Create a worksheet or workbook from a TABLE element** @@ -425,7 +425,38 @@ function MultiTable() { } ``` -### Delimiter-Separated Output +### Value Override + +When the `raw: true` option is specified, the parser will generate text cells. +When the option is not specified or when it is set to false, the parser will +try to interpret the text of each TD element. + +To override the conversion for a specific cell, the following data attributes +can be added to the individual TD elements: + +| Attribute | Description | +|:----------|:----------------------------------------------------------| +| `data-t` | Override [Cell Type](../csf/cell#data-types) | +| `data-v` | Override Cell Value | +| `data-z` | Override [Number Format](../csf/features/#number-formats) | + +For example: + +```html + +2012-12-03 + + +2012-12-03 + + +2012-12-03 + + +2012-12-03 +``` + +## Delimiter-Separated Output ```js var csv = XLSX.utils.sheet_to_csv(ws, opts); @@ -490,7 +521,7 @@ the output will be encoded in `CP1200` and the UTF-16 BOM will be added. `XLSX.utils.sheet_to_txt` takes the same arguments as `sheet_to_csv`. -### HTML Output +## HTML Output ```js var html = XLSX.utils.sheet_to_html(ws, opts); @@ -524,7 +555,7 @@ function SheetJSHTML() { } ``` -### Array Output +## Array Output ```js var arr = XLSX.utils.sheet_to_json(ws, opts); @@ -613,7 +644,7 @@ function SheetJSToJSON() { } ``` -### Formulae Output +## Formulae Output ```js var fmla_arr = XLSX.utils.sheet_to_formulae(ws);