Changelog

Containers​

This week we’re highlighting some major improvements to containers including support for multiple views, collapsible containers, and new presets for multistep flows and tabs.

Multiview

Multiview makes it easy to swap between different groups of components within a single Container. Add any number of views via the Inspector, each with a grid to drag components onto. The current view can be controlled with event handlers, the setView API, or conditional logic in the default view settings.

You can enable multiview on any Container, but we’re also launching presets for common multiview patterns:

Tabbed Container

The redesigned Tabbed Container comes pre-configured with a Tabs component linked to a multiview Container. Tabs can now be moved and customized independently, and individual tabs can be disabled or hidden.****

---Stepped Container

The brand new Stepped Container provides a quick and easy way to build beautiful multi-step flows. Like Tabbed, it comes pre-configured with the new Steps component linked to a multiview Container, along with next and previous Buttons.****

****

Collapsible Container​

Container and Form now include a “Show body” setting, along with new APIs to show/hide the header, body, and footer. Get started quickly with the new Collapsible Container, which includes a Toggle Button wired up to expand and collapse the body of its Container.

To learn more about all of these new features, check out our Containers docs. And if you have any feedback, we’d love to hear from you in our community forum.

Fixes and improvements​

• Improved styling of disabled components to improve readability
• Fixed keyboard navigation for disabled components
• Added more information, like the type of the value, in the SQL editor when SQL is evaluated
• Fixed File Dropzone, File Button, and File Input in List Views
• Added an option to Table components to "Disable user selection." If enabled, selection can only happen via the editor inspector or JS APIs. Click and arrow keys are ignored.
• Improved List View rendering performance
• Fixed the columnMappers property on the Table component to update when data changes
• Added the ability to hover over the extra indicator (e.g. "+10") for the Tags component to see the other tags
• (enterprise only) Fixed the keyboard shortcut_ CMD+SHIFT+P_ (CTRL+ SHIFT + P) so that it doesn't drop you into a non-editable protected branch

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Options list editor​

Many components present a list of options, like the dropdown in a Select or the radio buttons in a Radio Group; we’ve made it much easier to build this kind of UI with our new options list editor. We’ve also added new settings for those options, like captions and tooltips.

These types of components now have a new Options section, with two modes: Manual and Mapped. If you have a short list of options (e.g. Cherry, Apple, Orange, Kiwi), quickly configure your component in Manual mode by adding them to the reorderable list:

Sometimes you’ll need to generate a list of options from a dynamic data source like a query or transformer, or from a large array or JS expression. Switch into Mapped mode to quickly set up these dynamic options lists:

New settings​

In both Manual and Mapped mode, you can configure settings (caption, tooltip, hidden, disabled) for each item in your list of options.

In Manual mode, just click on an option and enter values for each setting (e.g. “caption ABC”, {{ checkbox1.value }}):

Mapped mode works similar to the .map method on an array. You have access to a special keyword, item, which will allow you to map each item in your data source to these settings you’ve configured:

The new options list editor is much more powerful–dig into our docs to learn more. We’re also working on supporting more settings, like images and colors for options in a Select dropdown. Let us know in our community forum if you have any feedback or ideas for other settings!

Theme editor​

We rebuilt our theme editor, which allows you to create themes that control the look and feel of applications across your organization. Under your organization settings, you’ll find Themes, where you can create new themes and modify existing ones.

The new editor includes improved descriptions of all the style properties and a revamped, live-updating preview–so you can see how your color selections will impact your apps 🎨. We also introduced several new settings, like status colors. You can also now configure text colors: components will automatically use the most readable option of the light and dark colors you choose!

Themes are available on Business or Enterprise plans. We’ll soon be adding even more properties–so be sure to drop us any feedback in the community forum.

Fixes and improvements​

• Simplified the “query success” setting in the query editor
• Improved autocomplete for Form and Text components

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

New Component Directory​

Our new component directory (retool.com/components) allows you to quickly browse or search through all of our components, see examples of different configurations in action, and dive into expanded API docs for component properties, methods, and events.

Each component has multiple real-world examples to explore different functionality, from labels and captions to validation and styles. Each example also includes the corresponding settings and values if you want to try them out in your own app:

As you check out the new component docs, we'd love to hear any feedback from you in our community forum.

Fixes and improvements​

• Added a default value option for the Toggle Link component
• Improved the ordering of the Table component inspector fields
• Improved the responsiveness of code editors
• Fixed the grid visibility toggle–⌘+Shift+G (Ctrl +Shift+G)–so that it persists across sessions
• Fixed a layout issue for containers in edit mode when using Safari
• Improved the resources dropdown in the query editor so that you can now also search by resource type
• Added the "not equal" and "not in" operators to the Firestore query editor
• Added a new keyword currentColumn that editors can use when building with the Table component
• Fixed the ability to reorder rows for the Key Value component
• Added the ability to configure whether Markdown links open in a new tab via the app settings menu
• Fixed Snowflake queries using OAuth so that they properly prompt for authentication

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Fixes and improvements​

• Fixed code evaluation to properly handle false values with newlines
• Fixed the styling for empty Table components
• Improved the dropdown for selecting column types in a Table component–popular types now appear first
• Improved error messages when a resource type isn't supported in the form generator
• Improved error messages for the Auth Login integration component
• Fixed an issue where we were showing a hardcoded query timeout in edit mode, instead of DBCONNECTOR_QUERY_TIMEOUT_MS
• [on-prem only] Fixed OAuth auto-refresh to work with fields using _RETOOL_EXPOSED__ variables

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

New Table style options​

We now have 15 style options so that you can fully customize the look of your table, and we’ve also refreshed the default styles. In the “Style” section of the Table component inspector, there’s plenty more you can do now, like:

• Configure row color dynamically with any JavaScript condition (e.g. {{ currentRow.sales > 100 ? ‘green’ : ‘red’ }}), rather than setting background colors on each column.
• Control column border visibility–we’ve updated default styles to remove column borders and reduce visual noise, but their visibility is configurable. (For backwards compatibility, Table components created before this change will have borders on by default.)
• Quickly set up zebra striping by choosing a color for the “Alternate row background” style.
• Control header, toolbar, and cell styles with more fine-grained options for text, background, and accent colors. We’ve also revamped our** column sorting and edited cell indicators** and made their styling configurable.

As you style your tables, let us know if you have any feedback or feature requests in our community forum.

Fixes and improvements​

• Added support for upgrading deprecated Multiselect, Select, and Text components to their new version
• Added support for label captions on all input components
• Added autocomplete for user-defined properties with underscores (e.g. {{ currentRow._id }})
• Fixed dragging and dropping components above Table components
• Added support for specs served from http urls to the OpenAPI integration
• Fixed the debounce/throttle dropdown in the event handler menu
• Fixed the alignment of the Table component's column visibility icons in Safari

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.