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.

Trực tiếp80×18 · booting Turbolog…tsx
preview://keymap:1
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+kPhím bổ trợ: ctrl alt shift meta mod
mod+k⌘ hoặc Ctrl, tùy phím đang giữ
j, downCác lựa chọn thay thế
g gMột chuỗi phím (1 giây giữa các phím)
GChữ 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 }]}/>
PropMô tả
commands{ id, label, group?, keys?, keywords?, run }[]
keysPhím tắt mở bảng (mặc định ctrl+k, ctrl+p; dùng null để vô hiệu hóa)
includeKeymapLiệt kê liên kết phím của keymap (mặc định true)
open / onOpenChangeCó 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.

Sửa trang này trên GitHub