Skip to content
TREB Docs

EmbeddedSpreadsheetOptions

EmbeddedSpreadsheetOptions interface

options for creating spreadsheet

Members
add_taboptional
boolean
boolean
allow add/delete tab
chart_menuoptional
boolean
boolean
include the chart menu in the toolbar
collapsedoptional
boolean
boolean
start with sidebar closed. defaults to false.
complexoptional
'on' | 'off'
'on' | 'off'
enable handling complex numbers in function calculation. turning this off doesn't actually disable complex numbers. it means that functions will not return complex numbers unless one of the arguments is complex.
constrain_widthoptional
boolean
boolean
even if we allow resizing, constrain width. this is to support fixed width columns.
containeroptional
string | HTMLElement
string | HTMLElement
containing HTML element
delete_taboptional
boolean
boolean
show delete tab (deprecated)
dndoptional
boolean
boolean
allow drag-and-drop files
documentoptional
string
string
fetch network document. this is a replacement for the old (deprecated) option `network_document`.
expandoptional
boolean
boolean
expandable grid. if this option is false, the grid will always stay the same size -- if you keep pressing down arrow, it won't grow. defaults to true.
expand_formula_buttonoptional
boolean
boolean
expand formula bar
exportoptional
boolean
boolean
export to xlsx, now optional
file_menuoptional
boolean
boolean
include the file menu in the toolbar
font_scaleoptional
boolean
boolean
include the font scale control in the toolbar
formula_baroptional
boolean
boolean
show formula bar. default true.
freeze_buttonoptional
boolean
boolean
include the freeze button in the toolbar
freeze_columnsoptional
number
number
freeze columns
freeze_rowsoptional
number
number
freeze rows
global_nameoptional
string
string
set a reference in global (self)
headersoptional
boolean
boolean
row/column headers
headlessoptional
boolean
boolean
better support for headless operations (default false)
hyperlinksoptional
string | false
string | false
target window for hyperlinks (default _blank); set false to disable hyperlinks altogether
imaginary_valueoptional
string
string
for rendering the imaginary number. this is intended to support switching to a different character for rendering, or adding a leading space/half-space/hair-space. this _does_not_ change how you enter imaginary numbers, you still have to use `i` (lower-case ascii i).
in_cell_editoroptional
boolean
boolean
support in-cell editor
indent_buttonsoptional
boolean
boolean
indent/outdent buttons; default false
languageoptional
string
string
language. at the moment this controls spreadsheet function names only; the plan is to expand to the rest of the interface over time. should be an ISO 639-1 language code, like "en", "fr" or "sv" (case insensitive). we only support a limited subset of languages at the moment. leave blank or set to "locale" to use the current locale.
local_storageoptional
string | boolean
string | boolean
persist user changes to document in browser localStorage. if set to a string, the value is used as the storage key. if set to `true`, we will generate a storage key based on the page URI. don't do that if you have multiple spreadsheets on a single page, or they will overwrite each other.
markdownoptional
boolean
boolean
support markdown formatting for text in cells and comments. at the moment we only support bold, italic, and strike text.
max_file_sizeoptional
number
number
max size for image, in bytes
network_documentoptional
string
string
fetch network document (URI) (deprecated)
persist_scaleoptional
boolean | string
boolean | string
save/load scale. this can optionally have a string key to disambiguate
prompt_saveoptional
boolean
boolean
prompt "you have unsaved changes"
recalculateoptional
boolean
boolean
recalculate on load
recalculate_on_f9optional
boolean
boolean
handle the F9 key and recalculate the spreadsheet. for compatibility. we're leaving this option to default `false` for now, but that may change in the future. key modifiers have no effect.
resizableoptional
boolean
boolean
add resizable wrapper
revert_buttonoptional
boolean
boolean
show the revert button in the sidebar. see the `Revert` method. this was renamed from `revert` to avoid any ambiguity.
revert_indicatoroptional
boolean
boolean
show the revert indicator. this is an indicator that shows on the top-left of the spreadsheet when a network document has local changes.
scaleoptional
number
number
initial scale
scale_controloptional
boolean
boolean
show scale control (slider) under the spreadsheet.
scrolloptional
string | ICellAddress
string | ICellAddress
scroll to cell on load
scrollbarsoptional
boolean
boolean
show scrollbars
sheetoptional
string
string
sheet to show on load, overrides anything in the model
spilloptional
boolean
boolean
enable spill arrays and spill references. this is on by default starting in 30.1.0. set to false to disable.
spinneroptional
boolean
boolean
show a spinner for long-running operations
statsoptional
boolean
boolean
show the stats panel under the spreadsheet.
storage_keyoptional
string | boolean
string | boolean
key in localStorage for persisting document. (deprecated)
tab_baroptional
boolean | 'auto'
boolean | 'auto'
show tab bar (multi sheet)
table_buttonoptional
boolean
boolean
include the insert/remove table button in the toolbar
tint_theme_colorsoptional
boolean
boolean
show tinted colors in toolbar color dropdowns. as of version 25 this defaults to true (used to be false).
toll_initial_loadoptional
boolean
boolean
don't load immediately (?)
toolbaroptional
boolean | 'show' | 'narrow' | 'show-narrow'
boolean | 'show' | 'narrow' | 'show-narrow'
toolbar display option. true or false means include/don't include the toolbar (and the toolbar button). setting to "narrow" means include the toolbar, but use a narrow version (it compresses the align/justify groups). the toolbar usually starts hidden. if you set this option to "show", it will start visible. same for "show-narrow".
toolbar_recalculate_buttonoptional
boolean
boolean
include a recalculate button in the toolbar
undooptional
boolean
boolean
support undo
Referenced by
TREBGlobal.CreateSpreadsheet
EmbeddedSpreadsheet.LoadNetworkDocument