Spec-Zone.ru › jQuery

событие mousedown

Привяжите обработчик событий к событию "mousedown" или сгенерируйте это событие на элементе.

Содержание:

  • .on( "mousedown" [, eventData ], handler )
    • .on( "mousedown" [, eventData ], handler )
  • .trigger( "mousedown" )
    • .trigger( "mousedown" )

.on( "mousedown" [, eventData ], handler )Возвращает: jQuery

Описание: Привязывает обработчик событий к событию "mousedown".

  • версия добавлена: 1.7.on( "mousedown" [, eventData ], handler )

    • "mousedown"
      Тип: строка
      Строка "mousedown".
    • eventData
      Тип: Любой тип
      Объект, содержащий данные, которые будут переданы обработчику событий.
    • handler
      Тип: Функция( Событие eventObject )
      Функция, которая выполняется каждый раз при срабатывании события.

Эта страница описывает событие mousedown. Для устаревшего метода .mousedown(), см. .mousedown().

Событие mousedown отправляется элементу, когда указатель мыши находится над элементом и нажата кнопка мыши. Любой HTML-элемент может получить это событие.

Например, рассмотрим HTML:

<div id="target">
  Click here
</div>
<div id="other">
  Trigger the handler
</div>
Рисунок 1 - Иллюстрация отрисованного HTML

Обработчик событий может быть привязан к любому <div>.

$( "#target" ).on( "mousedown", function() {
  alert( "Handler for `mousedown` called." );
} );

Теперь, если мы нажмём на этот элемент, отобразится сообщение:

Обработчик `mousedown` вызван.

Мы также можем сгенерировать событие при щелчке на другом элементе:

$( "#other" ).on( "click", function() {
  $( "#target" ).trigger( "mousedown" );
} );

После выполнения этого кода щелчки по Сгенерировать обработчик также будут отображать сообщение.

Событие mousedown отправляется при нажатии любой кнопки мыши. Чтобы действовать только на определённые кнопки, мы можем использовать свойство объекта события which. Не все браузеры поддерживают это свойство (Internet Explorer использует вместо него `button`), но jQuery нормализует это свойство, чтобы его можно было безопасно использовать в любом браузере. Значение which будет равно 1 для левой кнопки, 2 для средней кнопки или 3 для правой кнопки.

Это событие прежде всего полезно для обеспечения того, что начата операция перетаскивания с помощью основной кнопки; если этого не сделать, могут возникнуть странные результаты, когда пользователь пытается использовать контекстное меню. Хотя средняя и правая кнопки могут быть обнаружены с помощью этих свойств, это ненадёжно. Например, в Opera и Safari щелчки правой кнопкой мыши по умолчанию не обнаруживаются.

Если пользователь щелкает по элементу, перетаскивает его и отпускает кнопку, это всё ещё считается событием mousedown. Эта последовательность действий рассматривается как «отмена» нажатия кнопки в большинстве пользовательских интерфейсов, поэтому обычно лучше использовать событие click, если не известно, что событие mousedown предпочтительнее в данной ситуации.

Пример:

Отображение текста при срабатывании событий mouseup и mousedown.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>on demo</title>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<p>Press mouse and release here.</p>
 
<script>
$( "p" )
  .on( "mouseup", function() {
    $( this ).append( "<span style='color:#f00;'>Mouse up.</span>" );
  } )
  .on( "mousedown", function() {
    $( this ).append( "<span style='color:#00f;'>Mouse down.</span>" );
  } );
</script>
 
</body>
</html>

Демо:

.trigger( "mousedown" )Возвращает: jQuery

Описание: Сгенерировать событие "mousedown" на элементе.

  • версия добавлена: 1.0.trigger( "mousedown" )

    • "mousedown"
      Тип: строка
      Строка "mousedown".

См. описание для .on( "mousedown", ... ).

© The jQuery Foundation and other contributors
Licensed under the MIT License.
https://api.jquery.com/mousedown

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API