Event.preventDefault()

Вы читаете английскую версию этой статьи, так как пока нет перевода на данный язык. Помогите нам перевести эту статью!

Метод preventDefault () интерфейса Event сообщает User agent, что если событие не обрабатывается явно, его действие по умолчанию не должно выполняться так, как обычно. Событие продолжает распространяться как обычно, если один из его прослушивателей событий не вызывает stopPropagation () или stopImmediatePropagation (), любой из которых прекращает распространение сразу.
Как отмечено ниже, вызов метода preventDefault () для события, не подлежащего отмене, например события, отправленного через EventTarget.dispatchEvent (), без указания cancelable: true не имеет эффекта.

 

Синтаксис

event.preventDefault();

Пример

По умолчанию щелчок по флажку переключает его состояние на противоположное. В этом примере показано, как предотвратить такое поведение:

<!DOCTYPE html>
<html>
<head>
<title>Пример preventDefault</title>

<script>
function stopDefAction(evt) {
    evt.preventDefault();
}
    
document.getElementById('my-checkbox').addEventListener(
    'click', stopDefAction, false
);
</script>
</head>

<body>

<p>Пожалуйста, щёлкните по флажку.</p>

<form>
    <input type="checkbox" id="my-checkbox" />
    <label for="my-checkbox">Checkbox</label>
</form>

</body>
</html>

Вы можете посмотреть работу preventDefault в действии здесь.

В следующем примере некорректный ввод останавливается и вводимый символ не добавляется в поле с preventDefault().

<!DOCTYPE html>
<html>
<head>
<title>Пример preventDefault</title>

<script>
function Init () {
    var myTextbox = document.getElementById('my-textbox');
    myTextbox.addEventListener( 'keypress', checkName, false );
}

function checkName(evt) {
    var charCode = evt.charCode;
    if (charCode != 0) {
        if (charCode < 97 || charCode > 122) {
            evt.preventDefault();
            alert(
                "Пожалуйста, используйте только буквы нижнего регистра на латинице"
                + "\n" + "charCode: " + charCode + "\n"
            );
        }
    }
} 
</script> 
</head> 
<body onload="Init ()"> 
    <p>Пожалуйста, введите своё имя, используя только буквы нижнего регистра на латинице.</p>
    <form> 
        <input type="text" id="my-textbox" /> 
    </form> 
</body> 
</html>

Результат выполнения кода:

Примечания

Вызов preventDefault на любой стадии выполнения  потока событий отменяет событие, а это означает, что любое действие по умолчанию обычно принимается реализацией, как  результат события, которое  не произойдет.

Примечание:  В Gecko 6.0, вызов preventDefault() приводит к event.defaultPrevented к переходу значения в состояние True.

Вы можете использовать event.cancelable чтобы проверить, является ли событие отменяемым. Вызов preventDefault для неотменяемых событий не имеет никакого эффекта.

preventDefault не останавливает дальнейшее распространение событий на DOM. Для этого следует использовать event.stopPropagation.

Спецификации

Спецификация Статус Комментарий
DOM
Определение 'Event.preventDefault()' в этой спецификации.
Живой стандарт
DOM4
Определение 'Event.preventDefault()' в этой спецификации.
Устаревшая
Document Object Model (DOM) Level 2 Events Specification
Определение 'Event.preventDefault()' в этой спецификации.
Устаревшая

первичное определение.