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
Exemple
#<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>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
#<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 avectranslate="no".no
Le contenu doit rester dans l’original, avec tous les éléments qu’il contient.
Plus d’exemples
#<!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>) avectranslate="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
#- langLa langue du contenu de l’élément, par exemple pl ou en.
- <code>Un fragment de code informatique : le nom d’une variable, d’une fonction, d’une balise ou d’un fichier, ainsi qu’un court extrait.
- <pre>Un texte préformaté : il conserve les espaces, les tabulations et les retours à la ligne exactement comme dans le code.
- <html>La racine d’un document HTML. Tous les autres éléments de la page se trouvent à l’intérieur.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.