aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/windoweventhandlers/onlanguagechange/index.md
blob: 7f0dabe81f53fd5bbeba378a9735b9c2356e6546 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
---
title: WindowEventHandlers.onlanguagechange
slug: Web/API/WindowEventHandlers/onlanguagechange
tags:
  - API
  - Event Handler
  - Experimental
  - Propriété
  - Reference
  - Window
translation_of: Web/API/WindowEventHandlers/onlanguagechange
---
{{APIRef("HTML DOM")}} {{SeeCompatTable}}

La propriété **`onlanguagechange`** du mixin {{domxref("WindowEventHandlers")}} est le {{event("Event_handlers", "event handler")}} pour le traitement des événements {{event("languagechange")}}.

Ces événements sont reçus par l'objet implémentant cette interface, généralement un {{domxref ("Window")}}, un {{domxref ("HTMLBodyElement")}} ou un {{domxref ("HTMLIFrameElement")}}. Un tel événement est envoyé par le navigateur pour informer que la liste des langues préférées a été mise à jour. La liste est accessible via {{domxref("NavigatorLanguage.languages")}}.

## Syntaxe

    object.onlanguagechange = function;

### Valeur

- `function` est le nom d'une fonction définie par l'utilisateur, sans le suffixe `()` ni aucun paramètre, ou une déclaration de fonction anonyme, telle que `function(event) {...}`. Un gestionnaire d'événements a toujours un seul paramètre, contenant l'événement, ici de type {{domxref ("Event")}}.

## Exemple

```js
window.onlanguagechange = function(event) {
  console.log('événement de changement de langue détecté!');
};
```

## Spécifications

| Spécification                                                                                                                                | Statut                               | Commentaire             |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ----------------------- |
| {{ SpecName('HTML WHATWG', '#handler-window-onlanguagechange', 'WindowEventHandler.onlanguagechange') }} | {{ Spec2('HTML WHATWG') }} | Spécification initiale. |

## Compatibilité des navigateurs

{{Compat("api.WindowEventHandlers.onlanguagechange")}}

## Voir également

- L'événement {{event("languagechange")}} et son type, {{domxref("Event")}}