From 3cf9bd8b9901006085d4e0f353b0d3b6b8f69d93 Mon Sep 17 00:00:00 2001 From: julieng Date: Mon, 15 Nov 2021 21:45:15 +0100 Subject: convert content to md --- .../add-ons/webextensions/api/clipboard/index.md | 31 ++++----- .../api/clipboard/setimagedata/index.md | 78 +++++++++++----------- 2 files changed, 53 insertions(+), 56 deletions(-) (limited to 'files/fr/mozilla/add-ons/webextensions/api/clipboard') diff --git a/files/fr/mozilla/add-ons/webextensions/api/clipboard/index.md b/files/fr/mozilla/add-ons/webextensions/api/clipboard/index.md index abb0395447..d8633a147f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/clipboard/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/clipboard/index.md @@ -10,30 +10,27 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/clipboard --- -
{{AddonSidebar}}
+{{AddonSidebar}} -

L'API presse-papiers permet à une extension de copier des éléments dans le presse papier du système. Actuellement l'API ne prend en charge que la copie d'images, mais elle est destinée à prendre en charge la copie de texte et HTML dans l'avenir.

+L'API `presse-papiers` permet à une extension de copier des éléments dans le presse papier du système. Actuellement l'API ne prend en charge que la copie d'images, mais elle est destinée à prendre en charge la copie de texte et HTML dans l'avenir. -

Cette API WebExtension existe principalement parce que l'API standard du presse-papiers Web ne prend pas en charge l'écriture d'images dans le presse-papiers. Cette API peut être dépréciée une fois que le support de l'API Clipboard pour les contenus non textuels du presse-papiers est entré en usage général.

+Cette API WebExtension existe principalement parce que l'API standard du presse-papiers Web [ne prend pas en charge l'écriture d'images dans le presse-papiers](https://w3c.github.io/clipboard-apis/#writing-to-clipboard). Cette API peut être dépréciée une fois que le support de l'API Clipboard pour les contenus non textuels du presse-papiers est entré en usage général. -

La lecture depuis le presse-papiers n'est pas prise en charge par cette API, car le presse-papiers peut déjà être lu à l'aide des API de plate-forme Web standard. Voir Interaction avec le presse-papier.

