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


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à.
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.
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.
Repère 1. Le contrôle « Déplacer » de la carte.À é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.
Repère 1. Le résumé d'erreurs, en haut du formulaire.À é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.
Repère 1. Le paragraphe d'aide, sous la carte.À é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.
| Navigateur | Zone défilante sans tabindex, sans élément focalisable dedans |
|---|---|
| Chrome, depuis la version 132 | Atteinte au Tab |
| Firefox | Atteinte au Tab |
| Safari | Jamais 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.
Repère 1. La zone qui défile autour du tableau des vaccins.À é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.
Repère 1. L'historique des vaccins, numéroté 12. Repère 2. Le premier bouton « Déplacer », numéroté 5.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.


