ElementInternals: ariaLabel 屬性

Baseline 2023

新推出

自 ⁨2023 年 10 月⁩ 以來，此功能已在最新裝置和瀏覽器版本中得到支援。此功能可能無法在舊裝置或瀏覽器上執行。

ElementInternals 介面的 ariaLabel 屬性反映了 aria-label 屬性的值，該屬性定義了為當前元素提供標籤的字串值。

注意：在 ElementInternals 上設定 ARIA 屬性允許為自定義元素定義預設語義。這些預設語義可能會被作者定義的屬性覆蓋，但可以確保在作者刪除或根本未新增這些屬性時，預設語義仍然保留。有關更多資訊，請參閱 Accessibility Object Model explainer。

值

字串。

示例

在此示例中，ariaLabel 的值設定為“close”。

class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaLabel = "close";
  }
  // …
}

規範

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

瀏覽器相容性

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2025年4月25日，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