aboutsummaryrefslogtreecommitdiff
path: root/files/fr/mozilla/add-ons/webextensions/api/clipboard/index.html
blob: abb0395447ad8c2921fbde552c152af97ad3d6b3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
---
title: clipboard
slug: Mozilla/Add-ons/WebExtensions/API/clipboard
tags:
  - API
  - Add-ons
  - Clipboard
  - Extensions
  - Reference
  - WebExtensions
translation_of: Mozilla/Add-ons/WebExtensions/API/clipboard
---
<div>{{AddonSidebar}}</div>

<p>L'API <code>presse-papiers</code> 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.</p>

<p>Cette API WebExtension existe principalement parce que l'API standard du presse-papiers Web <a href="https://w3c.github.io/clipboard-apis/#writing-to-clipboard">ne prend pas en charge l'écriture d'images dans le presse-papiers</a>. 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.</p>

<p>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 <a href="/fr/Add-ons/WebExtensions/Interact_with_the_clipboard#Reading_from_the_clipboard">Interaction avec le presse-papier</a>.</p>

<p>Cette API est basée sur l'API de <code><a href="https://developer.chrome.com/apps/clipboard">clipboard</a></code> de Chrome, mais cette API n'est disponible que pour les applications Chrome et non pour les extensions.</p>

<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"clipboardWrite"</code>.</p>

<h2 id="Fonctions">Fonctions</h2>

<dl>
 <dt>{{WebExtAPIRef("clipboard.setImageData()")}}</dt>
 <dd>Copiez une image dans le presse-papiers.</dd>
</dl>

<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>

<p>{{Compat("webextensions.api.clipboard", 1, 1)}} {{WebExtExamples("h2")}}</p>

<div class="note"><p><strong>Note :</strong></p>

<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/apps/clipboard"><code>chrome.clipboard</code></a>.</p>
</div>