ARIA : attribut aria-multiline - ARIA

Description

Le comportement par défaut de la touche Entrée ou Retour diffère entre les champs de texte sur une seule ligne et ceux sur plusieurs lignes. Lorsque la sélection se trouve dans un <input type="text"> sur une seule ligne, la touche Entrée ou Retour envoie généralement le formulaire.

Lorsque la sélection se trouve dans un <textarea>, la même frappe insère un saut de ligne. Applicable uniquement aux éléments ayant le rôle textbox, l'attribut aria-multiline indique aux technologies d'assistance si ce champ de texte accepte plusieurs lignes de saisie ou seulement une seule ligne, et fixe les attentes quant au type de données à saisir et au comportement des touches.

Note : Dans la mesure du possible, utilisez l'élément HTML <input> ou le <textarea>, car ils possèdent une sémantique et des comportements intégrés, ne requièrent pas d'attributs ARIA ni de scripts, et offrent un support clavier natif.

Si aria-multiline="true" est défini, le widget textbox acceptera des sauts de ligne dans la saisie, de la même manière que l'élément HTML <textarea>. Les éléments ayant le rôle textbox qui n'ont pas cet attribut, ou dont la valeur est false, sont des champs de texte simples d'une seule ligne.

Tenez compte de la sélection et des frappes de touches lors de la conception des champs de texte. ARIA ne modifie que l'arbre d'accessibilité et la manière dont les technologies d'assistance présentent le champ de texte à vos utilisateur·ice·s. ARIA ne change rien au comportement par défaut d'un élément. Si vous n'utilisez pas les éléments HTML sémantiques pour leur usage prévu et leurs comportements par défaut, vous devez utiliser JavaScript pour gérer le comportement, y compris la réponse aux événements de frappe.

Valeurs

true: Le champ de texte accepte plusieurs lignes de saisie.
false: Le champ de texte n'accepte qu'une seule ligne de saisie.

Interfaces associées

Element.ariaMultiLine: La propriété ariaMultiLine, faisant partie de l'interface Element, reflète la valeur de l'attribut aria-multiline.
ElementInternals.ariaMultiLine: La propriété ariaMultiLine, faisant partie de l'interface ElementInternals, reflète la valeur de l'attribut aria-multiline.