GitHub

Command

Command palette with search and keyboard navigation

Basic Usage

Loading...

Installation

pnpm add @corew500/ui

Usage

import { Command } from "@corew500/ui/command"

<Command>Content</Command>

CMS Integration

CMSPayload CMS Integration
This component supports CMS-driven content via @corew500/cms-payload.
Loading...

API Reference

Props

PropTypeDefaultDescription
asChildenum
labelstringAccessible label for this command menu. Not shown visibly.
shouldFilterenumOptionally set to `false` to turn off the automatic filtering and sorting. If `false`, you must conditionally render valid items based on the search query yourself.
filterCommandFilterCustom filter function for whether each command menu item should matches the given search query. It should return a number between 0 and 1, with 1 being the best match and 0 being hidden entirely. By default, uses the `command-score` library.
valuestringOptional controlled state of the selected command menu item.
onValueChange(value: string) => voidEvent handler called when the selected item of the menu changes.
loopenumOptionally set to `true` to turn on looping around when using the arrow keys.
disablePointerSelectionenumOptionally set to `true` to disable selection via pointer events.
vimBindingsenumSet to `false` to disable ctrl+n/j/p/k shortcuts. Defaults to `true`.

Accessibility

Keyboard Navigation

  • - Fully keyboard navigable (Arrow keys, Enter, Escape).
  • CommandShortcut displays keyboard hints.

Focus Management

  • Focus is trapped within the command when in dialog mode.

Screen Readers

  • Screen reader announces filtered results count.

Localization

Translatable Content

  • - All text (placeholder, headings, items) should be translated.

Additional

  • CommandEmpty message should be localized.

Related