From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../add-ons/webextensions/api/tabs/index.html | 225 +++++++++++++++++++++ 1 file changed, 225 insertions(+) create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/index.html (limited to 'files/fr/mozilla/add-ons/webextensions/api/tabs/index.html') diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/index.html new file mode 100644 index 0000000000..0666c1885c --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/index.html @@ -0,0 +1,225 @@ +--- +title: tabs +slug: Mozilla/Add-ons/WebExtensions/API/tabs +tags: + - API + - Add-ons + - Extensions + - Interface + - NeedsTranslation + - Non-standard + - Reference + - TopicStub + - WebExtensions + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs +--- +
{{AddonSidebar}}
+ +

Permet d’interagir avec le système d’onglets du navigateur.

+ +

Vous pouvez utiliser cette API pour obtenir une liste des onglets ouverts, filtrés par différents critères, ainsi que pour ouvrir, mettre à jour, déplacer, recharger et supprimer des onglets. Vous ne pouvez pas accéder directement au contenu hébergé par les onglets à l’aide de cette API, mais vous pouvez insérer du JavaScript et du CSS dans les onglets en utilisant les API {{WebExtAPIRef("tabs.executeScript()")}} ou {{WebExtAPIRef("tabs.insertCSS()")}}.

+ +

Vous pouvez utiliser la majeure partie de cette API sans autorisation spéciale. Toutefois :

+ + + +

Alternativement, vous pouvez obtenir ces autorisations temporairement, uniquement pour l’onglet actuellement actif et uniquement en réponse à une action explicite de l’utilisateur ou de l’utilisatrice, en demandant la permission "activeTab".

+ +

De nombreuses opérations d’onglet utilisent un identifiant (id) d’onglet. Les id d’onglets sont seulement garantis uniques à un onglet durant une session de navigation. Si le navigateur est redémarré, il pourra recycler, et recyclera, les id d’onglets. Pour associer des informations à un onglet à travers les redémarrages du navigateur, utilisez {{WebExtAPIRef("sessions.setTabValue()")}}.

+ +

Types

+ +
+
{{WebExtAPIRef("tabs.MutedInfoReason")}}
+
Spécifie la raison pour laquelle un onglet a été rendu silencieux ou à nouveau sonore.
+
{{WebExtAPIRef("tabs.MutedInfo")}}
+
Cet objet contient un booléen indiquant si l’onglet est silencieux et la raison de la dernière modification de l’état.
+
{{WebExtAPIRef("tabs.PageSettings")}}
+
+

Permet de contrôler le rendu d’un onglet au format PDF par la méthode {{WebExtAPIRef("tabs.saveAsPDF()")}}.

+
+
{{WebExtAPIRef("tabs.Tab")}}
+
Ce type contient des informations sur un onglet.
+
{{WebExtAPIRef("tabs.TabStatus")}}
+
Indique si l’onglet a fini de charger.
+
{{WebExtAPIRef("tabs.WindowType")}}
+
Le type de fenêtre qui héberge cet onglet.
+
{{WebExtAPIRef("tabs.ZoomSettingsMode")}}
+
Définit si les modifications de zoom sont traitées par le navigateur, par l’extension ou sont désactivées.
+
{{WebExtAPIRef("tabs.ZoomSettingsScope")}}
+
Définit si les modifications de zoom persisteront pour l’origine de la page ou ne prendront effet que dans cet onglet.
+
{{WebExtAPIRef("tabs.ZoomSettings")}}
+
Définit les paramètres de zoom {{WebExtAPIRef("tabs.ZoomSettingsMode", "mode")}}, {{WebExtAPIRef("tabs.ZoomSettingsScope", "scope")}}, et le facteur de zoom par défaut.
+
+ +

Propriétés

+ +
+
{{WebExtAPIRef("tabs.TAB_ID_NONE")}}
+
Une valeur d’id spéciale donnée aux onglets qui ne sont pas des onglets de navigation (par exemple, les onglets dans les fenêtres devtools).
+
+ +

Fonctions

