HTMLElement: translate 屬性

Baseline 已廣泛支援

此功能已成熟,並可在許多裝置和瀏覽器版本上執行。自 2023 年 3 月以來,它已在各種瀏覽器中可用。

HTMLElement 介面的 translate 屬性指示在頁面本地化時,元素的屬性值及其 Text 節點子節點的值是否需要被翻譯,或者保持不變。

它反映了 translate HTML 全域性屬性的值。

一個布林值,如果元素的屬性值及其 Text 節點子節點的值將在頁面本地化時被翻譯,則為 true,否則為 false

示例

下面的示例展示瞭如何透過指令碼啟用或停用翻譯

html
<div>
  <span>The content may always be translated: </span>
  <span translate="yes">El contenido será traducido</span>
</div>
<div>
  <span id="translate-label">The content may be translated:</span>
  <span id="translate-element" translate="no">
    El contenido puede ser traducido.
  </span>
</div>
<input id="translate-controller" type="checkbox" /> Enable translation
js
const label = document.getElementById("translate-label");
const element = document.getElementById("translate-element");
const controller = document.getElementById("translate-controller");

controller.addEventListener("change", (e) => {
  if (controller.checked) {
    element.translate = true;
    label.innerText = "The content may be translated:";
  } else {
    element.translate = false;
    label.innerText = "The content may not be translated:";
  }
});

規範

規範
HTML
# dom-translate

瀏覽器相容性

另見