CKTIS / HTML
terme ou valeur HTML: translate
L’attribut `translate` indique si le texte et les valeurs d’attribut traduisibles d’un élément doivent changer pendant la localisation ; ses états normatifs sont `yes` et `no`.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<section translate="no">…</section>La valeur vide et le mot yes autorisent la traduction, tandis que no l’interdit. Une valeur absente ou invalide hérite du parent ; à la racine, l’absence de déclaration autorise la traduction par défaut.
L’état couvre les nœuds texte et les attributs définis comme traduisibles, dont title, alt et placeholder. Il ne provoque pas une traduction immédiate par le navigateur ; c’est une consigne pour les outils et processus de localisation.
Appliquez translate="no" au plus petit périmètre possible pour les marques, le code, les identifiants ou les données dont la modification détruirait le sens. Il ne remplace ni lang, ni le contrôle d’accès, ni une protection contre la lecture.
L’exemple donne translate à false sur le parent et l’enfant qui hérite, un remplacement explicite true sur le second enfant et la valeur brute null là où l’attribut est absent.
Exemples
<!doctype html><meta charset="utf-8"><section id="p" translate="no"><span id="x">Brand</span><span id="y" translate="yes">Translate me</span></section><output id="result"></output><script>result.textContent=`parent=${p.translate}; inherited=${x.translate}; override=${y.translate}; childRaw=${x.getAttribute("translate")}`;</script>Résultat
parent=false; inherited=false; override=true; childRaw=null
L’exemple exécuté vérifie l’héritage de l’interdiction de traduction et le rétablissement valide de yes dans un passage imbriqué.