From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/clipboard_api/index.md | 73 ++++++++++++++++----------------- 1 file changed, 36 insertions(+), 37 deletions(-) (limited to 'files/fr/web/api/clipboard_api/index.md') diff --git a/files/fr/web/api/clipboard_api/index.md b/files/fr/web/api/clipboard_api/index.md index bef8e4bafd..bdd7d9543c 100644 --- a/files/fr/web/api/clipboard_api/index.md +++ b/files/fr/web/api/clipboard_api/index.md @@ -1,61 +1,60 @@ --- title: API Clipboard slug: Web/API/Clipboard_API -translation_of: 'Web/API/Clipboard_API' +translation_of: Web/API/Clipboard_API --- -
{{DefaultAPISidebar("Clipboard API")}}
+{{DefaultAPISidebar("Clipboard API")}} -

L'API Clipboard (en français : API Presse-papiers) fournit la possibilité de répondre aux commandes du presse-papiers (couper, copier et coller) ainsi que de lire et écrire sur le presse-papiers système de façon asynchrone. L'accès aux contenus du presse-papiers est protégé par l'API Permissions : la permission clipboard-write est donnée automatiquement aux pages lorsqu'elles sont dans l'onglet actif. La permission clipboard-read doit quant à elle être demandée, ce que vous pouvez faire en tentant de lire les données du presse-papiers.

+L'**API Clipboard** (en français : API Presse-papiers) fournit la possibilité de répondre aux commandes du presse-papiers (couper, copier et coller) ainsi que de lire et écrire sur le presse-papiers système de façon asynchrone. L'accès aux contenus du presse-papiers est protégé par l'[API Permissions](/fr/docs/Web/API/Permissions_API) : la permission `clipboard-write` est donnée automatiquement aux pages lorsqu'elles sont dans l'onglet actif. La permission `clipboard-read` doit quant à elle être demandée, ce que vous pouvez faire en tentant de lire les données du presse-papiers. -
-

Note : Cette API n'est pas disponible dans les Web Workers (elle n'est pas exposée via {{domxref("WorkerNavigator")}}).

-
+> **Note :** Cette API _n'est pas disponible_ dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API) (elle n'est pas exposée via {{domxref("WorkerNavigator")}}). -

Cette API est conçue pour remplacer l'accès au presse-papiers précédemment proposé via {{domxref("document.execCommand()")}}.

+Cette API est conçue pour remplacer l'accès au presse-papiers précédemment proposé via {{domxref("document.execCommand()")}}. -

Accéder au presse-papier

+## Accéder au presse-papier -

Au lieu de créer un objet Clipboard lors de l'instanciation, vous pouvez accéder au presse-papier du système avec la globale {{domxref("Navigator.clipboard")}} :

+Au lieu de créer un objet `Clipboard` lors de l'instanciation, vous pouvez accéder au presse-papier du système avec la globale {{domxref("Navigator.clipboard")}} : -
navigator.clipboard.readText().then(
-  clipText => document.querySelector(".editor").innerText += clipText);
+```js +navigator.clipboard.readText().then( + clipText => document.querySelector(".editor").innerText += clipText); +``` -

Ce bout de code analyse le texte à partir du presse-papiers et l'insère après le premier élément trouvé comportant la classe editor. Puisque {{domxref("Clipboard.readText", "readText()")}} (sans oublier {{domxref("Clipboard.read", "read()")}}) retournent une chaîne vide si le contenu du presse-papier n'est pas textuel, ce code est sécurisé.

+Ce bout de code analyse le texte à partir du presse-papiers et l'insère après le premier élément trouvé comportant la classe `editor`. Puisque {{domxref("Clipboard.readText", "readText()")}} (sans oublier {{domxref("Clipboard.read", "read()")}}) retournent une chaîne vide si le contenu du presse-papier n'est pas textuel, ce code est sécurisé. -

Interfaces

+## Interfaces -
-
{{domxref("Clipboard")}} {{securecontext_inline}}
-
Fournit une interface pour la lecture et l'écriture de texte et de données sur le presse-papiers du système. La spécification s'y réfère avec le terme "Async Clipboard API".
-
{{domxref("ClipboardEvent")}} {{securecontext_inline}}
-
Représente les évènements fournissant l'information relative à la modification du presse-papiers, qui peut être l'évènement {{domxref("Element/cut_event", "cut")}}, {{domxref("Element/copy_event", "copy")}} ou {{domxref("Element/paste_event", "paste")}}. La spécification s'y réfère avec le terme "Clipboard Event API".
-
{{domxref("ClipboardItem")}} {{securecontext_inline}}
-
Représente un format de terme unique utilisé pour lire ou écrire des données.
-
+- {{domxref("Clipboard")}} {{securecontext_inline}} + - : Fournit une interface pour la lecture et l'écriture de texte et de données sur le presse-papiers du système. La spécification s'y réfère avec le terme "Async Clipboard API". +- {{domxref("ClipboardEvent")}} {{securecontext_inline}} + - : Représente les évènements fournissant l'information relative à la modification du presse-papiers, qui peut être l'évènement {{domxref("Element/cut_event", "cut")}}, {{domxref("Element/copy_event", "copy")}} ou {{domxref("Element/paste_event", "paste")}}. La spécification s'y réfère avec le terme "Clipboard Event API". +- {{domxref("ClipboardItem")}} {{securecontext_inline}} + - : Représente un format de terme unique utilisé pour lire ou écrire des données. -

Spécifications

+## Spécifications -

{{Specifications("api.Clipboard")}}

+{{Specifications("api.Clipboard")}} -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

Clipboard

+### Clipboard -

{{Compat("api.Clipboard")}}

+{{Compat("api.Clipboard")}} -

ClipboardEvent

+### ClipboardEvent -

{{Compat("api.ClipboardEvent")}}

+{{Compat("api.ClipboardEvent")}} -

ClipboardItem

+### ClipboardItem -

{{Compat("api.ClipboardItem")}}

+{{Compat("api.ClipboardItem")}} -

Voir aussi

+## Voir aussi - +- [Démonstration de l'API Async Clipboard sur Glitch (en anglais)](https://async-clipboard-api.glitch.me/) +- Image support for Async Clipboard article + + [Image support for Async Clipboard article (en anglais)](https://web.dev/image-support-for-async-clipboard/) + +- [API Permissions](/fr/docs/Web/API/Permissions_API) +- [Utiliser l'API Permissions](/fr/docs/Web/API/Permissions_API/Using_the_Permissions_API) -- cgit v1.2.3-54-g00ecf