Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onpaste — controlador del evento de pegado

El atributo onpaste asigna código JavaScript para gestionar el evento paste. Está disponible en todos los elementos HTML, pero añadirlo no hace que un elemento sea editable.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

onpaste="JavaScript function body"

onpaste es un atributo global de gestión de eventos HTML asociado al evento paste. Su valor contiene instrucciones JavaScript que forman el cuerpo de una función, no el nombre de un tipo de evento. El atributo por sí solo no hace que un elemento sea editable.

Dentro del código del atributo, event es el objeto de evento y this es el elemento que gestiona el evento. return false cancela la acción predeterminada del evento cuando se puede cancelar; en un pegado normal en un campo editable, impide que se inserte texto. No detiene la propagación del evento.

El atributo HTML onpaste y la propiedad JavaScript element.onpaste configuran el mismo mecanismo de gestión: el atributo contiene código, mientras que a la propiedad se le asigna una función o null. Volver a asignar la propiedad sustituye la función anterior. addEventListener('paste', handler) registra los escuchadores por separado; utiliza paste, sin el prefijo on.

El ejemplo actualiza un mensaje de estado y bloquea el pegado predeterminado. Requiere JavaScript habilitado y permiso para ejecutar controladores de eventos en línea; una Content Security Policy puede bloquearlos. No construyas este código a partir de datos no confiables.

Ejemplos

<!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>

Resultado

paste handled

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes