aria-multiline

Description

aria-multiline est utilisé sur des éléments avec role="textbox" pour indiquer si la touche Entrée crée une nouvelle ligne (true) ou soumet le formulaire / déclenche une action (false). C’est une information comportementale utile pour les lecteurs d’écran.

Syntaxe

<div role="textbox"
     contenteditable="true"
     aria-multiline="true"
     aria-label="Corps du message">
</div>

Exemples

Éditeur de texte riche multi-ligne :

<div role="textbox"
     contenteditable="true"
     aria-multiline="true"
     aria-label="Description"
     aria-required="true"
     aria-describedby="desc-aide">
</div>
<p id="desc-aide">Appuyez sur Entrée pour aller à la ligne.</p>

Champ de saisie simple (une ligne) :

<div role="textbox"
     contenteditable="true"
     aria-multiline="false"
     aria-label="Titre">
</div>

Notes

Éléments natifs : <input type="text"> est mono-ligne par défaut (pas besoin de aria-multiline) ; <textarea> est multi-ligne par défaut. N’utiliser aria-multiline que pour les widgets personnalisés (contenteditable, role="textbox").

Comportement clavier attendu : sur un textbox multi-ligne, Entrée doit insérer un saut de ligne ; sur mono-ligne, Entrée peut déclencher une soumission.