CKTIS / HTML
oncopy — gestionnaire de l’événement de copie
L’attribut oncopy associe du code JavaScript à la gestion de l’événement copy. Il peut figurer sur n’importe quel élément HTML pour réagir à une copie, par exemple en mettant à jour un message sur la page.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
oncopy="JavaScript statements"oncopy est un attribut global de gestionnaire d’événement pour copy, l’événement associé à la copie. Sa valeur contient des instructions JavaScript, et non une valeur booléenne ou simplement un nom de fonction. Dans le code de l’attribut, le paramètre event fournit l’objet événement.
Il faut distinguer l’attribut HTML de la propriété JavaScript element.oncopy, à laquelle on affecte une fonction ou null. Cette propriété existe également sur les objets Document et Window. Une nouvelle affectation remplace la fonction précédente de la propriété ; addEventListener('copy', handler) permet d’enregistrer des écouteurs indépendants.
Copier du texte sélectionné dans le paragraphe de l’exemple ne garantit pas l’exécution de son gestionnaire. Pour une sélection dans une zone non modifiable, la spécification de la Clipboard API désigne comme cible de l’événement copy le nœud qui a le focus, ou body si aucun nœud n’a le focus. Le paragraphe de l’exemple ne peut pas recevoir le focus. Si son gestionnaire s’exécute, le message devient copy ; sinon, il reste Waiting. L’exemple ne modifie pas le contenu copié. Renvoyer false depuis le gestionnaire annule l’événement s’il peut être annulé. La Content Security Policy peut bloquer le code dans les attributs ; ajouter oncopy ne contourne pas cette restriction.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncopy demo</title>
<p id="sample" oncopy="document.getElementById('status').textContent = event.type">Select and copy this text.</p>
<output id="status">Waiting</output>
</html>Résultat
copy
Le résultat `copy` a été observé dans un environnement Chromium isolé. Dans d’autres navigateurs, le message peut rester `Waiting`.