JavaScript. Подробное руководство, 6-е издание
вернуться

Флэнаган Дэвид
Шрифт:

bind(type, [data], f(event))

bind(events)

Регистрирует f как обработчик событий типа type в каждом выбранном элементе. Если указан аргумент data, он будет добавлен в объект события перед вызовом f. Аргумент type может определять несколько типов событий и может включать пространства имен.

Если методу передан единственный объект, он интерпретирует его как отображение типов событий в функции-обработчики и регистрирует обработчики для всех указанных типов событий в каждом выбранном элементе.

delegate(sel, type, [data], f(event))

Регистрирует f как динамический обработчик события. Функция f будет вызываться для обработки событий типа type, возникающих в элементах, которые определяются селектором sel и всплывших до любого из выбранных элементов. Если указан аргумент data, он будет добавлен в объект события перед вызовом f.

die(type, [f(event)])

Отключает динамические обработчики, зарегистрированные методом

live,
событий типа type из элементов, соответствующих селектору, использовавшемуся для создания текущего множества выбранных элементов. Если указана конкретная функция-обработчик f, отключает только ее.

hover(f(event))

hover (enter (event), leave(event))

Регистрирует обработчики событий «mouseenter» и «mouseleave» во всех выбранных элементах. Если указана только одна функция, она будет использована как обработчик обоих событий.

live(type, [data], f(event))

Регистрирует f как динамический обработчик события типа type. Если указан аргумент data, он будет добавлен в объект события перед вызовом f. Этот метод не используется для установки обработчиков в выбранные элементы, но он использует строку селектора и контекст данного объекта jQuery. Функция f будет вызываться, когда события типа type будут всплывать до объекта контекста (обычно объект

Document
), если целевые элементы события будут соответствовать селектору. См. также
delegate.

one(type, [data], f(event))

one(events)

Действует подобно методу

bind,
но зарегистрированные обработчики событий автоматически отключаются после однократного вызова.

ready(f)

Регистрирует функцию f, которая должна быть вызвана, когда документ будет готов к выполнению операций над ним, или вызывает ее немедленно, если документ уже готов. Этот метод не использует выбранные элементы и является синонимом для

$(f)
.

toggle(f1(event), f2(event),...)

Регистрирует обработчик события «click» во всех выбранных элементах, который циклически переключается между указанными функциями-обработчиками.

trigger(type, [params])

trigger(event)

Генерирует событие type во всех выбранных элементах, передавая params обработчикам событий в виде дополнительных параметров. Аргумент params можно опустить или передать в нем единственное значение или массив значений. Если передать методу объект события event, его свойство type будет определять тип события, а все остальные свойства будут скопированы в объект события, который будет передан обработчикам.

triggerHandler(type, [params])

Действует подобно методу

trigger,
но не позволяет всплывать сгенерированному событию или вызывать действия, предусмотренные броузером по умолчанию.

unbind([type],[f(event)])

При вызове без аргументов отключает все обработчики событий, зарегистрированные средствами библиотеки jQuery во всех выбранных элементах. При вызове с одним аргументом отключает все обработчики событий типа type во всех выбранных элементах. При вызове с двумя аргументами отключает функцию f, зарегистрированную как обработчик событий type во всех выбранных элементах. Аргумент type может представлять несколько типов событий и может включать пространства имен.

undelegate

undelegate(sel, type, [f(event)])

При вызове без аргументов отключает все динамические обработчики событий во всех выбранных элементах. При вызове с двумя аргументами отключает динамические обработчики событий типа type в элементах, соответствующих селектору sel, которые возникают в выбранных элементах. При вызове с тремя аргументами отключает только обработчик f.

Методы jQuery воспроизведения визуальных и анимационных эффектов

Методы, описываемые ниже, воспроизводят визуальные и нестандартные анимационные эффекты. Большинство из них возвращают тот же объект jQuery, относительно которого они вызывались. Дополнительные сведения приводятся в разделе 19.5.

Параметры анимационных эффектов

complete duration easing queue specialEasing step

jQuery.fx.off

Установите это свойство в значение true, чтобы запретить все визуальные и анимационные эффекты.