+ +
+
{{WebExtAPIRef("tabs.captureTab()")}}
+
Crée un URI de données codant une image de la zone visible de l’onglet donné.
+
{{WebExtAPIRef("tabs.captureVisibleTab()")}}
+
Crée un URI de données codant une image de la zone visible de l’onglet actuellement actif dans la fenêtre donnée.
+
{{WebExtAPIRef("tabs.connect()")}}
+
Définit une connexion pour échanger des messages entre les scripts d’arrière-plan de l’extension (ou d’autres scripts privilégiés, tels que les scripts de popups ou les scripts de page d’options) et les scripts de contenu s’exécutant dans l’onglet spécifié.
+
{{WebExtAPIRef("tabs.create()")}}
+
Crée un nouvel onglet.
+
{{WebExtAPIRef("tabs.detectLanguage()")}}
+
Détecte la langue principale du contenu dans un onglet.
+
{{WebExtAPIRef("tabs.discard()")}}
+
Évince un ou plusieurs onglets.
+
{{WebExtAPIRef("tabs.duplicate()")}}
+
Duplique un onglet.
+
{{WebExtAPIRef("tabs.executeScript()")}}
+
Injecte du code JavaScript dans une page.
+
{{WebExtAPIRef("tabs.get()")}}
+
Obtient des détails sur l’onglet spécifié.
+
{{WebExtAPIRef("tabs.getAllInWindow()")}} {{deprecated_inline}}
+
Obtient des détails sur tous les onglets de la fenêtre spécifiée.
+
{{WebExtAPIRef("tabs.getCurrent()")}}
+
Obtient des informations sur l’onglet dans lequel ce script s’exécute, en tant qu’objet {{WebExtAPIRef("tabs.Tab")}}.
+
{{WebExtAPIRef("tabs.getSelected()")}} {{deprecated_inline}}
+
Obtient l’onglet sélectionné dans la fenêtre spécifiée. Deprecated: utilisez plutôt tabs.query({active: true}).
+
{{WebExtAPIRef("tabs.getZoom()")}}
+
Obtient le facteur de zoom actuel de l’onglet spécifié.
+
{{WebExtAPIRef("tabs.getZoomSettings()")}}
+
Obtient les paramètres de zoom actuels pour l’onglet spécifié.
+
{{WebExtAPIRef("tabs.goForward()")}}
+
Passez à la page suivante, si vous en avez une.
+
{{WebExtAPIRef("tabs.goBack()")}}
+
Retour à la page précédente, si elle est disponible.
+
{{WebExtAPIRef("tabs.hide()")}} {{experimental_inline}}
+
Masque un ou plusieurs onglets.
+
{{WebExtAPIRef("tabs.highlight()")}}
+
Met en évidence un ou plusieurs onglets.
+
{{WebExtAPIRef("tabs.insertCSS()")}}
+
Injecte CSS dans une page.
+
{{WebExtAPIRef("tabs.move()")}}
+
Déplace un ou plusieurs onglets vers une nouvelle position dans la même fenêtre ou vers une autre fenêtre.
+
{{WebExtApiRef("tabs.moveInSuccession()")}}
+
Modifie la relation de succession pour un groupe d’onglets.
+
{{WebExtAPIRef("tabs.print()")}}
+
Imprime le contenu de l’onglet actif.
+
{{WebExtAPIRef("tabs.printPreview()")}}
+
+
Ouvre l’aperçu avant impression pour l’onglet actif.
+
+
{{WebExtAPIRef("tabs.query()")}}
+
Obtient tous les onglets ayant les propriétés spécifiées, ou tous les onglets si aucune propriété n’est spécifiée.
+
{{WebExtAPIRef("tabs.reload()")}}
+
Recharge un onglet, en contournant éventuellement le cache web local.
+
{{WebExtAPIRef("tabs.remove()")}}
+
Ferme un ou plusieurs onglets.
+
{{WebExtAPIRef("tabs.removeCSS()")}}
+
Supprime d’une page CSS qui a été précédemment injectée en appelant {{WebExtAPIRef("tabs.insertCSS()")}}.
+
{{WebExtAPIRef("tabs.saveAsPDF()")}}
+
Enregistre la page en cours au format PDF.
+
{{WebExtAPIRef("tabs.sendMessage()")}}
+
Envoie un message unique au(x) script(s) de contenu dans l’onglet spécifié.
+
{{WebExtAPIRef("tabs.sendRequest()")}} {{deprecated_inline}}
+
Envoie une requête unique au(x) script(s) de contenu dans l’onglet spécifié. Déprécié : utilisez {{WebExtAPIRef("tabs.sendMessage()")}} à la place.
+
{{WebExtAPIRef("tabs.setZoom()")}}
+
Effectue un zoom sur l’onglet spécifié.
+
{{WebExtAPIRef("tabs.setZoomSettings()")}}
+
Définit les paramètres de zoom pour l’onglet spécifié.
+
{{WebExtAPIRef("tabs.show()")}} {{experimental_inline}}
+
Affiche un ou plusieurs onglets qui ont été {{WebExtAPIRef("tabs.hide()", "masqués")}}.
+
{{WebExtAPIRef("tabs.toggleReaderMode()")}}
+
Bascule en mode lecture pour l’onglet spécifié.
+
{{WebExtAPIRef("tabs.update()")}}
+
Charge une nouvelle URL dans l’onglet, ou modifie d’autres propriétés de l’onglet.
+
+ +

