CKTIS / HTML
onlanguagechange — gérer les changements de langues préférées
L’attribut onlanguagechange sur body définit le gestionnaire de l’objet Window pour languagechange. Cet événement signale un changement des langues préférées de l’utilisateur telles que les comprend le navigateur, et non une modification de l’attribut lang du document.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onlanguagechange="JavaScript statements">onlanguagechange est un attribut de contenu de gestionnaire d’événement utilisé sur body. Sa valeur contient du JavaScript exécuté lors de l’événement languagechange de l’objet Window ; il ne s’agit pas d’un événement ordinaire ciblant body.
Le navigateur déclenche cet événement lorsque sa compréhension des langues préférées de l’utilisateur change. Dans le gestionnaire, lisez navigator.languages pour obtenir les préférences dans leur ordre, ou navigator.language pour connaître la langue préférée. Modifier l’attribut lang ne signifie pas que ces préférences ont changé, et l’événement ne traduit pas la page à lui seul.
En JavaScript, le même gestionnaire peut être défini avec window.onlanguagechange. Une nouvelle affectation remplace le gestionnaire précédent à cet emplacement ; window.addEventListener('languagechange', handler) permet plutôt d’enregistrer des écouteurs indépendants. La politique de sécurité d’une page peut bloquer le code dans les attributs de gestionnaire d’événement.
L’exemple déclenche volontairement un événement synthétique sur window afin que le résultat ne dépende pas des paramètres de langue de l’appareil. Il vérifie l’appel du gestionnaire, mais ne modifie pas les préférences et ne teste pas la détection par le navigateur d’un changement réel de préférence.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onlanguagechange demo</title>
</head>
<body onlanguagechange="document.getElementById('status').textContent = 'languagechange received'">
<p id="status">Waiting</p>
<button type="button" id="test">Test</button>
<script>
document.getElementById('test').addEventListener('click', () => {
window.dispatchEvent(new Event('languagechange'));
});
</script>
</body>
</html>Résultat
languagechange received
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.