Raccourcis clavier

Introduction

Le clavier peut être utilisé dans l'interface d'administration pour déclencher certaines actions habituellement effectuées avec une souris ou un pavé tactile. Par exemple, il existe des raccourcis clavier pour enregistrer la page en cours, accéder au Panneau d'administration ou ouvrir un formulaire de Paramètres.

Il existe un aperçu de tous les raccourcis, ouvert en sélectionnant au clavier J puis X successivement (pas en même temps et sans utiliser la touche Majuscule normalement utilisée pour les majuscules). À moins de modifier les paramètres du plugin, vous devez appuyer sur les touches dans un délai de 2 secondes.

Cette fonctionnalité est activée par défaut. Elle peut être désactivée ou configurée dans Administration → Système → Plugins → Système - Raccourcis clavier. Actuellement, le seul paramètre configurable est le délai d'expiration : le temps que le système attend avant la prochaine saisie de touche. Par défaut, il attend 2000 millisecondes (2 secondes).

Raccourcis par défaut dans Joomla

J + A - Enregistre le contenu en cours
J + S - Pour Enregistrer & Fermer
J + Q - Annule la page en cours
J + N - Active le bouton Nouveau
J + F - Place le focus sur le champ de recherche
J + O - Accède aux Paramètres
J + H - Ouvre la fenêtre d'aide (peut déclencher un avertissement de blocage de fenêtres contextuelles du navigateur)
J + M - Bascule l'affichage de la barre de menu
J + X - Affiche une liste des raccourcis disponibles
J + D - Accède directement au Panneau d'administration

Raccourcis tiers - Informations pour les développeurs

D'autres développeurs peuvent également ajouter leurs propres raccourcis. Le plugin Joomla déclenche l'événement onLoadShortcuts, qui peut également être utilisé par d'autres plugins. Cet événement doit être ajouté à la liste de getSubscribedEvents à l'intérieur du plugin. La fonction associée pourrait ressembler à ceci :

    public function onLoadShortcuts(EventInterface $event): void {
       $shortcuts = $event->getArgument('shortcuts');
       $exampleShortcuts = array('example' => (object)['shortcut' => 'E', 'title' => 'Great Example', 'selector' => '#menu-collapse']);
       $event->setArgument('shortcuts',  array_merge($shortcuts, $exampleShortcuts));
    }

Portez une attention particulière à la partie array_merge : lorsque les raccourcis déjà existants ne sont pas fusionnés avec les nouveaux, les anciens sont écrasés.

Les développeurs peuvent saisir un tableau d'objets de raccourci :

{ shortcut: string, selector: string, title: string }

Le Raccourci doit être une saisie clavier, séparée par un signe plus, par exemple Y ou ALT + Z + 7 (actuellement, il n'y a pas vraiment de filtrage). Gardez à l'esprit que chaque séquence de raccourci commencera par J.
Les Sélecteurs sont des sélecteurs CSS ou des URL pour spécifier la cible. Lorsqu'il s'agit d'un élément de saisie, le raccourci donne le focus, comme c'est le cas pour le champ de recherche. Sinon, l'élément sera cliqué ou l'URL sera appelée.
Le Titre sera affiché dans l'aperçu. Il peut s'agir, par exemple, du nom de la cible.

Raisons d'utiliser J + X

Certains peuvent se demander pourquoi avoir choisi d'utiliser des raccourcis séquentiels ou le J comme point de départ plutôt que Ctrl ou autre chose. Les principales raisons sont l'accessibilité et l'évitement des interruptions par d'autres logiciels. Par exemple, Ctrl + S serait pratique pour enregistrer un article, mais est déjà utilisé par les navigateurs. La même chose peut se produire avec les lecteurs d'écran ou les gestionnaires de mots de passe. L'option la plus sûre était donc d'utiliser quelque chose de spécifique à Joomla!, comme le J au début.

Un autre problème est qu'il n'est pas toujours possible d'appuyer sur plusieurs touches à la fois. Windows dispose du mode Touches rémanentes pour cela, mais il ne fonctionne que pour les touches de modification comme Maj, Ctrl et Alt. C'est pourquoi le plugin utilise une saisie séquentielle dès le départ, ce qui le rend utilisable par un plus grand nombre de personnes, même sans l'aide des modes du système d'exploitation.