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

.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()