files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.html


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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

---
title: tabs.PageSettings
slug: Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings
tags:
  - API
  - Add-ons
  - Extensions
  - PageSettings
  - Reference
  - Type
  - WebExtensions
  - tabs
translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings
---
<div>{{AddonSidebar}}</div>

<p>Le type <strong><code>tabs.PageSettings</code></strong> est utilisé pour contrôler le rendu d'un onglet au format PDF par la méthode  {{WebExtAPIRef("tabs.saveAsPDF()")}}.</p>

<p>Toutes ses propriétés sont facultatives.</p>

<p>Pour définir les en-têtes et les pieds de page, vous pouvez inclure certains caractères spéciaux dans les chaînes que vous fournissez. Ceux-ci seront remplacés dans la sortie rendue comme suit :</p>

<ul>
 <li>"&amp;P": le numéro de page, comme "2"</li>
 <li>"&amp;PT": le numéro de page et le nombre total de pages, comme "2 su 3"</li>
 <li>"&amp;D": la date / heure actuelle</li>
 <li>"&amp;T": le titre de la page</li>
 <li>"&amp;U": l'URL de la page</li>
</ul>

<h2 id="Type">Type</h2>

<p>Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :</p>

<dl class="reference-values">
 <dt><code>edgeBottom </code>{{optional_inline}}</dt>
 <dd><code>number</code>. L'espacement entre le bas des pieds et le bord inférieur du papier (pouces). Par défaut : 0.</dd>
 <dt><code>edgeLeft </code>{{optional_inline}}</dt>
 <dd><code>number</code>. L'espacement entre l'en-tête / pied de page gauche et le bord gauche du papier (pouces). Par défaut : 0</dd>
 <dt><code>edgeRight </code>{{optional_inline}}</dt>
 <dd><code>number</code>. L'espacement entre l'en-tête / pied droit et le bord gauche du papier (pouces). Par défaut : 0.</dd>
 <dt><code>edgeTop </code>{{optional_inline}}</dt>
 <dd><code>number</code>. L'espacement entre le haut des en-têtes et le bord supérieur du papier (pouces). Par défaut : 0</dd>
 <dt><code>footerCenter</code> {{optional_inline}}</dt>
 <dd><code>string</code>. Le texte du pied de page central de la page. Défaut : ''.</dd>
 <dt><code>footerLeft</code> {{optional_inline}}</dt>
 <dd><code>string</code>. Le texte pour le pied gauche de la page. Par défaut :  '&amp;PT'.</dd>
 <dt><code>footerRight</code> {{optional_inline}}</dt>
 <dd><code>string</code>. Le texte pour le pied droit de la page. Par défaut : '&amp;D'.</dd>
 <dt><code>headerCenter</code> {{optional_inline}}</dt>
 <dd><code>string</code>. Le texte de l'en-tête du centre de la page. Défaut : ''.</dd>
 <dt><code>headerLeft</code> {{optional_inline}}</dt>
 <dd><code>string</code>. Le texte de l'en-tête gauche de la page. Par défaut : '&amp;T'.</dd>
 <dt><code>headerRight</code> {{optional_inline}}</dt>
 <dd><code>string</code>. Le texte de l'en-tête de la page. Par défaut : '&amp;U'.</dd>
 <dt><code>marginBottom </code>{{optional_inline}}</dt>
 <dd><code>number</code>. La marge entre le contenu de la page et le bord inférieur du papier (pouces). Par défaut : 0.5.</dd>
 <dt><code>marginLeft </code>{{optional_inline}}</dt>
 <dd><code>number</code>. La marge entre le contenu de la page et le bord gauche du papier (pouces). Par défaut : 0.5.</dd>
 <dt><code>marginRight </code>{{optional_inline}}</dt>
 <dd><code>number</code>. La marge entre le contenu de la page et le bord droit du papier (en pouces). Par défaut : 0.5.</dd>
 <dt><code>marginTop </code>{{optional_inline}}</dt>
 <dd><code>number</code>. La marge entre le contenu de la page et le bord supérieur du papier (pouces). Par défaut : 0.5.</dd>
 <dt><code>orientation </code> {{optional_inline}}</dt>
 <dd><code>integer</code>. Orientation de la page: 0 signifie "portrait", 1 signifie "paysage". Par défaut : 0.</dd>
 <dt><code>paperHeight </code>{{optional_inline}}</dt>
 <dd><code>number</code>. La hauteur du papier dans les unités de format papier. Par défaut : 11.0.</dd>
 <dt><code>paperSizeUnit</code> {{optional_inline}}</dt>
 <dd><code>integer</code>. L'unité de format de papier: 0 = pouces, 1 = millimètres. Par défaut : 0.</dd>
 <dt><code>paperWidth</code> {{optional_inline}}</dt>
 <dd><code>number</code>. La largeur du papier dans les unités de format papier. Par défaut : 8.5.</dd>
 <dt><code>scaling</code> {{optional_inline}}</dt>
 <dd><code>number</code>. Facteur d'échelle du contenu de la page. 1 signifie 100% ou taille normale. Par défaut : 1.</dd>
 <dt><code>showBackgroundColors</code> {{optional_inline}}</dt>
 <dd><code>boolean</code>. Si les couleurs d'arrière-plan de la page doivent être affichées. Par défaut : false.</dd>
 <dt><code>showBackgroundImages</code> {{optional_inline}}</dt>
 <dd><code>boolean</code>. Si les images d'arrière-plan de la page doivent être affichées. Par défaut : false.</dd>
 <dt><code>shrinkToFit</code> {{optional_inline}}</dt>
 <dd><code>boolean</code>. Si le contenu de la page doit rétrécir pour s'adapter à la largeur de la page (remplace la mise à l'échelle). Par défaut : true.</dd>
</dl>

<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>

<p>{{Compat("webextensions.api.tabs.PageSettings")}}</p>

<p>{{WebExtExamples}}</p>