Command
จาก shadcnช่องคำสั่งค้นหา-เลือกการกระทำแบบพิมพ์เร็ว รวมกลุ่มคำสั่งพร้อมปุ่มลัด ใช้เป็นแผงลอย ⌘K หรือกล่องในหน้าก็ได้
ติดตั้ง
Terminal
pnpm dlx shadcn@latest add @whereui/commandต้องผูก registry และติดตั้ง @whereui/theme นำหน้าเสมอเมื่อติดตั้งครั้งแรก
การใช้งาน
import { Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList } from "@/components/ui/command"<Command> <CommandInput placeholder="พิมพ์คำสั่ง…" /> <CommandList> <CommandEmpty>ไม่พบคำสั่ง</CommandEmpty> <CommandGroup heading="การกู้"> <CommandItem>สร้างคำขอกู้</CommandItem> </CommandGroup> </CommandList></Command>ตัวอย่างเพิ่มเติม
แผงคำสั่ง ⌘K
ชุดคำสั่ง WhereUI
ค้นหาคำสั่งเกี่ยวกับการกู้…
ข้อควรรู้
- CommandItem รับ keywords ได้ เช่น keywords={["สร้าง", "คำขอ"]} เพื่อให้ค้นเจอจากคำพ้อง
- CommandDialog รับ title และ description ให้ screen reader ใช้ประกอบการประกาศ
ซอร์สโค้ด
components/ui/command.tsx
"use client"import * as React from "react"import { Command as CommandPrimitive } from "cmdk"import { cn } from "cn"import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle,} from "@/components/ui/dialog"import { InputGroup, InputGroupAddon,} from "@/components/ui/input-group"import { SearchIcon, CheckIcon } from "lucide-react"function Command({ className, ...props}: React.ComponentProps<typeof CommandPrimitive>) { return ( <CommandPrimitive data-slot="command" className={cn( "flex size-full flex-col overflow-hidden rounded-xl! bg-popover p-1 text-popover-foreground", className )} {...props} /> )}function CommandDialog({ title = "Command Palette", description = "Search for a command to run...", children, className, showCloseButton = false, ...props}: Omit<React.ComponentProps<typeof Dialog>, "children"> & { title?: string description?: string className?: string showCloseButton?: boolean children: React.ReactNode}) { return ( <Dialog {...props}> <DialogHeader className="sr-only"> <DialogTitle>{title}</DialogTitle> <DialogDescription>{description}</DialogDescription> </DialogHeader> <DialogContent className={cn( "top-1/3 translate-y-0 overflow-hidden rounded-xl! p-0", className )} showCloseButton={showCloseButton} > {children} </DialogContent> </Dialog> )}function CommandInput({ className, ...props}: React.ComponentProps<typeof CommandPrimitive.Input>) { return ( <div data-slot="command-input-wrapper" className="p-1 pb-0"> <InputGroup className="h-8! rounded-lg! border-input/30 bg-input/30 shadow-none! *:data-[slot=input-group-addon]:pl-2!"> <CommandPrimitive.Input data-slot="command-input" className={cn( "w-full text-sm outline-hidden disabled:cursor-not-allowed disabled:opacity-50", className )} {...props} /> <InputGroupAddon> <SearchIcon className="size-4 shrink-0 opacity-50" /> </InputGroupAddon> </InputGroup> </div> )}function CommandList({ className, ...props}: React.ComponentProps<typeof CommandPrimitive.List>) { return ( <CommandPrimitive.List data-slot="command-list" className={cn( "no-scrollbar max-h-72 scroll-py-1 overflow-x-hidden overflow-y-auto outline-none", className )} {...props} /> )}function CommandEmpty({ className, ...props}: React.ComponentProps<typeof CommandPrimitive.Empty>) { return ( <CommandPrimitive.Empty data-slot="command-empty" className={cn("py-6 text-center text-sm", className)} {...props} /> )}function CommandGroup({ className, ...props}: React.ComponentProps<typeof CommandPrimitive.Group>) { return ( <CommandPrimitive.Group data-slot="command-group" className={cn( "overflow-hidden p-1 text-foreground **:[[cmdk-group-heading]]:px-2 **:[[cmdk-group-heading]]:py-1.5 **:[[cmdk-group-heading]]:text-xs **:[[cmdk-group-heading]]:font-medium **:[[cmdk-group-heading]]:text-muted-foreground", className )} {...props} /> )}function CommandSeparator({ className, ...props}: React.ComponentProps<typeof CommandPrimitive.Separator>) { return ( <CommandPrimitive.Separator data-slot="command-separator" className={cn("-mx-1 h-px bg-border", className)} {...props} /> )}function CommandItem({ className, children, ...props}: React.ComponentProps<typeof CommandPrimitive.Item>) { return ( <CommandPrimitive.Item data-slot="command-item" className={cn( "group/command-item relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none in-data-[slot=dialog-content]:rounded-lg! data-[disabled=true]:pointer-events-none data-[disabled=true]:opacity-50 data-selected:bg-muted data-selected:text-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-selected:*:[svg]:text-foreground", className )} {...props} > {children} <CheckIcon className="ml-auto opacity-0 group-has-data-[slot=command-shortcut]/command-item:hidden group-data-[checked=true]/command-item:opacity-100" /> </CommandPrimitive.Item> )}function CommandShortcut({ className, ...props}: React.ComponentProps<"span">) { return ( <span data-slot="command-shortcut" className={cn( "ml-auto text-xs tracking-widest text-muted-foreground group-data-selected/command-item:text-foreground", className )} {...props} /> )}export { Command, CommandDialog, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem, CommandShortcut, CommandSeparator,}