Обработчик или источник события mouseup

Материал из JQuery

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

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

.mouseup(handler(eventObject)):jQuery1.0

Устанавливает функцию handler в качестве обработчика события mouseup, на выбранные элементы.
Метод является аналогом bind("mouseup", handler(eventObject)).

handler(eventObject) — функция, которая будет установлена в качестве обработчика. При вызове она будет получать объект события eventObject.

.mouseup(eventData, handler(eventObject)):jQuery1.4.3

Метод отличается от предыдущего возможностью передавать в обработчик дополнительные данные.
Является аналогом bind("mouseup", eventData, handler(eventObject)).

handler(eventObject) — см. выше.
eventData — дополнительные данные, передаваемые в обработчик. Они должны быть представлены объектом в формате: {fName1:value1, fName2:value2, ...}.

.mouseup():jQuery1.0

Вызывает событие mouseup, у выбранных элементов страницы. Метод является аналогом trigger("mouseup").

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

Все три варианта использования метода, являются аналогами других методов (см. выше), поэтому все подробности использования mouseup(), можно найти в описании этих методов.

Событие mouseup происходит когда отпущена любая из стандартных клавиш мыши. Чтобы узнать какая именно клавиша была отпущена, в обработчике события можно посмотреть значение переменной eventObject.which, которое будет содержать число с номером клавиши (1-левая, 2-средняя (скролл, причем именно нажат, а не прокручен), 3-правая кнопка мыши).

Для того чтобы узнать координаты в которых произошло событие, можно воспользоваться переменными eventObject.pageX, eventObject.pageY которые хранят координаты курсора относительно начала страницы.

Пример

// установим обработчик события mouseup, элементу с идентификатором foo
$('#foo').mouseup(function(eventObject){
  alert('Вы отпустили кнопку мыши. Код отпущенной клавиши - ' + eventObject.which);
});
 
// вызовем событие mouseup на элементе foo
$('#foo').mouseup();
 
// установим еще один обработчик события mouseup, на этот раз элементам 
// с классом block. В обработчик передадим дополнительные данные
$('.block').mousedown({a:12, b:"abc"}, function(eventObject){
  var externalData = "a=" + eventObject.data.a + ", b=" + eventObject.data.b;
  alert('Вы отпустили кнопку мыши. '+
        'В обработчик этого события переданы данные: ' + externalData );
});

Ссылки

Поисковые ключи:
  • обработка события mouseup
  • поднятие кнопки мыши
  • обработка поднятия кнопки мыши
  • обработчик события mouseup
  • .mouseup()
  • mouseup()