קיצורי מקשים
useKeymap, רצפים, שכבת העזרה ?, רמזי מקשים ולוח הפקודות.
יש להגדיר קיצורי מקשים פעם אחת עם useKeymap. Text.js מנתב אותם, מציג אותם בשכבת ?, מציג אותם בכותרת התחתונה ומאפשר לחפש אותם בלוח פקודות.
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 לשימוש ברשימות משלכם.