+La lecture depuis le presse-papiers n'est pas prise en charge par cette API, car le presse-papiers peut déjà être lu à l'aide des API de plate-forme Web standard. Voir [Interaction avec le presse-papier](/fr/Add-ons/WebExtensions/Interact_with_the_clipboard#Reading_from_the_clipboard). -

Cette API est basée sur l'API de clipboard de Chrome, mais cette API n'est disponible que pour les applications Chrome et non pour les extensions.

+Cette API est basée sur l'API de [`clipboard`](https://developer.chrome.com/apps/clipboard) de Chrome, mais cette API n'est disponible que pour les applications Chrome et non pour les extensions. -

Pour utiliser cette API, vous devez avoir la permission "clipboardWrite".

+Pour utiliser cette API, vous devez avoir la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `"clipboardWrite"`. -

Fonctions

+## Fonctions -
-
{{WebExtAPIRef("clipboard.setImageData()")}}
-
Copiez une image dans le presse-papiers.
-
+- {{WebExtAPIRef("clipboard.setImageData()")}} + - : Copiez une image dans le presse-papiers. -

Compatibilité du navigateur

+## Compatibilité du navigateur -

{{Compat("webextensions.api.clipboard", 1, 1)}} {{WebExtExamples("h2")}}

+{{Compat("webextensions.api.clipboard", 1, 1)}} {{WebExtExamples("h2")}} -

Note :

- -

Cette API est basée sur l'API Chromium chrome.clipboard.

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.clipboard`](https://developer.chrome.com/apps/clipboard). diff --git a/files/fr/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md b/files/fr/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md index 13c76084b9..80c6d7473d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md @@ -12,68 +12,68 @@ tags: - setImageData translation_of: Mozilla/Add-ons/WebExtensions/API/clipboard/setImageData --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

Copie une image dans le presse-papiers. L'image est recodée avant d'être écrite dans le presse-papiers. Si l'image n'est pas valide, le presse-papiers n'est pas modifié.

+Copie une image dans le presse-papiers. L'image est recodée avant d'être écrite dans le presse-papiers. Si l'image n'est pas valide, le presse-papiers n'est pas modifié. -

L'image est fournie en tant que ArrayBuffer contenant l'image codée. Les formats JPEG et PNG sont pris en charge.

+L'image est fournie en tant que [`ArrayBuffer`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer) contenant l'image codée. Les formats JPEG et PNG sont pris en charge. -

Bien que cette API soit basée sur l'API clipboard.setImageData() de Chrome, il existe certaines différentes :

+Bien que cette API soit basée sur l'API [`clipboard.setImageData()`](https://developer.chrome.com/apps/clipboard) de Chrome, il existe certaines différentes : - +- L'API Chrome est réservée aux applications et non aux extensions. +- Cette API nécessite uniquement la permission `"clipboardWrite"`, tandis que la version Chrome nécessite également la permission `"clipboard"`. +- L'API de Chrome utilise des rappels et cette API ne prend en charge que les promises. +- Cette API ne prend pas en charge le paramètre `additionalItems`. -

C'est une fonction asynchrone qui renvoie une Promise.

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

+## Syntaxe -
browser.clipboard.setImageData(imageData, imageType)
-
+```js +browser.clipboard.setImageData(imageData, imageType) +``` -

Paramètres

+### Paramètres -
-
imageData
-
ArrayBuffer. Les données de l'image codées.
-
imageType
-
Un {{domxref("DOMString")}} indiquant le type d'image contenue dans le fichier imageData: "png" ou "jpeg".
-
+- `imageData` + - : [`ArrayBuffer`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer). Les données de l'image codées. +- `imageType` + - : Un {{domxref("DOMString")}} indiquant le type d'image contenue dans le fichier `imageData`: `"png"` ou `"jpeg"`. -

Valeur de retour

+### Valeur de retour -

Une Promise qui sera remplie sans arguments si l'opération a réussi, ou rejetée, s'il y a une erreur (par exemple parce que les données ne représentaient pas une image valide).

+Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments si l'opération a réussi, ou rejetée, s'il y a une erreur (par exemple parce que les données ne représentaient pas une image valide). -

Compatibilité du navigateur

+## Compatibilité du navigateur -

{{Compat("webextensions.api.clipboard.setImageData", 10)}}

+{{Compat("webextensions.api.clipboard.setImageData", 10)}} -

Exemples

+## Exemples -

Copiez une image distante :

+Copiez une image distante : -
// requires:
+```js
+// requires:
 // * the host permission for "https://cdn.mdn.mozilla.net/*"
 // * the API permission "clipboardWrite"
 
 fetch('https://cdn.mdn.mozilla.net/static/img/favicon144.png')
-.then(response => response.arrayBuffer())
-.then(buffer => browser.clipboard.setImageData(buffer, 'png'));
+.then(response => response.arrayBuffer()) +.then(buffer => browser.clipboard.setImageData(buffer, 'png')); +``` -

Copiez une image fournie avec l'extension :

+Copiez une image fournie avec l'extension : -
// requires the API permission "clipboardWrite"
+```js
+// requires the API permission "clipboardWrite"
 
 fetch(browser.runtime.getURL('image.png'))
-.then(response => response.arrayBuffer())
-.then(buffer => browser.clipboard.setImageData(buffer, 'png'));
+.then(response => response.arrayBuffer()) +.then(buffer => browser.clipboard.setImageData(buffer, 'png')); +``` -

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

- -

Cette API est basée sur l'API Chromium chrome.clipboard.

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.clipboard`](https://developer.chrome.com/apps/clipboard). -- cgit v1.2.3-54-g00ecf