Attribut global HTMLAttributs globaux

translate

Permet de désactiver la traduction automatique d’un fragment de la page, par exemple un nom de marque ou du code.

S’applique à
Tous les éléments HTML
Sur cette page

Exemple

#
HTML
<style>
  [translate="no"] { border-bottom: 1px dashed #a78bfa; }
</style>

<p>
  Bienvenue sur <span translate="no">CodeWorlds</span> ! Dans cette leçon, vous découvrirez la méthode
  <code translate="no">document.querySelector()</code>.
</p>
<p>Autrice de la leçon : <span translate="no">Anne Kowalczyk</span></p>
Aperçu

Le soulignement vient du style de l’exemple et repère les fragments avec translate="no". Lorsque quelqu’un traduit la page dans le navigateur, le nom du site, le code et le nom de personne restent dans l’original, et le reste du texte change de langue.

Définition et utilisation

#

L’attribut translate indique aux outils de traduction automatique si le contenu de l’élément doit être traduit. La valeur no signifie « laisser dans l’original ». Elle est respectée par les traducteurs intégrés aux navigateurs, comme celui de Chrome, et par de nombreux services qui traduisent des pages entières.

Il est utile partout où la traduction casse quelque chose : dans les noms de marques et de produits qui sont des mots ordinaires, dans les noms de personnes, les adresses et surtout dans les extraits de code. Un traducteur ne distingue pas le code du texte ordinaire, il peut donc traduire des noms de fonctions et des mots-clés, et un tel code cesse de fonctionner une fois copié.

Tous les éléments à l’intérieur héritent du réglage. Si vous désactivez la traduction d’un bloc plus grand, vous pouvez la réactiver à l’intérieur avec translate="yes". Lorsque personne ne traduit la page, l’attribut ne change rien, ni à l’aspect ni au fonctionnement.

Syntaxe

#
Syntaxe
<element translate="yes | no">…</element>

Valeurs

#
  • yes

    ou vide

    Le contenu peut être traduit. C’est le comportement par défaut, vous écrivez donc cette valeur surtout pour réactiver la traduction à l’intérieur d’un bloc avec translate="no".
  • no

    Le contenu doit rester dans l’original, avec tous les éléments qu’il contient.

Plus d’exemples

#
Une page entière sans traduction automatique
HTML
<!DOCTYPE html>
<html lang="fr" translate="no">
  <head>
    <meta charset="utf-8">
    <meta name="google" content="notranslate">
    <title>Code source du projet | CodeWorlds</title>
  </head>
  <body>…</body>
</html>

L’attribut sur l’élément <html> désactive la traduction de toute la page. La balise <meta name="google" content="notranslate"> fait la même chose, mais seul Google la comprend.

Compatibilité des navigateurs

#

Largement disponible · depuis 2023

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Sur les pages de formations et de documentation, marquez les blocs de code (<pre>, <code>) avec translate="no". Un lecteur qui utilise la traduction obtient alors du code qui fonctionnera une fois copié.
  • Certains outils, dont Google Traduction, reconnaissent aussi la classe notranslate. Par précaution, vous pouvez ajouter les deux notations : translate="no" class="notranslate".
  • Ne désactivez pas la traduction d’une page entière sans raison sérieuse. Pour beaucoup de personnes, la traduction automatique est le seul moyen de la comprendre.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.