Docs
コマンド

コマンド

高速、コンポーザブル、スタイルされていない React 用のコマンドメニュー

Docs

概要

<Command /> コンポーネントは、pacocoursey による cmdk コンポーネントを使用します。

インストール

npx shadcn-ui@latest add command

使用法

import {
  Command,
  CommandDialog,
  CommandEmpty,
  CommandGroup,
  CommandInput,
  CommandItem,
  CommandList,
  CommandSeparator,
  CommandShortcut,
} from "@/components/ui/command"
<Command>
  <CommandInput placeholder="コマンドを入力するか、検索..." />
  <CommandList>
    <CommandEmpty>検索結果が見つかりませんでした。</CommandEmpty>
    <CommandGroup heading="提案">
      <CommandItem>カレンダー</CommandItem>
      <CommandItem>絵文字の検索</CommandItem>
      <CommandItem>電卓</CommandItem>
    </CommandGroup>
    <CommandSeparator />
    <CommandGroup heading="設定">
      <CommandItem>プロフィール</CommandItem>
      <CommandItem>請求</CommandItem>
      <CommandItem>設定</CommandItem>
    </CommandGroup>
  </CommandList>
</Command>

使用例

ダイアログ

Press ⌘J

ダイアログでコマンドメニューを表示するには、<CommandDialog /> コンポーネントを使用します。

export function CommandMenu() {
  const [open, setOpen] = React.useState(false)
 
  React.useEffect(() => {
    const down = (e: KeyboardEvent) => {
      if (e.key === "k" && (e.metaKey || e.ctrlKey)) {
        e.preventDefault()
        setOpen((open) => !open)
      }
    }
    document.addEventListener("keydown", down)
    return () => document.removeEventListener("keydown", down)
  }, [])
 
  return (
    <CommandDialog open={open} onOpenChange={setOpen}>
      <CommandInput placeholder="コマンドを入力するか、検索..." />
      <CommandList>
        <CommandEmpty>検索結果が見つかりませんでした。</CommandEmpty>
        <CommandGroup heading="提案">
          <CommandItem>カレンダー</CommandItem>
          <CommandItem>絵文字の検索</CommandItem>
          <CommandItem>電卓</CommandItem>
        </CommandGroup>
      </CommandList>
    </CommandDialog>
  )
}

コンボボックス

<Command /> コンポーネントはコンボボックスとして使用できます。詳細は コンボボックス ページを参照してください。