Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLElement : propriété translate

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨mars 2023⁩.

La propriété translate de l'interface HTMLElement indique si les valeurs d'attribut d'un élément et les valeurs de ses nœuds enfants Text doivent être traduites lors de la localisation de la page, ou laissées inchangées.

Elle reflète la valeur de l'attribut HTML universel translate.

Valeur

Une valeur booléenne qui vaut true si les valeurs d'attribut de l'élément et les valeurs de ses nœuds enfants Text doivent être traduites lors de la localisation de la page, et false sinon.

Exemples

L'exemple suivant montre comment activer ou désactiver la traduction via un script :

html
<div>
  <span>Le contenu peut toujours être traduit&nbsp;: </span>
  <span translate="yes">El contenido será traducido</span>
</div>
<div>
  <span id="translate-label">Le contenu peut être traduit&nbsp;:</span>
  <span id="translate-element" translate="no">
    El contenido puede ser traducido.
  </span>
</div>
<input id="translate-controller" type="checkbox" /> Activer la traduction
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 = "Le contenu peut être traduit :";
  } else {
    element.translate = false;
    label.innerText = "Le contenu ne peut pas être traduit :";
  }
});

Spécifications

Specification
HTML
# dom-translate

Compatibilité des navigateurs

Voir aussi