Руководство jQuery - triggerHandler(event , data )

Опубликовано admin - вт, 05/01/2018 - 23:40

[Функция] triggerHandler(event, data)

Раздел "Events"

Специфичный метод, запускающий все связанные обработчики событий с элементами (для особого типа события) БЕЗ выполнения действий браузера по умолчанию и без всплывания событий.

Параметры

triggerHandler(event, data)

1.0

type: инициируемый тип события

data: дополниетльные данные, передаваемые в качестве аргументов (после события объекта) к обработчику

Описание

Данная функция ведёт себя подобно функции trigger(), с двумя важными исключениями: Во первых действия браузера, исполняемые по умолчанию, не запускаются. Во-вторых, событие запускается только для первого элемента в jQuery коллекции. Этот метод возвращает обратную переменную запущенного обработчика, взамен объекта jQuery. Также, если jQuery коллекция пуста, данная функция вернёт 'undefined'.

Примеры

Пример:

Если вы вызовете .triggerHandler() для события focus как действия браузера по умолчанию, оно не произойдёт, только обработчик событий, связанный с событием focus запускается.

Пример
Весь код

"jQuery"

    $("#old").click(function(){
      $("input").trigger("focus");
    });
    $("#new").click(function(){
      $("input").triggerHandler("focus");
    });
    $("input").focus(function(){
      $("<span>Focused!</span>").appendTo("body").fadeOut(1000);
    });

"HTML"

<button id="old">.trigger("focus")</button>
  <button id="new">.triggerHandler("focus")</button><br/><br/>
  <input type="text" value="To Be Focused"/>

"Живой пример jQuery"

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
						"http://www.w3.org/TR/html4/loose.dtd">
	<html>
	<head>
	<link href="http://test-drupal.ru/themes/slyweb/css/jqueryiframe.css" 
	rel="stylesheet" type="text/css"/>
	  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.5.0/jquery.min.js"></script>
	<script>
	  $(document).ready(function(){
	
    $("#old").click(function(){
      $("input").trigger("focus");
    });
    $("#new").click(function(){
      $("input").triggerHandler("focus");
    });
    $("input").focus(function(){
      $("<span>Focused!</span>").appendTo("body").fadeOut(1000);
    });

	  });
	</script>

	</head>
	<body class="iframe">

	
<button id="old">.trigger("focus")</button>
  <button id="new">.triggerHandler("focus")</button><br/><br/>
  <input type="text" value="To Be Focused"/>


	</body>
	</html>

Метод появился в jQuery 1.0 (http://api.jquery.com/triggerHandler/)

Версия jQuery 1.4.2 Документ создан 2010-08-21

Руководство по jQuery!

Плагины jQuery UI

Эффекты