# chakra-ui/release
Chakra UI @chakra-ui/react@3.38.0
importance: highbreakingmigrationfeature
This release adds a searchable Command menu with overlay management, keyboard navigation, and a mod+k shortcut, plus KbdGroup for displaying shortcut keys. It also fixes behavior across responsive hooks, overlays, styling and theming, accessibility, and several Ark UI components.
affected
Chakra UI users can adopt the new command menu and shortcut-key grouping, while users of the updated Ark UI components may need to adjust accessibility assertions, element assumptions, or ref types.
action
Review the Field.ErrorText accessibility test change and the updated component element and ref types when upgrading.
release_signals
-Field.ErrorText now associates with its input using aria-describedby instead of aria-errormessage; tests using toHaveAccessibleErrorMessage should use toHaveAccessibleDescription.
-Popover.Title now renders an h2 instead of a div, and its ref is typed as HTMLHeadingElement.
-Listbox.ItemText and Toggle.Indicator now render spans instead of divs, and their refs are typed as HTMLSpanElement.
+Add Command, a searchable command menu built on Combobox and Dialog, with keyboard navigation, a mod+k shortcut, and support for loading, empty, and separated results.
+Add KbdGroup to group shortcut keys and apply size and variant to its contained Kbd components.
+Combobox adds a loading prop that sets aria-busy and keeps the empty state hidden while loading.
+Pagination adds api.type and api.getPageUrl(page), and supports anchor elements when type="link".
migration_steps2 steps
- 01Update accessibility tests for Field.ErrorText to use toHaveAccessibleDescription instead of toHaveAccessibleErrorMessage.
- 02Account for the updated rendered elements and ref types of Popover.Title, Listbox.ItemText, and Toggle.Indicator.
code_snippet
<Command.Root collection={collection}>
<Command.Trigger>Open commands</Command.Trigger>
<Portal>
<Command.Backdrop />
<Command.Positioner>
<Command.Panel>
<Command.Control>
<Command.Indicator />
<Command.Input placeholder="Search commands" />
</Command.Control>
<Command.List>
{collection.items.map((item) => (
<Command.Item key={item.value} item={item} onSelect={() => runCommand(item.value)}>
<Command.ItemText>{item.label}</Command.ItemText>
</Command.Item>
))}
<Command.Empty>No commands found</Command.Empty>
</Command.List>
</Command.Panel>
</Command.Positioner>
</Portal>
</Command.Root># community_signal
How useful is this release to your stack?
—
net score
Sign in with GitHub to cast your vote.
Sign in with GitHub to vote
You’ll return to this release, then choose your vote.