Command: Scrollable

Long lists scroll inside a capped height. The selected item is always kept in view while you move with the keyboard.

Command menu

import { IconFileText } from "@tabler/icons-react"

import {
  Command,
  CommandEmpty,
  CommandGroup,
  CommandInput,
  CommandItem,
  CommandList,
} from "@/components/ui/command"

const documents = Array.from({ length: 60 }, (_, index) => ({
  id: index + 1,
  title: `Document ${String(index + 1).padStart(2, "0")}`,
}))

export function CommandScrollable() {
  return (
    <Command className="w-full max-w-sm">
      <CommandInput placeholder="Search 60 documents…" />
      <CommandList>
        <CommandEmpty>No documents match.</CommandEmpty>
        <CommandGroup heading="Documents">
          {documents.map((doc) => (
            <CommandItem key={doc.id}>
              <IconFileText />
              {doc.title}
            </CommandItem>
          ))}
        </CommandGroup>
      </CommandList>
    </Command>
  )
}

Add this example

This adds the example as components/examples/command/scrollable.tsx, together with the Command component and the HextaUI theme tokens it needs.

pnpm dlx shadcn@latest add https://hextaui.com/r/command-scrollable.json

To add only the component, follow the Command installation.

Props in this example

The Command props this example sets, from the API reference.

CommandInput

Prop	Type	Default
`placeholder`	`string`	`–`

CommandGroup

Prop	Type	Default
`heading`	`ReactNode`	`–`

Every prop is in the Command API reference.

More Command examples

See them all, with keyboard support and accessibility notes, on the Command page.