Settings Panel Technical Reference

View as Markdown

Settings Panel Options

SettingsPanelOptions

Options for managing the AdapTable Settings Panel

Whether a Settings Panel button should always be displayed in ModuleButtons area of ToolPanel

Default

false

Custom Settings Panels provided by developers at design-time

Display / chrome options for Settings Panel navigation (icons, descriptions, search, collapse).

gridInfoTabs?

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

Default

['Grid Summary', 'Layout', 'Grid State', 'Grid Options']

icon?

'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'.

Default

'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

Default

'modal'

Initial position of Settings Panel — pixel offset of top-left corner from top-left of viewport (requires popupType to be 'window')

Default

Middle of Screen

Initial size (in pixels) of Settings Panel (requires popupType to be 'window')

Default

Computed based on size of screen

title?

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'.

Default

adaptableId, or 'Grid Settings' when adaptableId is unset / generic

Display Options

SettingsPanelDisplayOptions

Display options for Settings Panel navigation.

Whether users can collapse Settings Panel navigation to an icon rail

Default

true

Whether to show Description subtitles under each Module in Settings Panel navigation

Default

true

Whether to show Icons for each Module when navigation is expanded.
Collapsed (icon-rail) navigation always shows icons.

Default

true

Whether to show the module search field above Settings Panel navigation

Default

true

Custom Settings Panels

customSettingsPanels is a list of CustomSettingsPanel objects:

CustomSettingsPanel

Definition of a Custom Panel to add to the Adaptable Settings Panel

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

name

string

Appears in Settings Panel Navigation. Include in navigation to choose placement
(by default added to a Custom Panels group at the end).

render?

(customRenderContext:CustomRenderContext) => string | null

Function to provide bespoke content when NOT using a Framework wrapper

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.

x

number

Distance from the left edge of the viewport, in pixels.

y

number

Distance from the top edge of the viewport, in pixels.

WindowSize

Initial dimensions (in pixels) of a window.

height

number

Height of the window, in pixels.

width

number

Width of the window, in pixels.


Settings Panel API