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

浏览器兼容性

另见