CKTIS / HTML
onpaste — обработчик на събитието за поставяне
Атрибутът onpaste задава JavaScript код за обработка на събитието paste. Той е наличен за всички HTML елементи, но добавянето му не прави елемента редактируем.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
onpaste="JavaScript function body"onpaste е глобален HTML атрибут за обработка на събития, свързан със събитието paste. Стойността му съдържа JavaScript инструкции, образуващи тялото на функция, а не име на тип събитие. Самият атрибут не прави елемента редактируем.
В кода на атрибута event е обектът на събитието, а this е елементът, който го обработва. return false отменя действието по подразбиране на събитието, когато то може да бъде отменено; при обикновено поставяне в редактируемо поле това предотвратява вмъкването на текст. То не спира разпространението на събитието.
HTML атрибутът onpaste и JavaScript свойството element.onpaste настройват един и същ механизъм за обработка: атрибутът съдържа код, а на свойството се присвоява функция или null. Повторното присвояване на свойството заменя предишната функция. addEventListener('paste', handler) регистрира слушатели отделно; използва paste, без префикса on.
Примерът актуализира съобщение за състоянието и блокира поставянето по подразбиране. Необходими са включен JavaScript и разрешение за изпълнение на вградени обработчици на събития; Content Security Policy може да ги блокира. Не съставяйте този код от ненадеждни данни.
Примери
<!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>Резултат
paste handled
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.