Pas à pas

L'erreur « tabIndex should only be declared on interactive elements » : que mettre à la place

8 min de lecture
Mikhail ShaymardanovExpert en Qualité et Accessibilité Web

Le message « tabIndex should only be declared on interactive elements » protège la personne au clavier d'un arrêt de Tab sur un élément qui ne fait rien. La règle no-noninteractive-tabindex d'eslint-plugin-jsx-a11y l'affiche sur un div, un span ou un li qui porte un tabIndex de 0 ou plus. Selon ce que fait l'élément, il devient un <button> ou un lien, passe à tabIndex={-1} ou perd l'attribut.

Trier chaque tabIndex signalé


#Que reproche le message « tabIndex should only be declared on interactive elements » ?

La règle signale un tabIndex de 0 ou plus posé sur un élément non interactif : un arrêt de Tab qui ne mène à aucune action. Comme cette touche fait passer le focus d'un contrôle au suivant, chaque arrêt inutile coûte un appui de plus à qui se passe de souris. En configuration recommended ou strict, la règle est une erreur qui bloque la CI, sauf si le projet l'a passée en avertissement.

Un parcours au clavier utile tient en trois règles, qui servent à juger chaque élément signalé :

  • chaque arrêt de Tab mène à une action ;
  • un bouton s'active avec Entrée et Espace, un lien avec Entrée ;
  • un élément que seul un script focalise reste hors du parcours au Tab.

Sur la page « Rendez-vous » de la Clinique vétérinaire des Hautes-Herbes, notre démo écrite en React, ESLint relève six erreurs pour quatre éléments. La ligne du contrôle « Déplacer », affiché trois fois par un map, en porte trois à elle seule, car ce div réagit aussi au clic :

src/pages/RendezVous.jsx
  42:15  error  Visible, non-interactive elements with click handlers must have at least one keyboard listener  jsx-a11y/click-events-have-key-events
  42:15  error  Avoid non-native interactive elements. If using native HTML is not possible, add an appropriate role and support for tabbing, mouse, keyboard, and touch inputs to an interactive content element  jsx-a11y/no-static-element-interactions
  42:41  error  `tabIndex` should only be declared on interactive elements  jsx-a11y/no-noninteractive-tabindex
  46:29  error  `tabIndex` should only be declared on interactive elements  jsx-a11y/no-noninteractive-tabindex
  53:51  error  `tabIndex` should only be declared on interactive elements  jsx-a11y/no-noninteractive-tabindex
  82:37  error  `tabIndex` should only be declared on interactive elements  jsx-a11y/no-noninteractive-tabindex
 
✖ 6 problems (6 errors, 0 warnings)

Les trois autres erreurs visent le paragraphe d'aide, le résumé d'erreurs et l'historique des vaccins, tous en tabIndex={0}.

#Comment voir ces arrêts de Tab dans Firefox ?

L'inspecteur d'accessibilité de Firefox affiche l'ordre de tabulation : un numéro sur chaque élément que Tab atteint. Ouvrez les outils de développement, onglet « Accessibilité », puis cochez « Afficher l'ordre de tabulation ».

Sur la démo, nous avons compté quatorze arrêts. Le paragraphe d'aide reçoit le 8 et le résumé d'erreurs le 9, comme le bouton « Prendre rendez-vous » reçoit le 13. Sauf que sur les deux premiers, aucune touche ne lance rien. L'affichage fige l'ordre au moment où l'on coche la case. Le résumé d'erreurs n'apparaît qu'après un envoi raté : envoyez d'abord le formulaire vide, puis cochez la case, ou rouvrez l'inspecteur si elle l'était déjà.

Capture d'écran : Firefox sur la page Rendez-vous de la clinique, inspecteur d'accessibilité ouvert et case Afficher l'ordre de tabulation cochée ; un numéro s'affiche au-dessus des trois contrôles Déplacer (5, 6 et 7), du paragraphe d'aide (8), du résumé d'erreurs (9) et de l'historique des vaccins (14).Repère 1. Le paragraphe d'aide, numéroté 8. Repère 2. Le résumé d'erreurs, numéroté 9. Repère 3. Le premier contrôle « Déplacer », numéroté 5.
Sur quatorze arrêts, Firefox numérote le paragraphe d'aiderepère 1, le résumé d'erreursrepère 2 et les trois « Déplacer », dont le premierrepère 3 : sur ces cinq éléments, ni Entrée ni Espace ne lancent d'action.
WAVE, l'outil d'accessibilité de WebAIM : lire le rapport, puis tester après zéro erreur

#Que mettre à la place d'un div avec tabIndex 0 ?

Tout dépend de ce que fait l'élément : un bouton ou un lien s'il réagit au clic, tabIndex={-1} si un script le focalise, rien s'il ne fait rien.

#Que faire d'un div cliquable avec tabIndex 0 ?

Une action demande un <button type="button">, un changement de page un <a href>. Tous deux entrent dans le parcours au Tab sans attribut.

Sur la démo de la clinique, le div « Déplacer » reçoit bien le focus. Nous avons pourtant appuyé sur Entrée sans rien obtenir, et Espace a fait défiler la page : sur un div, onClick ne répond qu'à la souris, rappelle MDN. Devenu <button> et stylé comme avant, « Déplacer » mène au choix d'un créneau aux deux touches, et les trois erreurs de sa ligne disparaissent.

Capture d'écran : carte du rendez-vous de Pistache, mardi 1er décembre à 9 h 30, avec la photo du chat et le contrôle bleu Déplacer.Repère 1. Le contrôle « Déplacer » de la carte.
Le contrôle « Déplacer »repère 1 garde son aspect ; en bouton, il répond à Entrée et à Espace, et les trois erreurs de jsx-a11y disparaissent.

À éviter

<div className="deplacer" tabIndex={0} onClick={() => deplacer(rdv)}>
  Déplacer
</div>

Correct

<button type="button" className="deplacer" onClick={() => deplacer(rdv)}>
  Déplacer
</button>

Ajouter un role="button" fait taire la règle sans rien apporter au clavier : il faut alors coder Entrée et Espace à la main, ce que MDN admet tout en conseillant le <button>. Un élément cliquable qu'Entrée n'active pas échoue au critère 7.3 du RGAA, sauf si un autre contrôle de la page fait la même action au clavier. Côté WCAG, c'est le critère 2.1.1, qui demande que tout se fasse au clavier.

#Quand utiliser tabIndex -1 ?

tabIndex={-1} sort l'élément du parcours au Tab et laisse un script y placer le focus ; la règle ne le signale jamais. Il sert à un message d'erreur focalisé après un envoi raté, à une fenêtre qui apparaît, ou au titre qu'on focalise quand une application React change de page, sujet d'un article à part.

Sur la démo, le résumé d'erreurs en tabIndex={0} recevait bien le focus à l'envoi du formulaire vide, puis restait un arrêt de plus avant le premier champ. À -1, il reçoit toujours le focus par le même focus(), et Firefox ne lui donne plus de numéro.

Capture d'écran : formulaire Prendre rendez-vous, dont le résumé d'erreurs en rose annonce 2 champs à compléter, Motif de la visite et Créneau souhaité.Repère 1. Le résumé d'erreurs, en haut du formulaire.
Le résumé d'erreursrepère 1 reçoit le focus à l'envoi du formulaire vide ; avec tabIndex à -1, il sort du parcours au Tab.

À éviter

useEffect(() => {
  if (erreurs.length > 0) resume.current.focus();
}, [erreurs]);
// …
{erreurs.length > 0 && (
  <div className="erreurs" ref={resume} tabIndex={0}>
    <p>{erreurs.length} champs à compléter :</p>
  </div>
)}

Correct

useEffect(() => {
  if (erreurs.length > 0) resume.current.focus();
}, [erreurs]);
// …
{erreurs.length > 0 && (
  <div className="erreurs" ref={resume} tabIndex={-1}>
    <p>{erreurs.length} champs à compléter :</p>
  </div>
)}

#Que faire d'un tabIndex posé « pour l'accessibilité » ?

Sur un texte, un li, une section ou un article, l'attribut se retire. Les lecteurs d'écran parcourent déjà ces contenus avec leurs propres commandes : un texte, même important, n'a pas besoin du focus pour être compris. Le paragraphe d'aide de la démo perd donc son tabIndex={0} : il reste affiché à l'identique, et Firefox ne le numérote plus.