Évènements

+ +
+
{{WebExtAPIRef("tabs.onActivated")}}
+
Est émis lorsque l’onglet actif dans une fenêtre change. Notez que l’URL de l’onglet peut ne pas être définie au moment où cet évènement a été émis.
+
{{WebExtAPIRef("tabs.onActiveChanged")}} {{deprecated_inline}}
+
Est émis lorsque l’onglet sélectionné dans une fenêtre change. Déprécié : utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.
+
{{WebExtAPIRef("tabs.onAttached")}}
+
Est émis lorsqu’un onglet est attaché à une fenêtre, par exemple parce qu’il a été déplacé entre différentes fenêtres.
+
{{WebExtAPIRef("tabs.onCreated")}}
+
Est émis lorsqu’un onglet est créé. Notez que l’URL de l’onglet peut ne pas être définie au moment où cet évènement a été émis.
+
{{WebExtAPIRef("tabs.onDetached")}}
+
Est émis lorsqu’un onglet est détaché d’une fenêtre, par exemple parce qu’il a été déplacé entre différentes fenêtres.
+
{{WebExtAPIRef("tabs.onHighlightChanged")}} {{deprecated_inline}}
+
Est émis lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent. Déprécié : utilisez {{WebExtAPIRef("tabs.onHighlighted")}} à la place.
+
{{WebExtAPIRef("tabs.onHighlighted")}}
+
Est émis lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent.
+
{{WebExtAPIRef("tabs.onMoved")}}
+
Est émis lorsqu’un onglet est déplacé dans une fenêtre.
+
{{WebExtAPIRef("tabs.onRemoved")}}
+
Est émis lorsqu’un onglet est fermé.
+
{{WebExtAPIRef("tabs.onReplaced")}}
+
Est émis lorsqu’un onglet est remplacé par un autre onglet en raison d’un prerendering.
+
{{WebExtAPIRef("tabs.onSelectionChanged")}} {{deprecated_inline}}
+
Est émis lorsque l’onglet sélectionné dans une fenêtre change. Déprécié : utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.
+
{{WebExtAPIRef("tabs.onUpdated")}}
+
Est émis lorsqu’un onglet est mis à jour.
+
{{WebExtAPIRef("tabs.onZoomChange")}}
+
Est émis lorsque le zoom dans un onglet est changé.
+
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("webextensions.api.tabs")}}

+ +

{{WebExtExamples("h2")}}

+ +
Remerciements : + +

Cette API est basée sur l’API Chromium chrome.tabs. Cette documentation est dérivée de tabs.json dans le code de Chromium code.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
+ + -- cgit v1.2.3-54-g00ecf