קיצורי מקשים

⁦useKeymap⁩, רצפים, שכבת העזרה ?, רמזי מקשים ולוח הפקודות.

יש להגדיר קיצורי מקשים פעם אחת עם useKeymap. Text.js מנתב אותם, מציג אותם בשכבת ?, מציג אותם בכותרת התחתונה ומאפשר לחפש אותם בלוח פקודות.

בשידור חי80×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

תחבירמשמעות
ctrl+kמקשי שינוי: ctrl alt shift meta mod
mod+k⌘ או Ctrl, לפי המקש המוחזק
j, downחלופות
g gרצף (1 שנייה בין מקשים)
Gאות גדולה מציינת Shift
?מקשים הניתנים להדפסה מותאמים לפי התו

הערכים הם פונקציית טיפול, או שיוך מקשים עם label, group, hint, disabled ו-noRepeat. שיוכים ללא תווית פועלים אך אינם מופיעים בשכבת העזרה.

useKeymapBindings() מחזיר את השיוכים בעלי התווית שפעילים כעת, לשימוש בכותרות תחתונות ובתפריטים משלכם.

מפות מקשים פועלות דרך useInput, ולכן הכללים הרגילים חלים: שדות קלט במיקוד מקבלים עדיפות, מקש שנמצאה לו התאמה עוצר את הפצת האירוע, ורכיב <Modal> פתוח משבית שיוכים מחוץ לו. כדי לשנות זאת, יש להעביר { priority, global, isActive }.

<KeyHelp>

יש ללחוץ על ? להצגת כל השיוכים בעלי התווית, לפי קבוצות. הרשימה מציגה את השיוכים הפעילים במקום שבו נפתחה.

<KeyHelp keys="?" title="Keyboard shortcuts" />

<KeyHints> ו-<StatusBar>

<KeyHints /> מציג שיוכים המסומנים ב-hint: true, או items מפורשים. <StatusBar> הוא כותרת תחתונה בת שורה אחת עם אזור right.

<StatusBar right={<Text color="subtle">▼ iad1</Text>}>  <KeyHints items={[{ keys: "ctrl+k", label: "commands" }]} /></StatusBar>

<Kbd>mod+k</Kbd> מרנדר מקש יחיד. formatKeys("ctrl+shift+p") מחזיר ⌃⇧P ב-macOS ו-ctrl+shift+P במערכות אחרות.

<CommandPalette>

Ctrl+K (או Ctrl+P) פותח ממשק הפעלה עם חיפוש מקורב בפקודות ובכל השיוכים בעלי התווית, עם הדגשה של האותיות התואמות.

<CommandPalette  commands={[{ id: "theme", label: "Toggle theme", group: "View", run: toggleTheme }]}/>
⁦Prop⁩תיאור
commands{ id, label, group?, keys?, keywords?, run }[]
keysקיצור מקשים לפתיחה (ברירת המחדל היא ctrl+k, ctrl+p; להשבתה יש להשתמש ב-null)
includeKeymapהצגת שיוכי מפת המקשים (ברירת המחדל היא true)
open / onOpenChangeמצב מבוקר

לוח הפקודות נסגר לפני שהוא מפעיל פקודה, כך שפקודות יכולות לפתוח חלונות מודאליים משלהן. הספרייה מייצאת את fuzzyMatch ואת fuzzyFilter לשימוש ברשימות משלכם.

עריכת הדף ב-GitHub