Element: ariaMultiLine プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年10月以降、すべてのブラウザーで利用可能です。
ariaMultiLine は Element インターフェイスのプロパティで、テキストボックスが複数行の入力を受け入れるか単一の行だけを受け入れるかを示す aria-multiline 属性の値を反映します。
メモ:
可能であれば、HTMLの <input> 要素で type="text" を使用するか、<textarea> を使用してください。これらは意味づけが組み込まれており、ARIA 属性を必要としないからです。
値
以下のいずれかの値を持つ文字列です。
例
この例では、txtBoxInput という ID を持つ要素の aria-multiline 属性は "true" に設定されており、このボックスが複数行の入力を許可していることを示しています。ariaMultiLine を使用して、値を "false" に更新します。
html
<div id="txtboxMultilineLabel">Enter the tags for the article</div>
<div
role="textbox"
id="txtBoxInput"
contenteditable="true"
aria-multiline="true"
aria-labelledby="txtboxMultilineLabel"
aria-required="true"></div>
js
let el = document.getElementById("txtBoxInput");
console.log(el.ariaMultiLine); // "true"
el.ariaMultiLine = "false";
console.log(el.ariaMultiLine); // "false"
仕様書
| 仕様書 |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariamultiline |