aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/window/pageshow_event/index.md
blob: 112cdea1ba01cf15c0a355a0831fe78eb913a4ee (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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
---
title: pageshow
slug: Web/API/Window/pageshow_event
translation_of: Web/API/Window/pageshow_event
original_slug: Web/Events/pageshow
---
L’évènement `pageshow` est émis lorsqu’une entrée dans un historique de session est atteinte (cela comprend les boutons précédent / suivant ainsi que l’affichage initial de la page après l’évènement `onload`).

## Informations générales

- Spécification
  - : [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-pageshow)
- Interface
  - : [PageTransitionEvent](/fr/docs/Web/API/PageTransitionEvent)
- Bouillonne
  - : Non
- Annulable
  - : Non
- Cible
  - : Document (dispatché sur Window)
- Action par défaut
  - : Aucune

## Propriétés

| Propriété                             | Type                                 | Description                                               |
| ------------------------------------- | ------------------------------------ | --------------------------------------------------------- |
| `target` {{readonlyInline}}     | {{domxref("EventTarget")}} | La cible de l’évènement (la plus haute dans l’arbre DOM). |
| `type` {{readonlyInline}}       | {{domxref("DOMString")}}     | Le type d’évènement.                                      |
| `bubbles` {{readonlyInline}}    | {{jsxref("Boolean")}}         | Si l’évènement bouillonne en temps normal ou non.         |
| `cancelable` {{readonlyInline}} | {{jsxref("Boolean")}}         | Si l’évènement est annulable ou non.                      |
| `persisted` {{readonlyInline}}  | {{jsxref("boolean")}}         | Si l’entrée est chargée depuis le cache ou non.           |

## Exemples

L’exemple suivant va afficher dans la console des informations sur l’évènement `pageshow`, qui est émis à l’utilisation des boutons précédent / suivant, et pas uniquement après `onload` :

```js
window.addEventListener('pageshow', function(event) {
    console.log('pageshow:');
    console.log(event);
});
```

Bien que ce ne soit pas la meilleure pratique, vous pouvez également ajouter l’évènement comme un attribut sur la balise `<body>`, de la même manière que `onload` :

```html
<body onload="myonload()" onpageshow="mypageshowcode()">
```

## Spécifications

| Spécification                                                                                            | Statut                           | Commentaire             |
| -------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------------------- |
| {{SpecName('HTML WHATWG', 'browsing-the-web.html#event-pageshow', 'pageshow')}} | {{Spec2('HTML WHATWG')}} | Spécification initiale. |
| {{SpecName('HTML5 W3C', 'browsers.html#event-pageshow', 'pageshow')}}             | {{Spec2('HTML5 W3C')}}     |                         |

## Compatibilité des navigateurs

{{Compat("api.Window.pageshow_event")}}

## Voir aussi

- {{domxref("Window.pagehide_event", "pagehide")}}