Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

`HTMLElement.draggable` et `tabIndex` : glissement et focus

`draggable` détermine si un élément peut servir de source à un glissement. `tabIndex` influe sur son accès par la touche Tab et sur sa place dans le parcours. Les deux réglages ne se remplacent pas.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

element.draggable
 element.draggable = true;  // or false
 element.tabIndex
 element.tabIndex = 0;     // or another integer

HTMLElement.draggable lit et définit un booléen qui indique si l’élément HTML peut servir de source à un glissement natif. Affecter true ou false écrit le texte "true" ou "false" dans l’attribut draggable. Cet attribut est énuméré, pas booléen : sa seule présence n’active pas le glissement. S’il est absent ou invalide, le mode automatique s’applique : les images et les liens munis de href, par exemple, sont déplaçables, mais pas un simple div. Pour rétablir ce mode, supprimez l’attribut au lieu de le régler sur false.

HTMLElement.tabIndex lit un entier et écrit dans l’attribut tabindex lors d’une affectation. 0 inclut normalement l’élément dans l’ordre naturel de tabulation. Une valeur négative, généralement -1, l’en exclut normalement, mais focus() reste possible si l’élément peut recevoir le focus. Dans une même portée de navigation du focus, les valeurs positives précèdent 0 et les positions par défaut : les plus petites d’abord, puis l’ordre de l’arbre en cas d’égalité. Préférez un ordre logique dans le document aux valeurs positives. Sans attribut, un button renvoie normalement 0 et un simple div renvoie -1 ; cette lecture ne garantit pas que le focus puisse être placé, par exemple sur un contrôle désactivé ou dans une zone inert.

Ces API HTML sont fournies par le navigateur et ne font pas partie d’ECMAScript 2024. tabIndex n’implémente pas le glissement au clavier, et draggable ne définit pas l’action au dépôt. Le comportement dépend du navigateur, de la plateforme et du mode de saisie. Pour réordonner des éléments, proposez aussi des boutons comme « Monter » et « Descendre », utilisables au clavier et au toucher.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>draggable and tabIndex</title>
</head>
<body>
  <script>
    const element = document.createElement('div');
    const report = () => console.log(JSON.stringify([
      element.draggable, element.tabIndex,
      element.getAttribute('draggable'), element.getAttribute('tabindex')
    ]));

    report();
    element.draggable = true;
    element.tabIndex = 0;
    report();
    element.tabIndex = -1;
    report();
  </script>
</body>
</html>

Résultat

[false,-1,null,null]
[true,0,"true","0"]
[true,-1,"true","-1"]

Enregistrez l’exemple dans un fichier `.html`, ouvrez-le dans un navigateur et consultez la console de développement. Chaque ligne affiche les deux propriétés, puis leurs attributs. `null` indique l’absence de l’attribut. Passer `tabIndex` à `-1` ne change pas `draggable` ; l’exemple ne teste ni les gestes ni le déplacement du focus.

Leçons associées

  • JavaScript · Leçon 34 · Intermédiaire · Version : 3

Sources