Capture d'écran : carte du rendez-vous de Noisette, suivie du paragraphe Un rendez-vous se déplace jusqu'à 24 heures avant l'heure prévue.Repère 1. Le paragraphe d'aide, sous la carte.
Le paragraphe d'aiderepère 1 reste affiché et lu par les lecteurs d'écran, sans arrêt de Tab.

À éviter

<p className="aide" tabIndex={0}>
  Un rendez-vous se déplace jusqu'à 24 heures avant l'heure prévue.
</p>

Correct

<p className="aide">
  Un rendez-vous se déplace jusqu'à 24 heures avant l'heure prévue.
</p>
React Router : mettre à jour le titre de la page et déplacer le focus à chaque route

#Une zone défilante a-t-elle besoin d'un tabIndex, comme le demande axe ?

Seulement pour Safari : Chrome depuis sa version 132 et Firefox atteignent au Tab une zone qui déborde, quand rien de focalisable ne s'y trouve. Pour Safari, la zone garde son tabIndex={0} et reçoit un rôle, un nom et un commentaire d'exception limité à sa ligne.

Sur la démo de la clinique, l'historique des vaccins est un tableau qui défile à l'horizontale, sans lien ni bouton dedans. Le moteur de tests axe, de l'éditeur Deque, réclame que cette zone garde son tabIndex={0}, même dans Chrome. Sa règle « Scrollable region must have keyboard access » ne passe que si la zone porte ce tabIndex ou contient un élément focalisable : sans cela, Safari ne laisse pas défiler le tableau au clavier.

#Quels navigateurs atteignent une zone défilante sans tabIndex ?

Chrome, depuis sa version 132, rend focalisable une zone défilante sans élément focalisable dedans ; si elle contient un bouton, Tab va directement au bouton. Firefox atteint aussi au Tab une zone qui déborde vraiment. Safari, non : le bug WebKit 277290, ouvert en juillet 2024, n'est pas corrigé.

Nous avons retiré l'attribut de l'historique. Chrome 139 et Firefox 142 y posent le focus au Tab, puis les flèches font défiler le tableau ; WebKit 26.0, le moteur de Safari, ne l'atteint jamais.

Sans tabindex, seul Safari laisse une zone défilante hors du parcours au clavier
NavigateurZone défilante sans tabindex, sans élément focalisable dedans
Chrome, depuis la version 132Atteinte au Tab
FirefoxAtteinte au Tab
SafariJamais atteinte

Le moteur axe réclame donc ce tabIndex={0} à cause du seul Safari. Depuis sa version 4.11.2, la description de sa règle se termine par « in Safari ». Ses mainteneurs l'ont précisé, car des utilisateurs prenaient l'alerte pour un faux positif, et envisagent de retirer la règle si Safari corrige le bug.

#Comment garder ce tabIndex sans couper la règle ?

Tant que le site vise Safari, le tabIndex={0} reste. MDN demande un rôle et un nom pour tout conteneur qui reçoit le focus : la zone reçoit donc role="group" et un nom accessible, par aria-labelledby vers son titre « Vaccins ». Le rôle region se réserve aux sections importantes, qu'on doit pouvoir retrouver parmi les repères de la page. Comme jsx-a11y ne compte pas group parmi les rôles interactifs, la règle signale toujours la zone : il faut une exception, un commentaire eslint-disable-next-line entre accolades, juste au-dessus.

Capture d'écran : section Vaccins avec un tableau plus large que sa zone, coupé à droite au milieu de la colonne Vétérinaire.Repère 1. La zone qui défile autour du tableau des vaccins.
La zone de l'historiquerepère 1 garde son tabIndex à 0 pour Safari, gagne un rôle et un nom, et l'exception ne vaut que pour sa ligne.

À éviter

<h2 id="titre-vaccins">Vaccins</h2>
<div className="historique" tabIndex={0}>
  <table>…</table>
</div>

Correct

<h2 id="titre-vaccins">Vaccins</h2>
{/* eslint-disable-next-line jsx-a11y/no-noninteractive-tabindex */}
<div className="historique" role="group" aria-labelledby="titre-vaccins" tabIndex={0}>
  <table>…</table>
</div>

Un détail piège ceux qui copient l'exemple de la documentation de la règle : son commentaire omet le préfixe jsx-a11y/. ESLint répond alors Definition for rule 'no-noninteractive-tabindex' was not found et laisse la ligne signalée.

