Settings Panel Technical Reference
Settings Panel Options
SettingsPanelOptions
Options for managing the AdapTable Settings Panel
boolean
Whether a Settings Panel button should always be displayed in ModuleButtons area of ToolPanel
false
Custom Settings Panels provided by developers at design-time
Display / chrome options for Settings Panel navigation (icons, descriptions, search, collapse).
GridInfoTabs
Which Tabs to show in Grid Info: 'Grid Summary', 'Layout', 'Grid State' or 'Grid Options'
Tab labels in the UI are Summary, Layout, State and Options
['Grid Summary', 'Layout', 'Grid State', 'Grid Options']
'ConfigurationIcon' | 'ApplicationIcon' |AdaptableIcon
Icon shown in top left of Settings Panel: Can be ConfigurationIcon, ApplicationIcon or custom Icon.
When omitted, uses 'ApplicationIcon' if userInterfaceOptions.applicationIcon is set,
otherwise 'ConfigurationIcon'.
'ApplicationIcon' when an application icon is provided, else 'ConfigurationIcon'
How the Settings Panel is rendered: 'modal' (centred and unmovable and resizable) or 'window' (supports size, position, drag and resize); ignored if containerOptions.modalContainer is set
'modal'
Initial position of Settings Panel — pixel offset of top-left corner from top-left of viewport (requires popupType to be 'window')
Middle of Screen
Initial size (in pixels) of Settings Panel (requires popupType to be 'window')
Computed based on size of screen
string
Runtime display name for the panel chrome, menus, and tooltips. End users never see the
internal name “Settings Panel” — they see this title instead.
When omitted, resolves to AdaptableOptions.adaptableId if that is a meaningful
(non-generic) value, otherwise 'Grid Settings'.
adaptableId, or 'Grid Settings' when adaptableId is unset / generic
Display Options
SettingsPanelDisplayOptions
Display options for Settings Panel navigation.
boolean
Whether users can collapse Settings Panel navigation to an icon rail
true
boolean
Whether to show Description subtitles under each Module in Settings Panel navigation
true
boolean
Whether to show Icons for each Module when navigation is expanded.
Collapsed (icon-rail) navigation always shows icons.
true
Custom Settings Panels
customSettingsPanels is a list of CustomSettingsPanel objects:
CustomSettingsPanel
Definition of a Custom Panel to add to the Adaptable Settings Panel
string
Short subtitle shown under the name in Settings Panel navigation.
Framework-specific (Angular, React or Vue) component to be rendered
Icon rendered inside settings-panel name, inside the navigation
string
Appears in Settings Panel Navigation. Include in navigation to choose placement
(by default added to a Custom Panels group at the end).
(customRenderContext:CustomRenderContext) => string | null
Function to provide bespoke content when NOT using a Framework wrapper
Popup
popupType is a PopupType:
| Value |
|---|
'modal' |
'window' |
position is a WindowPosition and size is a WindowSize:
WindowPosition
Pixel offset of a window's top-left corner from the top-left of the viewport.
WindowSize
Initial dimensions (in pixels) of a window.
Settings Panel API
SettingsPanelApi
Provides run-time access to the Settings Panel
void
Closes Settings Panel
void
Opens Settings Panel with the Custom Settings Panel, provided by name, displayed
void
Opens Settings Panel and displays specified Module (if provided) or first available one