diff options
Diffstat (limited to 'files/fr/web/api/clipboard/writetext/index.md')
| -rw-r--r-- | files/fr/web/api/clipboard/writetext/index.md | 64 |
1 files changed, 25 insertions, 39 deletions
diff --git a/files/fr/web/api/clipboard/writetext/index.md b/files/fr/web/api/clipboard/writetext/index.md index 93b7310625..226177f104 100644 --- a/files/fr/web/api/clipboard/writetext/index.md +++ b/files/fr/web/api/clipboard/writetext/index.md @@ -3,57 +3,43 @@ title: Clipboard.writeText() slug: Web/API/Clipboard/writeText translation_of: Web/API/Clipboard/writeText --- -<div>{{APIRef("Clipboard API")}}</div> +{{APIRef("Clipboard API")}} -<p>La méthode <strong><code>writeText()</code></strong> de l’interface {{domxref("Clipboard")}} écrit le texte spécifié dans le presse-papiers du système.</p> +La méthode **`writeText()`** de l’interface {{domxref("Clipboard")}} écrit le texte spécifié dans le presse-papiers du système. -<div class="note"> -<p><strong>Note :</strong> La spécification requiert que l’<a href="/en-US/docs/Web/API/Permissions_API">API Permissions</a> soit utilisée pour obtenir la permission <code>"clipboardWrite"</code> avant d’écrire dans le presse-papiers. Cependant, les prérequis exacts varient de navigateur en navigateur, car c’est une API récente. Consultez la {{anch("Browser compatibility", "table de compatibilité")}} et {{SectionOnPage("/docs/Web/API/Clipboard", "Clipboard availability")}} pour plus de détails.</p> -</div> +> **Note :** La spécification requiert que l’[API Permissions](/en-US/docs/Web/API/Permissions_API) soit utilisée pour obtenir la permission `"clipboardWrite"` avant d’écrire dans le presse-papiers. Cependant, les prérequis exacts varient de navigateur en navigateur, car c’est une API récente. Consultez la {{anch("Browser compatibility", "table de compatibilité")}} et {{SectionOnPage("/docs/Web/API/Clipboard", "Clipboard availability")}} pour plus de détails. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <em>promesse</em> = navigator.clipboard.writeText(<em>nouveauTexte</em>)</pre> + var promesse = navigator.clipboard.writeText(nouveauTexte) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>nouveauTexte</code></dt> - <dd>La {{domxref("DOMString")}} devant être écrite dans le presse-papiers.</dd> -</dl> +- `nouveauTexte` + - : La {{domxref("DOMString")}} devant être écrite dans le presse-papiers. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une {{jsxref("Promise")}} qui sera résolue une fois que le contenu du presse-papiers aura été mis à jour. La promesse est rejetée si le code appelant n’a pas la permission d’écrire dans le presse-papiers.</p> +Une {{jsxref("Promise")}} qui sera résolue une fois que le contenu du presse-papiers aura été mis à jour. La promesse est rejetée si le code appelant n’a pas la permission d’écrire dans le presse-papiers. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Cet exemple définit le contenu du presse-papiers comme la chaîne "<presse-papiers vide>".</p> +Cet exemple définit le contenu du presse-papiers comme la chaîne "\<presse-papiers vide>". -<pre class="brush: js">navigator.clipboard.writeText("<presse-papiers vide>").then(function() { +```js +navigator.clipboard.writeText("<presse-papiers vide>").then(function() { /* presse-papiers modifié avec succès */ }, function() { /* échec de l’écriture dans le presse-papiers */ }); -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('Clipboard API','#h-clipboard-writetext-data','writeText()')}}</td> - <td>{{Spec2('Clipboard API')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Clipboard.writeText")}}</p> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | ------------------------------------ | -------------------- | +| {{SpecName('Clipboard API','#h-clipboard-writetext-data','writeText()')}} | {{Spec2('Clipboard API')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Clipboard.writeText")}} |