aboutsummaryrefslogtreecommitdiff
path: root/files/fr/mozilla/add-ons/webextensions/manifest.json/index.md
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-11-15 21:45:09 +0100
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-11-15 22:10:33 +0100
commitf36cc6a7639a8f1adff02bc7a152bd7f54ceae6d (patch)
treea977e8bdefcbd40b40cd7812628da7bd95b48e10 /files/fr/mozilla/add-ons/webextensions/manifest.json/index.md
parent241dda7e8117b4ec0c843e3875a10e9f4aa7da7b (diff)
downloadtranslated-content-f36cc6a7639a8f1adff02bc7a152bd7f54ceae6d.tar.gz
translated-content-f36cc6a7639a8f1adff02bc7a152bd7f54ceae6d.tar.bz2
translated-content-f36cc6a7639a8f1adff02bc7a152bd7f54ceae6d.zip
move *.html to *.md
Diffstat (limited to 'files/fr/mozilla/add-ons/webextensions/manifest.json/index.md')
-rw-r--r--files/fr/mozilla/add-ons/webextensions/manifest.json/index.md138
1 files changed, 138 insertions, 0 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/manifest.json/index.md b/files/fr/mozilla/add-ons/webextensions/manifest.json/index.md
new file mode 100644
index 0000000000..564d4ae030
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/manifest.json/index.md
@@ -0,0 +1,138 @@
+---
+title: manifest.json
+slug: Mozilla/Add-ons/WebExtensions/manifest.json
+tags:
+ - Add-ons
+ - Extensions
+ - Overview
+ - WebExtensions
+ - manifest.json
+translation_of: Mozilla/Add-ons/WebExtensions/manifest.json
+---
+<p>{{AddonSidebar}}</p>
+
+<div class="note">
+<p><strong>Note :</strong> Cet article décrit manifest.json pour les extensions web. Si vous cherchez des informations sur le manifeste.json dans les PWAs, consultez l'article <a href="/fr/docs/Web/Manifest">Web App Manifest</a>.</p>
+</div>
+
+<p>Le fichier <code>manifest.json</code> est le seul fichier que chaque extension utilisant les API WebExtension doit contenir.</p>
+
+<p>En utilisant <code>manifest.json</code>, vous spécifiez les métadonnées basiques de votre extension comme son nom et sa version, et des fonctionnalités de votre extension comme les scripts en arrière-plan (les scripts de contenu et les actions du navigateur).</p>
+
+<p>C'est un fichier au format <a href="/fr/docs/Glossaire/JSON">JSON</a> à une exception près : il peut contenir des commentaires de type "<code>//</code>".</p>
+
+<h2 id="List_of_manifest.json_keys">List of manifest.json keys</h2>
+
+<p>Les clés <code>manifest.json</code> sont listées ci-dessous:</p>
+
+<div>{{ListSubpages("/en-US/Add-ons/WebExtensions/manifest.json")}}</div>
+
+<h3 id="Notes_about_manifest.json_keys">Notes about manifest.json keys</h3>
+
+<ul>
+ <li><code>"manifest_version"</code>, <code>"version"</code>, and <code>"name"</code> sont les seules clés obligatoires.</li>
+ <li><code>"default_locale"</code> doit être présent si le répertoire "<code>_locales</code>" est présent et sinon doit être absent.</li>
+ <li><code>"browser_specific_settings"</code> n'est pas prise en charge dans Google Chrome</li>
+</ul>
+
+<h3 id="Accessing_manifest.json_keys_at_runtime">Accessing manifest.json keys at runtime</h3>
+
+<p>Vous pouvez accéder au manifest de votre extension depuis le JavaScript de l'extension en utilisant la fonction {{WebExtAPIRef("runtime.getManifest()")}} :</p>
+
+<pre class="brush: js;">browser.runtime.getManifest().version;</pre>
+
+<h2 id="Exemple">Exemple</h2>
+
+<p>Le bloc ci-dessous contient la syntaxe de base de certaines clés communes du manifest</p>
+
+<div class="blockIndicator note">
+<p><strong>Note :</strong> Il ne s'agit pas d'un exemple à copier-coller. Le choix des clés dont vous aurez besoin dépend de l'extension que vous développez.</p>
+</div>
+
+<p>Pour des exemples complets d'extensions, voir <a href="/fr/Add-ons/WebExtensions/Examples">Exemple d'extensions</a>.</p>
+
+<pre class="brush: json;">{
+ "browser_specific_settings": {
+ "gecko": {
+ "id": "addon@example.com",
+ "strict_min_version": "42.0"
+ }
+ },
+
+ "background": {
+ "scripts": ["jquery.js", "my-background.js"],
+ },
+
+ "browser_action": {
+ "default_icon": {
+ "19": "button/geo-19.png",
+ "38": "button/geo-38.png"
+ },
+ "default_title": "Whereami?",
+ "default_popup": "popup/geo.html"
+ },
+
+ "commands": {
+ "toggle-feature": {
+ "suggested_key": {
+ "default": "Ctrl+Shift+Y",
+ "linux": "Ctrl+Shift+U"
+ },
+ "description": "Send a 'toggle-feature' event"
+ }
+ },
+
+ "content_security_policy": "script-src 'self' https://example.com; object-src 'self'",
+
+ "content_scripts": [
+ {
+ "exclude_matches": ["*://developer.mozilla.org/*"],
+ "matches": ["*://*.mozilla.org/*"],
+ "js": ["borderify.js"]
+ }
+ ],
+
+ "default_locale": "en",
+
+ "description": "...",
+
+ "icons": {
+ "48": "icon.png",
+ "96": "icon@2x.png"
+ },
+
+ "manifest_version": 2,
+
+ "name": "...",
+
+ "page_action": {
+ "default_icon": {
+ "19": "button/geo-19.png",
+ "38": "button/geo-38.png"
+ },
+ "default_title": "Whereami?",
+ "default_popup": "popup/geo.html"
+ },
+
+ "permissions": ["webNavigation"],
+
+ "version": "0.1",
+
+ "user_scripts": {
+ "api_script": "apiscript.js",
+ },
+
+ "web_accessible_resources": ["images/my-image.png"]
+}</pre>
+
+<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>
+
+<p>Pour un aperçu complet de toutes les clés de manifeste et de leurs sous-clés, <a href="/fr/Add-ons/WebExtensions/Browser_compatibility_for_manifest.json">voir le tableau complet de compatibilité du navigateur manifest.json</a>.</p>
+
+
+
+<p>{{Compat("webextensions.manifest")}}</p>
+
+<h2 id="Voir_aussi">Voir aussi</h2>
+
+<p>{{WebExtAPIRef("permissions")}} JavaScript API</p>