Установка разового обработчика событий

Материал из JQuery

Перейти к: навигация, поиск
.one()

Устанавливает обработчик события выбранным элементам страницы. Особенностью метода является то, что обработчик будет вызван не более одного раза, на каждом из элементов. Метод имеет один вариант использования:

.one(eventType, [eventData], handler(eventObject)):jQuery1.1

eventType — тип обрабатываемого события. Например "click", "resize" и.т.д. (список всех событий см. ниже).
eventData — данные, передаваемые обработчику событий. Они должны быть представлены в форме объекта, в формате: {fName1:value1, fName2:value2, ...}.
handler(eventObject) — функция, которая будет установлена в качестве обработчика. При вызове она будет получать объект события eventObject.

Простой пример:

// Установим обработчик нажатия кнопкой мыши, элементу с идентификатором foo
$('#foo').one('click', function(){
  alert('Вы нажали на элемент "foo"');
});
 
// Теперь, при нажатии на элемент foo, будет выведено сообщение

Убрать установленный обработчик можно с помощью метода unbind().

Подробности использования метода можно найти в описании bind(). Эти методы различаются только тем, что one() устанавливает разовый обработчик.


Ссылки

Поисковые ключи:
  • разовый обработчик событий
  • установка разового обработчика событий
  • .one()
  • one()