L'autre voie, l'option roles de la règle, exempte tous les role="group" du projet. Écrivez alors ["tabpanel", "group"] : cette liste remplace celle de recommended, et sans tabpanel, les panneaux d'onglets redeviendraient signalés. Sauf qu'alors, tout div en role="group" avec tabIndex={0} passe sans un mot, qu'il défile ou non : nous recommandons le commentaire, limité à la zone qui en a besoin.

// eslint.config.mjs
import jsxA11y from "eslint-plugin-jsx-a11y";
 
export default [
  {
    files: ["**/*.jsx"],
    ...jsxA11y.flatConfigs.recommended,
    rules: {
      ...jsxA11y.flatConfigs.recommended.rules,
      "jsx-a11y/no-noninteractive-tabindex": [
        "error",
        { tags: [], roles: ["tabpanel", "group"], allowExpressionValues: true },
      ],
    },
  },
];

Sur la page corrigée, ESLint ne signale plus rien, avec un seul commentaire d'exception. Firefox compte douze arrêts, contre quatorze, et chacun répond à une touche : les « Déplacer » à Entrée et à Espace, l'historique aux flèches. Des quatre tabIndex du début, il en reste deux : un -1 et un 0 gardé pour Safari.

Capture d'écran : Firefox sur la page Rendez-vous corrigée, inspecteur d'accessibilité ouvert et case Afficher l'ordre de tabulation cochée ; les trois boutons Déplacer gardent leur numéro, de 5 à 7, le paragraphe d'aide et le résumé d'erreurs n'en portent plus, et l'historique des vaccins reçoit le 12.Repère 1. L'historique des vaccins, numéroté 12. Repère 2. Le premier bouton « Déplacer », numéroté 5.
Sur la page corrigée, Firefox compte douze arrêts : l'historique des vaccinsrepère 1 passe au 12, les « Déplacer », dont le premierrepère 2, gardent leur numéro, et le paragraphe d'aide comme le résumé d'erreurs n'en ont plus.

ESLint lit le code des composants ; pour la page telle qu'elle s'affiche en ligne, le scan d'Includdy liste ses non-conformités. Sa correction guidée met pour chacune le HTML fautif à côté d'un composant conforme, généré par l'IA d'Includdy et à relire avant de l'intégrer.


Partagez cet article

Questions fréquentes

Par défaut, elle ne teste que les éléments HTML, puisqu'elle ne sait pas quel élément un composant affichera : <Card tabIndex={0}> passe sans un mot. Si le composant transmet l'attribut à un div, l'arrêt en trop existe pourtant bien dans la page.

Le réglage components de jsx-a11y lui apprend que Card affiche un div, et la règle le signale alors. Pour voir l'arrêt dans la page, cochez « Afficher l'ordre de tabulation » dans l'inspecteur d'accessibilité de Firefox : le div y reçoit son numéro comme un vrai contrôle.

La règle calcule l'expression sans connaître l'état du composant : elle remplace chaque variable par son nom, un texte qui compte comme vrai. Avec la version 6.10.2 du plugin, nous l'avons donc vue signaler tabIndex={actif ? 0 : -1}, lu comme 0. Elle laisse pourtant passer tabIndex={actif ? -1 : 0} comme tabIndex={i === actif ? 0 : -1} : son verdict tient à l'écriture de la condition.

Dans un composant composite, comme une liste d'options, un groupe de boutons radio ou un menu, chaque élément porte un rôle interactif (option, radio, menuitem) et la règle se tait. Pour le conteneur qui reçoit le focus quand on arrive au Tab sur un tel composant, la documentation de la règle conseille de désactiver la règle pour ce seul élément.

Oui. Sa règle noNoninteractiveTabindex, inspirée de celle de jsx-a11y, est recommandée et classée en erreur par défaut. Elle décrit le même défaut : un arrêt au clavier où l'on n'attend aucune action.

Les corrections valent telles quelles : un <button> ou un lien pour ce qui réagit au clic, tabIndex={-1} pour ce qu'un script focalise, rien pour le reste. Sur la zone défilante, la règle useSemanticElements de Biome refuse aussi role="group" et propose un <fieldset> : pour garder notre code, écrivez deux commentaires biome-ignore, un par règle.