aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/windoweventhandlers/onbeforeprint/index.md
blob: 1df25a3c86948b252a2421a9ef5b084ded6008d9 (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
---
title: WindowEventHandlers.onbeforeprint
slug: Web/API/WindowEventHandlers/onbeforeprint
tags:
  - API
  - DOM
  - Propriété
  - impression
translation_of: Web/API/WindowEventHandlers/onbeforeprint
---
{{ApiRef}}

La propriété `onbeforeprint` définit et retourne le code du gestionnaire d'événement `onbeforeprint` onbeforeprint pour la fenêtre actuelle.

## Syntaxe

    window.onbeforeprint = code de traitement de l'événement

## Notes

Les événements `beforeprint` et `afterprint` permettent aux pages de modifier leur contenu avant le début de l'impression (peut-être pour supprimer une bannière, par exemple), puis d'annuler ces modifications une fois l'impression terminée. En général, les auteurs de contenu devraient préférer l'utilisation d'une règle CSS [@media print](/en-US/docs/Web/CSS/@media), mais il peut être nécessaire d'utiliser ces événements dans certains cas.

L'événement `beforeprint` est appelé avant l'ouverture de la fenêtre de dialogue d'impression.

Safari ne reconnaît pas ces événements, mais un résultat équivalent à l'événement `beforeprint` peut être obtenu avec `{{domxref("window.matchMedia")}}('print')`.

```js
var mediaQueryList = window.matchMedia('print');
mediaQueryList.addListener(function(mql) {
  if(mql.matches) {
    console.log('équivalent webkit de onbeforeprint');
  }
});
```

## Spécification

| Specification                                                                                            | Status                           | Comment |
| -------------------------------------------------------------------------------------------------------- | -------------------------------- | ------- |
| {{SpecName('HTML WHATWG', '#handler-window-onbeforeprint', 'onbeforeprint')}} | {{Spec2('HTML WHATWG')}} |         |

## Compatibilité des navigateurs

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

## Voir également

- {{domxref("window.print")}}
- {{domxref("window.onafterprint")}}
- [Printing](/en-US/docs/Printing)