Element: ariaBrailleLabel プロパティ

値

<string>

値は文字列で、点字に変換するための制約のない値型です。

例

ariaBrailleLabel の取得と設定

この例では、ariaBrailleLabel プロパティを取得・設定する方法を示します。

HTML

まず、"3 out of 5 stars" というラベルテキストと、aria-braillelabel 属性に "\*\*\*" という値が設定されたボタンを定義します。 これにより、点字ディスプレイでは、"btn gra 3 out of 5 stars" という冗長な表示ではなく、"btn ***" という点字表示が可能になります。

<button id="button" aria-braillelabel="\*\*\*">3 out of 5 stars</button>

<pre id="log"></pre>

#log {
  height: 100px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

JavaScript

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

次に、このコードはボタンの ariaBrailleLabel プロパティを使用して、最初に点字ラベルを取得し、ログに記録します。 そして、点字ラベルを "3*" に設定し、その値を再びログに記録します。

const button = document.getElementById("button");
log(button.ariaBrailleLabel);
button.ariaBrailleLabel = "3*";
log(button.ariaBrailleLabel);

結果

仕様書

ブラウザーの互換性