Version 23 Developer Release Note

AdapTable 23.0 is a major version release.

It contains a refactored and enhanced AdapTable UI and 4 new user-requested Styled Columns.

---

Styled Columns

• AdapTable 23.0 contains a very big refactoring of, and expansion to, Styled Columns

• AdapTable now provides 4 new Styled Columns (in response to user requests):

  • Bullet Chart Style - renders a bullet graph inside a cell
  • Rating Style - displays a row of icons (e.g. stars) scaled to the cell value
  • Icon Style - maps cell values to icons with presets and optional cell text
  • Range Bar Style - shows value and optional reference on track between min & max

• Additionally we made improvements to the 4 existing Styled Columns including:

  • Gradient Style - includes a new zero-centred range (for columns with negative numbers)
  • Percent Bar Style - provides better support for negative ranges
  • Badge Style - has a large number of new styling and formatting options
  • Sparkline Column - improved UI makes it easier to create sparklines at runtime

---

Scheduling

• Scheduling has been refactored in AdapTable 23.0 in significant ways:
  • Reminders have been replaced with Scheduled Alerts - a new type of Alert
  • Scheduled Reports are now part of the Report object (and persisted in Export state)
  • The Schedule object now fully supports Cron expressions
  • AdapTable users can more easily create either one-off or recurring schedules

---

General Enhancements

• Calculated Column now Flash and trigger Alerts when their values (dynamically) change
• Column Menu and Context Menu now both support Framework (i.e. React, Angular or Vue) components
• Custom Toolbars can now include an Adaptable Form
• Options to show Notes and Comments via Menu (and not only by hover)
• Grid Info Panel now also lists all Adaptable Options
• Numeric Presets have been significantly expanded (e.g. Euro, Bitcoin, Scientific, Accounting, FX Rate etc) and can be provided - and persisted - as part of the Format Column definition
• Developers (and end users) can provide custom increment / decrement keys for Plus Minus
• Weighted Average aggregations can be set directly from Column Menu
• All 3 custom Quick Search Styles can be set via the Settings Panel
• Improved way of setting custom navigation in Settings Panel (including headers)

---

UI Changes

• The index.css file now contains both base styles (the light and dark Themes)

  Important

  This means you now only need to import one CSS file, instead of two

• Improvements to usability and flexibility of the UI Wizards and new Select and Dropdown components

• Further integration with Tailwind

  Note

  • All AdapTable CSS classes have the twa: prefix, so they won't collide with your app if you use Tailwind
  • If using Tailwind we recommend this CSS layer order: @layer theme, base, components, adaptable, utilities
  • The Adaptable styles are all scoped inside the adaptable CSS layer

• Comprehensive accessibility (ARIA) and keyboard support in AdapTable UI — menus, dialogs, dropdowns and wizards follow WAI-ARIA Authoring Practices by default

  Find Out More

  • See Accessibility & Keyboard Support for further details about the changes made
  • For background on the UI refresh, see the blog post on Tailwind, shadcn and Base UI in AdapTable

• The Colour Palette has been extended and made easier to use and customise

---

Technical Reference

• As a result of the changes to Scheduling (see above) these objects and classes were all removed:

  • The Schedule Module
  • The Schedule section of Adaptable State
  • The ScheduleAPI section of Adaptable API
  • The ScheduleTriggered Adaptable Event

• The previously deprecated getPersistedState function in State API method was removed (and now only its replacement, getPersistentState, remains):

  Note

  This is in line with our policy of removing deprecated methods on the 3rd major release post deprecation

• The navigation property in Settings Panel Options returns a new SettingsPanelNavigationConfigurer object (that allows more flexible configuration options)

  Important

  The previous navigation object is still supported but marked as deprecated and will be removed in a future version

---

Documentation

• Docs updates as part of ongoing efforts to help devs and users find what they need in AdapTable:
  • Now Framework focussed - you pick a Framework and only see docs and demos for that Framework
  • 8 New Showcase Demos showing AdapTable tackling real world use cases
  • A Feature list detailing all AdapTable features and associated dev properties and UI components
  • A What's New page listing new releases, features and blog posts

---

Change Log

Key	Type	Description
AT-3389	Task	✅ Replace Reminders with Scheduled Alerts
AT-3388	Enhancement	✅ Add new Numeric Presets to Format Column
AT-3387	Enhancement	✅ Add "live" Preview to Format Column and Styled Column Wizards
AT-3378	Enhancement	✅ Improve how users can configure Settings Panel
AT-3367	Enhancement	✅ Add comprehensive accessibility (ARIA) and keyboard support
AT-3365	Enhancement	✅ Add ability to configure all 3 Quick Search styles in UI
AT-3363	Enhancement	✅ Allow Weighted Average to be set from Column Menu
AT-3362	Task	✅ Improve contents and flexibility of Colour Palette
AT-3361	Enhancement	✅ Layouts should support AG Grid full width group rows
AT-3360	Enhancement	✅ Replace DropdownButton with new component
AT-3357	Documentation	✅ Refactor Docs to be Framework focussed
AT-3354	Task	✅ Support AG Grid 35.3
AT-3350	Enhancement	✅ Enable custom plus minus keys
AT-3349	Bug	✅ Fix maths imprecision error in Plus Minus
AT-3347	Enhancement	✅ Add new Range Bar Styled Column
AT-3346	Enhancement	✅ Add new Icon Styled Column
AT-3341	Enhancement	✅ Add new Rating Styled Column
AT-3340	Enhancement	✅ Add new Bullet Chart Styled Column
AT-3333	Enhancement	✅ Show Adaptable Options in Grid Info panel
AT-3332	Enhancement	✅ Add options to show Notes and Comments via Menu and not hover
AT-3329	Task	✅ Add Cron Expressions to Schedules
AT-3328	Bug	✅ Empty values display in Date Column OrderedValues for In Filter
AT-3318	Enhancement	✅ Tooltips should wrap in In Filter
AT-3301	Enhancement	✅ Add Zero Gradient to Gradient Columns
AT-3265	Enhancement	✅ Improve Handling of Negatives in Percent Bars
AT-2934	Task	✅ Allow Custom Toolbar to display Forms
AT-2779	Enhancement	✅ Make Format Column presets part of Definition
AT-2488	Enhancement	✅ Support framework components in custom Menu Items
AT-2390	Enhancement	✅ Improve alert tone selector to show color that tone refers to
AT-2372	Enhancement	✅ Adjust all inputs to have consistent sizes
AT-1907	Enhancement	✅ Enable Calculated Columns to flash when value changes
AT-1788	Enhancement	✅ Set Alerts to fire in response to Calculated Column changes

AdapTable Resources

• Styled Columns
• Scheduled Alerts
• Scheduled Reports
• Calculated Column
• Numeric Presets
• Weighted Average
• AdapTable UI Components
• Accessibility & Keyboard Support