diff options
Diffstat (limited to 'files/fr/web/api/clipboard/write/index.md')
| -rw-r--r-- | files/fr/web/api/clipboard/write/index.md | 62 |
1 files changed, 23 insertions, 39 deletions
diff --git a/files/fr/web/api/clipboard/write/index.md b/files/fr/web/api/clipboard/write/index.md index 214a32eac6..955bf1f320 100644 --- a/files/fr/web/api/clipboard/write/index.md +++ b/files/fr/web/api/clipboard/write/index.md @@ -3,36 +3,33 @@ title: Clipboard.write() slug: Web/API/Clipboard/write translation_of: Web/API/Clipboard/write --- -<div>{{APIRef("Clipboard API")}}</div> +{{APIRef("Clipboard API")}} -<p>La methode <strong><code>write()</code></strong> de {{domxref("Clipboard")}} écrie des données arbitraire, comme des images, vers le presse-papier. Elle peut être utilisé pour implémenter une fonctionalité de copier coller.</p> +La methode **`write()`** de {{domxref("Clipboard")}} écrie des données arbitraire, comme des images, vers le presse-papier. Elle peut être utilisé pour implémenter une fonctionalité de copier coller. -<p>Avant de pouvoir écrire dans le presse-papier, vous devez utiliser <a href="/en-US/docs/Web/API/Permissions_API">Permissions API</a> pour avoir l'autorisation <code>"clipboard-write"</code>.</p> +Avant de pouvoir écrire dans le presse-papier, vous devez utiliser [Permissions API](/en-US/docs/Web/API/Permissions_API) pour avoir l'autorisation `"clipboard-write"`. -<div class="note"> -<p><strong>Note:</strong> Browser support for the asynchronous clipboard APIs is still in the process of being implemented. Be sure to check the {{anch("Browser compatibility", "compatibility table")}} as well as {{SectionOnPage("/en-US/docs/Web/API/Clipboard", "Clipboard availability")}} for more information.</p> -</div> +> **Note :** Browser support for the asynchronous clipboard APIs is still in the process of being implemented. Be sure to check the {{anch("Browser compatibility", "compatibility table")}} as well as {{SectionOnPage("/en-US/docs/Web/API/Clipboard", "Clipboard availability")}} for more information. -<h2 id="Syntax">Syntax</h2> +## Syntax -<pre class="syntaxbox">var <em>promise</em> = navigator.clipboard.write(<em>dataTransfer</em>)</pre> + var promise = navigator.clipboard.write(dataTransfer) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>dataTransfer</code></dt> - <dd>Un objet {{domxref("DataTransfer")}} contenant les données à écrire dans le presse-papier.</dd> -</dl> +- `dataTransfer` + - : Un objet {{domxref("DataTransfer")}} contenant les données à écrire dans le presse-papier. -<h3 id="Return_value">Return value</h3> +### Return value -<p>Une {{jsxref("Promise")}} qui sera résolut quand les données seront écrite dans le presse papier. Cette promesse est rejetée si l'accés au presse-papier échoue.</p> +Une {{jsxref("Promise")}} qui sera résolut quand les données seront écrite dans le presse papier. Cette promesse est rejetée si l'accés au presse-papier échoue. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Cette fonction d'exemple remplace l'actuel contenut du presse-papier par le texte spécifié en paramètre.</p> +Cette fonction d'exemple remplace l'actuel contenut du presse-papier par le texte spécifié en paramètre. -<pre class="brush: js">function setClipboard(text) { +```js +function setClipboard(text) { let data = new DataTransfer(); data.items.add(text, "text/plain"); @@ -42,29 +39,16 @@ translation_of: Web/API/Clipboard/write /* failure */ }); } -</pre> +``` -<p>Le code commence par la creation d'un nouveau objet {{domxref("DataTransfer")}} dans lequel le texte est placé pour être envoyé au presse-papier. {{domxref("DataTransferItemList.add()")}} est appelé pour ajouté le texte à<code>DataTransfer</code>, ensuite <code>write()</code> est appelé, en spécifiant une function d'accomplissement et une fonction d'erreur.</p> +Le code commence par la creation d'un nouveau objet {{domxref("DataTransfer")}} dans lequel le texte est placé pour être envoyé au presse-papier. {{domxref("DataTransferItemList.add()")}} est appelé pour ajouté le texte à`DataTransfer`, ensuite `write()` est appelé, en spécifiant une function d'accomplissement et une fonction d'erreur. -<h2 id="Specifications">Specifications</h2> +## Specifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('Clipboard API','#h-clipboard-write-data','write()')}}</td> - <td>{{Spec2('Clipboard API')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> +| Specification | Status | Comment | +| ---------------------------------------------------------------------------------------- | ------------------------------------ | ------------------- | +| {{SpecName('Clipboard API','#h-clipboard-write-data','write()')}} | {{Spec2('Clipboard API')}} | Initial definition. | -<h2 id="Browser_compatibility">Browser compatibility</h2> +## Browser compatibility - - -<p>{{Compat("api.Clipboard.write")}}</p> +{{Compat("api.Clipboard.write")}} |
