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

Флэнаган Дэвид

text:string

text (plaintext)

text (f(idx, current): plainText)

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

unwrap

Удаляет родителя каждого выбранного элемента, замещая его выбранным элементом

и смежными с ним элементами.

wrap (wrapper)

wrap(f(idx):wrapper)

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

wrapAll(wrapper)

Обертывает все выбранные элементы как группу, вставляя обертку wrapper в позицию первого выбранного элемента и затем копируя все выбранные элементы в элемент-обертку wrapper.

wraplnner(wrapper)

wraplnner(f(idx):wrapper)

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

wrap,

но обертывает элементом wrapper (или возвращаемым значением функции f) содержимое каждого выбранного элемента, а не сами элементы.

Методы jQuery для работы с событиями

Методы в этом разделе используются для регистрации обработчиков событий и для возбуждения событий. Дополнительные сведения приводятся в разделе 19.4.

event-type

event-type(f(event))

Регистрирует f как обработчик события типа event-type или генерирует событие event-type. Библиотека jQuery определяет следующие методы, которые действуют согласно этому шаблону:

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 может представлять несколько типов событий и может включать пространства имен.