Klavye kısayolları
useKeymap, tuş dizileri, ? yardım katmanı, tuş ipuçları ve komut paleti.
Kısayolları useKeymap ile bir kez tanımlayın. Text.js bunları yönlendirir, ? katmanında listeler, alt bilginizde gösterir ve komut paletinde aranabilir hâle getirir.
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
| Sözdizimi | Anlamı |
|---|---|
ctrl+k | Değiştirici tuşlar: ctrl alt shift meta mod |
mod+k | ⌘ veya Ctrl, hangisi basılıysa |
j, down | Alternatifler |
g g | Bir tuş dizisi (tuşlar arasında 1 saniye) |
G | Büyük harf Shift anlamına gelir |
? | Yazdırılabilir tuşlar karakterle eşleşir |
Değerler bir işleyici veya label, group, hint, disabled ve noRepeat içeren bir bağlamadır. Etiketsiz bağlamalar çalışır ancak yardım katmanında yer almaz.
useKeymapBindings(), kendi alt bilgilerinizde ve menülerinizde kullanmanız için o anda etkin olan etiketli bağlamaları döndürür.
Tuş haritaları useInput üzerinden çalışır, dolayısıyla olağan kurallar geçerlidir: odaklanmış girişler önceliklidir, eşleşen bir tuş yayılımı durdurur ve açık bir <Modal> dışındaki bağlamaları devre dışı bırakır. Bunu değiştirmek için { priority, global, isActive } geçirin.
<KeyHelp>
Tüm etiketli bağlamaları gruplar hâlinde görmek için ? tuşuna basın. Açıldığı yerde etkin olanları listeler.
<KeyHelp keys="?" title="Keyboard shortcuts" /><KeyHints> ve <StatusBar>
<KeyHints />, hint: true ile işaretlenmiş bağlamaları veya açıkça belirtilen items öğelerini gösterir. <StatusBar>, right yuvası olan tek satırlık bir alt bilgidir.
<StatusBar right={<Text color="subtle">▼ iad1</Text>}> <KeyHints items={[{ keys: "ctrl+k", label: "commands" }]} /></StatusBar><Kbd>mod+k</Kbd> tek bir tuş render eder. formatKeys("ctrl+shift+p"), macOS’ta ⌃⇧P, diğer ortamlarda ctrl+shift+P verir.
<CommandPalette>
Ctrl+K (veya Ctrl+P), komutlarınız ve tüm etiketli bağlamalar için eşleşen harfleri vurgulayan, yaklaşık eşleşmeli bir başlatıcı açar.
<CommandPalette commands={[{ id: "theme", label: "Toggle theme", group: "View", run: toggleTheme }]}/>| Prop | Açıklama |
|---|---|
commands | { id, label, group?, keys?, keywords?, run }[] |
keys | Açma kısayolu (varsayılan ctrl+k, ctrl+p; devre dışı bırakmak için null) |
includeKeymap | Tuş haritası bağlamalarını listeleme (varsayılan true) |
open / onOpenChange | Kontrollü |
Palet, bir komutu çalıştırmadan önce kapanır; böylece komutlar kendi modal pencerelerini açabilir. fuzzyMatch ve fuzzyFilter, kendi listelerinizde kullanmanız için dışa aktarılır.