CKTIS / HTML
termín alebo hodnota HTML: translate
Atribút `translate` určuje, či sa má pri lokalizácii meniť text a preložiteľné hodnoty atribútov prvku; normatívne stavy sú `yes` a `no`.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<section translate="no">…</section>Prázdna hodnota a slovo yes preklad zapínajú, kým no ho vypína. Chýbajúca či neplatná hodnota dedí stav rodiča; na koreni neprítomnosť deklarácie predvolene preklad dovoľuje.
Stav zahŕňa textové uzly a atribúty definované ako preložiteľné, medzi nimi title, alt a placeholder. Nespôsobí okamžitý preklad stránky prehliadačom; je pokynom pre lokalizačné nástroje a postupy.
Použi translate="no" v čo najmenšom rozsahu pre značky, kód, identifikátory či údaje, ktorých zmena by zničila význam. Nenahrádza deklaráciu lang, riadenie prístupu ani ochranu pred čítaním obsahu.
Príklad hlási translate ako false na rodičovi a dediacom potomkovi, výslovné prepísanie true na druhom potomkovi a surovú hodnotu null tam, kde atribút chýba.
Prí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ýsledok
parent=false; inherited=false; override=true; childRaw=null
Spustený príklad overuje dedenie stavu bez prekladu a platné obnovenie yes vo vnorenej pasáži.