Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Element : propriété ariaMultiLine

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2023.

La propriété ariaMultiLine de l'interface Element reflète la valeur de l'attribut aria-multiline, qui indique si une zone de texte accepte plusieurs lignes de saisie ou seulement une seule ligne.

Note : Dans la mesure du possible, utilisez un élément HTML <input> avec type="text" ou un <textarea>, car ces éléments ont des sémantiques intégrées et ne nécessitent pas d'attributs ARIA.

Valeur

Une chaîne de caractères contenant l'une des valeurs suivantes :

"true"

Il s'agit d'une zone de texte multi-lignes.

"false"

Il s'agit d'une zone de texte à une seule ligne.

Exemples

Dans cet exemple, l'attribut aria-multiline sur l'élément avec un ID de boiteSaisieTexte est défini sur "true", indiquant que cette zone permet plusieurs lignes de saisie. En utilisant ariaMultiLine, nous mettons à jour la valeur à "false".

html
<div id="boiteSaisieTexteLabel">Entrez les étiquettes pour l'article</div>
<div
  role="textbox"
  id="boiteSaisieTexte"
  contenteditable="true"
  aria-multiline="true"
  aria-labelledby="boiteSaisieTexteLabel"
  aria-required="true"></div>
js
let el = document.getElementById("boiteSaisieTexte");
console.log(el.ariaMultiLine); // "true"
el.ariaMultiLine = "false";
console.log(el.ariaMultiLine); // "false"

Spécifications

Spécification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariamultiline

Compatibilité des navigateurs

Voir aussi