From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/clipboard/writetext/index.html | 61 +++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 files/fr/web/api/clipboard/writetext/index.html (limited to 'files/fr/web/api/clipboard/writetext') diff --git a/files/fr/web/api/clipboard/writetext/index.html b/files/fr/web/api/clipboard/writetext/index.html new file mode 100644 index 0000000000..1237db947b --- /dev/null +++ b/files/fr/web/api/clipboard/writetext/index.html @@ -0,0 +1,61 @@ +--- +title: Clipboard.writeText() +slug: Web/API/Clipboard/writeText +translation_of: Web/API/Clipboard/writeText +--- +
{{APIRef("Clipboard API")}}
+ +

La méthode writeText() de l’interface {{domxref("Clipboard")}} écrit le texte spécifié dans le presse-papiers du système.

+ +
+

Note : La spécification requiert que l’API Permissions 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.

+
+ +

Syntaxe

+ +
var promesse = navigator.clipboard.writeText(nouveauTexte)
+ +

Paramètres

+ +
+
nouveauTexte
+
La {{domxref("DOMString")}} devant être écrite dans le presse-papiers.
+
+ +

Valeur de retour

+ +

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.

+ +

Exemple

+ +

Cet exemple définit le contenu du presse-papiers comme la chaîne "<presse-papiers vide>".

+ +
navigator.clipboard.writeText("<presse-papiers vide>").then(function() {
+  /* presse-papiers modifié avec succès */
+}, function() {
+  /* échec de l’écriture dans le presse-papiers */
+});
+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Clipboard API','#h-clipboard-writetext-data','writeText()')}}{{Spec2('Clipboard API')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

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

-- cgit v1.2.3-54-g00ecf