База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

onbeforeinput — обработване на събитие преди редактиране

onbeforeinput е атрибут за обработване на събитието beforeinput, свързано с редактиране на данни от потребителя. Той позволява JavaScript да се изпълни преди промяна и действието по подразбиране да бъде отменено, ако събитието може да се отменя.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

onbeforeinput="JavaScript statements"
element.onbeforeinput = function (event) { /* ... */ };

onbeforeinput е HTML атрибут, който съдържа код за обработване на събитието beforeinput. Той е достъпен във всички HTML елементи; добавянето му само по себе си не прави елемента редактируем. Съответстващото свойство в JavaScript е element.onbeforeinput.

В кода на атрибута event обозначава текущото събитие. Извикването на event.preventDefault() може да блокира действието по подразбиране само когато event.cancelable е със стойност true. Не приемайте, че всяка промяна може да бъде спряна по този начин.

Стойността на атрибута е JavaScript код, а не име на събитие. Примерът проверява обработването и отмяната на синтетично изпратено събитие beforeinput; той не симулира действително писане. Следователно непроменената стойност ABC не доказва, че естественото редактиране е било блокирано.

Примери

<!doctype html>
<meta charset="utf-8">
<title>onbeforeinput</title>
<input id="editor" value="ABC" onbeforeinput="if (event.cancelable) event.preventDefault()">
<pre id="result"></pre>
<script>
  const editor = document.getElementById('editor');
  const event = new Event('beforeinput', { bubbles: true, cancelable: true });
  const allowed = editor.dispatchEvent(event);
  document.getElementById('result').textContent =
    `allowed=${allowed}\ndefaultPrevented=${event.defaultPrevented}\nvalue=${editor.value}`;
</script>

Резултат

allowed=false
defaultPrevented=true
value=ABC

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници