sheetjs/docbits/56_wbprops.md
SheetJS 0189bc23ca Defined Names
- XLSX read/write defined names
- XLSB/XLS/XLML read defined names

Issues:
- fixes #83 h/t @developergdd
- fixes #6 , fixes #599
2017-04-11 18:15:36 -04:00

1.2 KiB

Workbook File Properties

The various file formats use different internal names for file properties. The workbook Props object normalizes the names:

JS Name Excel Description
Title Summary tab "Title"
Subject Summary tab "Subject"
Author Summary tab "Author"
Manager Summary tab "Manager"
Company Summary tab "Company"
Category Summary tab "Category"
Keywords Summary tab "Keywords"
Comments Summary tab "Comments"
LastAuthor Statistics tab "Last saved by"
CreatedDate Statistics tab "Created"

For example, to set the workbook title property:

if(!wb.Props) wb.Props = {};
wb.Props.Title = "Insert Title Here";

Custom properties are added in the workbook Custprops object:

if(!wb.Custprops) wb.Custprops = {};
wb.Custprops["Custom Property"] = "Custom Value";

Writers will process the Props key of the options object:

/* force the Author to be "SheetJS" */
XLSX.write(wb, {Props:{Author:"SheetJS"}});