Conciergia UI

ბრძანებების ძიება · Command

კლავიატურით მართვადი ძიება Base UI Autocomplete-ზე; გვერდზეც და დიალოგშიც.

მაგალითი

ინსტალაცია

terminal
pnpm add @llc-conciergia/ui
იმპორტი
import { CommandDialog, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem } from "@llc-conciergia/ui/command";

შენიშვნები

⌘K/Ctrl+K listener მშობელში დაამატეთ, როგორც მაგალითშია; კომპონენტი გლობალურ ძიებას თვითნებურად არ ითვისებს. Escape ხურავს დიალოგს. ძიების შეცვლა არ იწვევს onSelect-ს; onSelect-ში გამოიყენეთ router.push და დახურეთ დიალოგი.

Props

Propტიპინაგულისხმევიაღწერა
Command: value / defaultValue / onValueChangestring / string / (value: string) => void—საძიებო ტექსტი; არ არის არჩეული ბრძანების id.
Command: filter(value, search, keywords) => boolean—საკუთარი ფილტრი. ნაგულისხმევი ძიება ამოწმებს value-ს, ტექსტსა და keywords-ს.
CommandInput: placeholder / disabledAutocomplete.Input props—ლოკალიზებული placeholder და aria-label; შეგიძლიათ გადაფაროთ.
CommandListAutocomplete.List props—inline სია; ისრები და Enter არჩევისთვის.
CommandEmpty: childrenReactNode—ლოკალიზებული ცარიელი შედეგი; შესაძლებელია გადაფარვა.
CommandGroup: headingReactNode—ჯგუფის სათაური; ცარიელი ჯგუფი იმალება.
CommandItem: value / keywords / onSelect / disabledstring / string[] / (value) => void / boolean—value უნიკალურია მთელ Command-ში; onSelect მუშაობს კლავიატურითაც.
CommandSeparator / CommandShortcutseparator / span props—გამყოფი და ვიზუალური shortcut. Shortcut თვითონ არაფერს არეგისტრირებს.
CommandDialog: title / descriptionstring (required)—screen reader-ისთვის აუცილებელი ტექსტები.
CommandDialog: open / defaultOpen / onOpenChangeDialog props—მშობელი მართავს გახსნას და საჭიროებისას onSelect-ში დახურვას.
CommandDialog: commandPropsCommandProps—შიდა Command-ის საძიებო ტექსტი, ფილტრი და სტილი.
ყველა ვიზუალური ნაწილი: className / refnative or Base UI props—props გადაეცემა შესაბამის ელემენტს.