Skip to main content

Úvod

Pokud potřebujete poslouchat klávesovou zkratku, obvykle použijete posluchač událostí onKeyDown. Ve twenty-front však můžete mít konflikty mezi stejnými klávesovými zkratkami, které jsou použity v různých komponentách, nasazených současně. Například, pokud máte stránku, která poslouchá klávesu Enter, a modal, který poslouchá klávesu Enter, s komponentou Select uvnitř tohoto modalu, která poslouchá klávesu Enter, můžete mít konflikt, když jsou všechny nasazeny současně.

Funkce hook useScopedHotkeys

K řešení tohoto problému máme vlastní hook, který umožňuje poslouchat klávesové zkratky bez jakéhokoliv konfliktu. Umístíte ho do komponenty a bude poslouchat klávesové zkratky pouze když je komponenta nasazena A když je aktivní specifikovaný hotkey scope.

Jak v praxi poslouchat klávesové zkratky?

Jsou potřebné dva kroky k nastavení poslouchání klávesových zkratek :
  1. Nastavte hotkey scope, který bude poslouchat klávesové zkratky
  2. Použijte hook useScopedHotkeys k poslouchání klávesových zkratek
Nastavení oblastí klávesových zkratek je potřebné i na jednoduchých stránkách, protože jiné UI prvky jako levé menu nebo příkazové menu mohou také poslouchat klávesové zkratky.

Použití klávesových zkratek

Obecně budete mít dva případy použití, které vyžadují klávesové zkratky :
  1. Na stránce nebo v komponentě nasazené na stránce
  2. V komponentě typu modal, která přebírá fokus kvůli akci uživatele
Druhý případ použití se může stát rekurzivně: například rozbalovací seznam v modalu.

Poslouchání klávesových zkratek na stránce

Příklad :

Poslouchání klávesových zkratek v komponentě typu modal

V tomto příkladu použijeme komponentu typu modal, která poslouchá klávesu Escape, aby svému nadřazenému komponentu řekla, že se má zavřít. Zde interakce uživatele mění rozsah.
Pak v komponentě modalu :
Je důležité použít tento vzor, když si nejste jisti, že pouhé použití useEffect s připojením/odpojením bude stačit k tomu, aby se předešlo konfliktům. Tyto konflikty mohou být těžko laditelné a může se to stát častěji než s useEffects.

Co je to hotkey scope?

Rozsah klávesových zkratek je řetězec, který představuje kontext, ve kterém jsou klávesové zkratky aktivní. Obecně je kódován jako enum. Když změníte rozsah klávesových zkratek, klávesové zkratky, které poslouchají tento rozsah, budou povolené a klávesové zkratky, které poslouchají jiné rozsahy, budou zakázané. Můžete nastavit pouze jeden rozsah najednou. Například rozsahy klávesových zkratek pro každou stránku jsou definovány v PageHotkeyScope enumu:
Interně je aktuálně vybraný rozsah uložen v Jotai atomu, který je sdílen napříč aplikací :
Ale tento atom by se nikdy neměl spravovat ručně ! Ukážeme si, jak jej používat v příští sekci.

Jak to funguje interně?

Vytvořili jsme tenkou vrstvu nad react-hotkeys-hook, která je výkonnější a vyhýbá se zbytečným překreslením. Také vytváříme Jotai atom, abychom mohli řídit stav rozsahu klávesových zkratek a učinit jej dostupným kdekoli v aplikaci.