CKTIS / HTML
termín nebo hodnota HTML: translate
Atribut `translate` určuje, zda se má při lokalizaci měnit text a přeložitelné hodnoty atributů prvku; normativní stavy jsou `yes` a `no`.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<section translate="no">…</section>Prázdná hodnota a slovo yes překlad zapínají, zatímco no jej vypíná. Chybějící či neplatná hodnota dědí stav rodiče; na kořeni absence deklarace ve výchozím stavu překlad dovoluje.
Stav zahrnuje textové uzly a atributy definované jako přeložitelné, mezi nimi title, alt a placeholder. Nezpůsobí okamžitý překlad stránky prohlížečem; je pokynem pro lokalizační nástroje a postupy.
Použij translate="no" v co nejmenším rozsahu pro značky, kód, identifikátory či data, jejichž změna by zničila význam. Nenahrazuje deklaraci lang, řízení přístupu ani ochranu před čtením obsahu.
Příklad hlásí translate jako false na rodiči a dědícím potomku, výslovné přepsání true na druhém potomku a surovou hodnotu null tam, kde atribut chybí.
Příklady
<!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>Výsledek
parent=false; inherited=false; override=true; childRaw=null
Spuštěný příklad ověřuje dědění stavu bez překladu a platné obnovení yes ve vnořené pasáži.