Phím tắt
useKeymap, chuỗi phím, lớp trợ giúp ?, gợi ý phím và bảng lệnh.
Khai báo phím tắt một lần với useKeymap. Text.js định tuyến chúng, liệt kê chúng trong lớp phủ ?, hiển thị chúng ở chân trang và cho phép tìm kiếm chúng trong bảng lệnh.
useKeymap( { "j, down": { label: "Next", run: next, hint: true }, "k, up": { label: "Previous", run: previous }, "g g": { label: "Go to top", run: top }, "ctrl+s": { label: "Save", run: save, hint: true }, }, { group: "Navigation" },);return ( <> <StatusBar right={<Text color="subtle">main</Text>}> <KeyHints /> </StatusBar> <CommandPalette commands={commands} /> <KeyHelp /> </>);useKeymap
| Cú pháp | Ý nghĩa |
|---|---|
ctrl+k | Phím bổ trợ: ctrl alt shift meta mod |
mod+k | ⌘ hoặc Ctrl, tùy phím đang giữ |
j, down | Các lựa chọn thay thế |
g g | Một chuỗi phím (1 giây giữa các phím) |
G | Chữ hoa ngụ ý Shift |
? | Phím in được khớp theo ký tự |
Giá trị là một handler, hoặc một liên kết phím có label, group, hint, disabled và noRepeat. Liên kết phím không có nhãn vẫn hoạt động nhưng không xuất hiện trong lớp phủ trợ giúp.
useKeymapBindings() trả về các liên kết phím có nhãn đang hoạt động, để bạn dùng cho chân trang và menu riêng.
Keymap chạy qua useInput, nên các quy tắc thông thường vẫn áp dụng: ô nhập đang có tiêu điểm được ưu tiên, phím khớp sẽ ngừng lan truyền sự kiện, và <Modal> đang mở sẽ vô hiệu hóa liên kết phím bên ngoài nó. Truyền { priority, global, isActive } để thay đổi hành vi đó.
<KeyHelp>
Nhấn ? để xem mọi liên kết phím có nhãn, chia theo nhóm. Nó liệt kê những liên kết đang hoạt động tại nơi nó mở.
<KeyHelp keys="?" title="Keyboard shortcuts" /><KeyHints> và <StatusBar>
<KeyHints /> hiển thị liên kết phím có đánh dấu hint: true, hoặc items chỉ định tường minh. <StatusBar> là chân trang một dòng có một vị trí right.
<StatusBar right={<Text color="subtle">▼ iad1</Text>}> <KeyHints items={[{ keys: "ctrl+k", label: "commands" }]} /></StatusBar><Kbd>mod+k</Kbd> render một phím đơn. formatKeys("ctrl+shift+p") cho ra ⌃⇧P trên macOS và ctrl+shift+P trên các hệ thống khác.
<CommandPalette>
Ctrl+K (hoặc Ctrl+P) mở trình khởi chạy có tìm kiếm gần đúng trên các lệnh của bạn và mọi liên kết phím có nhãn, với các chữ cái khớp được tô sáng.
<CommandPalette commands={[{ id: "theme", label: "Toggle theme", group: "View", run: toggleTheme }]}/>| Prop | Mô tả |
|---|---|
commands | { id, label, group?, keys?, keywords?, run }[] |
keys | Phím tắt mở bảng (mặc định ctrl+k, ctrl+p; dùng null để vô hiệu hóa) |
includeKeymap | Liệt kê liên kết phím của keymap (mặc định true) |
open / onOpenChange | Có kiểm soát |
Bảng lệnh đóng trước khi chạy lệnh, nên lệnh có thể mở hộp thoại riêng. fuzzyMatch và fuzzyFilter được xuất để bạn dùng cho danh sách riêng.