CKTIS / HTML
onpaste — gestionnaire de l’événement de collage
L’attribut onpaste associe du code JavaScript à la gestion de l’événement paste. Il est disponible sur tous les éléments HTML, mais sa présence ne rend pas un élément modifiable.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onpaste="JavaScript function body"onpaste est un attribut global de gestion d’événement HTML associé à l’événement paste. Sa valeur contient des instructions JavaScript formant le corps d’une fonction, et non le nom d’un type d’événement. L’attribut lui-même ne rend pas un élément modifiable.
Dans le code de l’attribut, event désigne l’objet événement et this l’élément qui gère l’événement. return false annule l’action par défaut de l’événement lorsqu’il peut être annulé ; lors d’un collage ordinaire dans un champ éditable, cela empêche l’insertion de texte. Cela n’arrête pas la propagation de l’événement.
L’attribut HTML onpaste et la propriété JavaScript element.onpaste configurent le même mécanisme de gestion : l’attribut contient du code, tandis que la propriété reçoit une fonction ou null. Une nouvelle affectation de la propriété remplace la fonction précédente. addEventListener('paste', handler) enregistre des écouteurs séparément ; il utilise paste, sans le préfixe on.
L’exemple met à jour un message d’état et bloque le collage par défaut. Il nécessite JavaScript activé et l’autorisation d’exécuter des gestionnaires d’événements intégrés ; une Content Security Policy peut les bloquer. Ne construisez pas ce code à partir de données non fiables.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpaste demo</title>
<label>Paste here: <textarea onpaste="document.getElementById('status').textContent = 'paste handled'; return false;"></textarea></label>
<p id="status" role="status">waiting</p>
</html>Résultat
paste handled
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.