diff options
Diffstat (limited to 'files/fr/mozilla/add-ons/webextensions/manifest.json/background/index.html')
-rw-r--r-- | files/fr/mozilla/add-ons/webextensions/manifest.json/background/index.html | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/manifest.json/background/index.html b/files/fr/mozilla/add-ons/webextensions/manifest.json/background/index.html new file mode 100644 index 0000000000..4181a9e841 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/manifest.json/background/index.html @@ -0,0 +1,93 @@ +--- +title: background +slug: Mozilla/Add-ons/WebExtensions/manifest.json/arriere-plan +tags: + - Add-ons + - Extensions + - WebExtensions +translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/background +--- +<div>{{AddonSidebar}}</div> + +<table class="fullwidth-table standard-table"> + <tbody> + <tr> + <th scope="row" style="width: 30%;">Type</th> + <td><code>Object</code></td> + </tr> + <tr> + <th scope="row">Obligatoire</th> + <td>No</td> + </tr> + <tr> + <th scope="row">Exemple</th> + <td> + <pre class="brush: json no-line-numbers"> +"background": { + "scripts": ["background.js"] +}</pre> + </td> + </tr> + </tbody> +</table> + +<p>Utilisez la clé <font face="Consolas">background</font> pour inclure un ou plusieurs scripts d'arrière-plan, et éventuellement une page d'arrière-plan dans votre extension.</p> + +<p>Les scripts d'arrière-plan sont l'endroit pour placer le code qui doit maintenir l'état à long terme, ou effectuer des opérations à long terme, indépendamment de la durée de vie de toutes les pages Web ou les fenêtres du navigateur.</p> + +<p>Les scripts d'arrière-plan sont chargés dès que l'extension est chargée et restent chargés jusqu'à ce que l'extension soit désactivée ou désinstallée. Vous pouvez utiliser n'importe laquelle des WebExtension APIs dans le script, tant que vous avez demandé les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permissions</a> nécessaires.</p> + +<p>Voir la section "Pages arrière-plan" dans <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_pages">l'anatomie d'une WebExtension</a> pour plus de détails.</p> + +<p>La clé <font face="Consolas">background</font> est un objet qui peut avoir l'une des deux propriétés suivantes, toutes deux facultatives :</p> + +<table class="standard-table"> + <tbody> + <tr> + <td><code>"scripts"</code></td> + <td> + <p>Un ensemble de chaînes, chacune étant un chemin d'accès à une source JavaScript. Le chemin est relatif au fichier manifest.json lui-même. Ce sont les scripts d'arrière-plan qui seront inclus dans l'extension.</p> + + <p>Les scripts partagent la même fenêtre globale.</p> + + <p>Les scripts sont chargés dans l'ordre où 'ils apparaissent dans le tableau.</p> + + <p><strong>Notez qu'il y a un bug affectant les versions de Firefox antérieures à la version 50 </strong>: lorsque le débogueur Firefox est ouvert, les scripts ne sont pas toujours chargés dans l'ordre indiqué dans le tableau. Pour contourner ce bug, vous pouvez utiliser la propriété "page" et inclure des scripts de fond de page en utilisant les balises <script>. Ce bug est résolu dans Firefox 50, et à partir de ce moment, les scripts sont toujours chargés dans l'ordre indiqué dans le tableau.</p> + </td> + </tr> + <tr> + <td><code>"page"</code></td> + <td> + <div class="note"> + <p><strong>Note </strong>: Si vous souhaitez récupérer un script à partir d'un emplacement distant avec la balise <script> (par exemple : <script src = "https://code.jquery.com/jquery-1.7.1.min.js"> ), vous devrez également modifier la clé <code><a href="https://developer.mozilla.org/fr/Add-ons/WebExtensions/manifest.json/content_security_policy">content_security_policy</a></code> dans le fichier manifest.json de votre extension.</p> + </div> + + <p>Si vous spécifiez des "scripts", une page vide sera créée pour que vos scripts s'exécutent.</p> + + <p>Si vous avez besoin de contenu particulier dans la page, vous pouvez définir votre propre page en utilisant l'option "page".</p> + + <p>Si vous utilisez cette propriété, vous ne pouvez plus spécifier de scripts de fond à l'aide de «scripts», mais vous pouvez inclure vos propres scripts à partir de la page, tout comme dans une page Web normale.</p> + </td> + </tr> + </tbody> +</table> + +<h2 class="brush: json no-line-numbers" id="Exemple">Exemple</h2> + +<pre class="brush: json no-line-numbers"> "background": { + "scripts": ["jquery.js", "my-background.js"] + }</pre> + +<p>Chargez deux scripts de fond.</p> + +<pre class="brush: json"> "background": { + "page": "my-background.html" + }</pre> + +<p><span class="short_text" id="result_box" lang="fr"><span>Chargez une page d'arrière-plan personnalisée.</span></span></p> + +<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> + +<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> + +<p>{{Compat("webextensions.manifest.background", 10)}}</p> |