元素：ariaBrailleRoleDescription 屬性

Baseline 2024

新推出

自 2024 年 9 月起，此功能已可在最新裝置和瀏覽器版本上使用。此功能可能無法在舊裝置或瀏覽器上使用。

Element 介面的 ariaBrailleRoleDescription 屬性反映了 aria-brailleroledescription 屬性的值，該屬性定義了元素的 ARIA 盲文角色描述。

此屬性可用於提供 aria-roledescription 值的縮寫版本。僅當存在 aria-roledescription 且在極少數情況下其對於盲文來說過於冗長時才應使用它。aria-brailleroledescription 包含有關何時應設定該屬性的附加資訊。

值

<string>: 該值是一個字串，一種無約束的值型別，旨在轉換為盲文。

示例

獲取和設定 ariaBrailleRoleDescription

此示例展示瞭如何獲取和設定 ariaBrailleRoleDescription 屬性。

HTML

首先，我們定義一個 <article> 元素，該元素將用作幻燈片演示中的幻燈片。我們將 aria-roledescription 屬性設定為“slide”，將其在 aria-brailleroledescription 中的盲文縮寫設定為“sld”。

html

<article
  id="article"
  aria-roledescription="slide"
  aria-brailleroledescription="sld"
  aria-labelledby="slide1heading">
  <h1 id="slide1heading">Welcome to my talk</h1>
</article>

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

#log {
  height: 70px;
  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;
}

為了獲取元素的角色描述，我們使用 ariaBrailleRoleDescription 屬性。下面的程式碼首先獲取然後記錄該值。然後，它將盲文角色描述設定為“sd”，並再次記錄該值（僅用於說明目的 — 在生產程式碼中，您不會設定此值）。

const article = document.getElementById("article");
log(article.ariaBrailleRoleDescription);
article.ariaBrailleRoleDescription = "sd";
log(article.ariaBrailleRoleDescription);

結果

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA) # dom-ariamixin-ariabrailleroledescription

瀏覽器相容性

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2025年3月6日，由 MDN contributors 貢獻。

在 GitHub 上檢視此頁面 • 報告此內容的問題