User Interface Technical Reference

View as Markdown

User Interface State

UserInterfaceState

User Interface section of Adaptable State, including Initial State.

HideAdaptableUI hides the Dashboard, Tool Panel, Status Bar, and the column and context menus. The default is false.

Extends

BaseState

Hides all AdapTable UI elements (i.e. Dashboard, Tool Panel, Status Bar, Column & Context Menus etc.)

Default

false


User Interface Options

UserInterfaceOptions

Options for managing the User Interface of AdapTable

Alternative icons to use for Adaptable Modules in the UI (Settings Panel,
Dashboard / Tool Panel buttons, Status Bar, menus, etc.)

Default

null

Alternative names to use for Adaptable Modules in the UI

Default

null

The application icon to appear in Dashboard and elsewhere (e.g. in Notifications)

Default

null

Options for the Colour Picker, including which colours to display

Bespoke icons that can be used in AdapTable (e.g. Badge Styles and Buttons)

Options for managing and customizing date inputs in AdapTable

Hides confirmation dialog which displays whenever an AdaptableObject is deleted

Default

false

Style to set for editable Cells

Style to set for Cells which have been edited

englishVariant?

'GB' | 'US'

English variant to use in AdapTable UI

Default

'GB'

Options for showing Loading Screen (during initialisation)

Optional list of AdaptableObjectTags that can be associated with AdaptableObjects.

When provided as a function, return undefined to provide no tags.

Style to set for non-editable Cells

Displays the AdapTable version in Grid Info section of Settings Panel

Default

true

Displays the AG Grid version in Grid Info section of Settings Panel

Default

true

Optional list of CSS styles that can be used when creating Adaptable Styles in Adaptable (e.g. in Format Column and other Modules)

Default

[]

Show Mac-like scrollbars; size is configurable via CSS variable --ab-custom-scrollbar-size (default: 10px)

Default

false

Loading Screen Options

LoadingScreenOptions

Options for the Loading Screen shown when AdapTable is initialising

Delay in ms before Loading Screen appears

Default

200

Text to display in Loading Screen.

Default

'Retrieving your settings and setting up the grid...'

Title to display in Loading Screen.

Default

'Initialising Grid'

Display Loading Screen when AdapTable initialises

Default

true

Find Out More

See Configuring the Loading Screen for full instructions

Date Input Options

DateInputOptions

Options for managing and customizing the date inputs.

dateFormat?

string

Format string for formatting date input field

Default

'yyyy-MM-dd' (ISO 8601 format)

datepickerButtons?

DatepickerButton[]

List of buttons which are displayed in the datepicker overlay in the given order (provide empty array to display no buttons); custom button layout and positioning is achievable with the special elements - and |

Default

['close','today']

locale?

any

Locale object (to localize Date Picker)

Default

en-US

Display outside days (i.e. those falling in next or previous month)

Default

true

Display the week numbers column

Default

false

Use browser specific date input instead of AdapTable's Date Picker

Default

false

Find Out More

The dateInputOptions are described in greater detail in the Date Picker Guide

Colour Picker Options

ColourPickerOptions

Options for the Colour Picker.

Chooses which of the supplied colours (theme & colour palette) the Palette tab shows

Orders Palette swatches around the colour wheel; if false, each colour stays the order supplied

Default

true

Leave out duplicates of swatches already displayed

Default

true

Show Theme and Palette headings on the Palette tab (if both have colours)

Default

false

Colour Picker tabs to display in order provided; Custom, Palette, or both

Default

['Custom', 'Palette']

Find Out More

See Configuring the Colour Picker for the full guide


User Interface API

UserInterfaceApi

Icons, editable and read-only styles, the progress indicator, custom windows, and showing or hiding the UI.

Closes a custom window

Retrieves all objects in list which contain the given Tag

Retrieves any Object Tags (provided in User Interface Options)

Retrieves Custom Icons provided by users

Returns Style set for Editable cells

Returns Style for Cells that have been edited

Returns Style set for ReadOnly Cells

getStyleClassNames()
returns

string[] | undefined

Retrieves any Style Class Names from User Interface Options

Retrieves the current User Interface State

Hides all AdapTable UI elements (Dashboard, Tool Panel, Status Bar, Column and Context Menus etc.)

Hides the progress indicator

Returns whether the AdapTable UI is currently visible

openCustomWindowPopup(config)
returns

{ close: () => void; }

Opens a custom window popup

Shows all AdapTable UI elements (Dashboard, Tool Panel, Status Bar, Column and Context Menus etc.)

showProgressIndicator(config)
returns

{ close: () => void; }

Displays a progress indicator