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

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

Фабричная функция jQuery

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

Document
). Имя
$
является псевдонимом для имени jQuery, поэтому во всех формах вызова, представленных ниже, вместо jQuery можно использовать
$
:

jQuery(sel [, context=document])

Возвращает новый объект jQuery, представляющий элементы документа, которые являются потомками для элемента context и соответствуют строке селектора

sel
.

jQuery(elts)

Возвращает новый объект jQuery, представляющий указанные элементы. Аргумент

elts
может быть единственным элементом документа, массивом или объектом, подобным массиву (таким как
NodeList
или другой объект jQuery), содержащим элементы документа.

jQuery(html, [props])

Выполняет синтаксический анализ строки html с разметкой HTML и возвращает новый объект jQuery, с одним или более элементами верхнего уровня, содержащимися в строке. Если аргумент html содержит единственный HTML-тег, в аргументе props можно передать объект, определяющий HTML-атрибуты и обработчики событий для вновь созданного элемента.

jQuery(f)

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

Document
. Возвращает объект jQuery, содержащий только объект
Document
.

Грамматика селекторов jQuery

Грамматика селекторов jQuery очень похожа на грамматику селекторов CSS3 и подробно описывается в разделе 19.8.1. Далее следует описание грамматики в кратком изложении:

Простые селекторы по имени тега, класса и значению атрибута id

* tagname .classname #id

Комбинированные селекторы

А В В - потомок А

А > В В - дочерний по отношению к А

А + В В - смежный, следующий за А

А ~ В В - смежный по отношению к А

Фильтры атрибутов

[attr] имеет атрибут

[attr=val] имеет атрибут со значением val

[attr!=val] не имеет атрибута со значением val

[attr~=val] значение атрибута начинается с val

[attr$=val] значение атрибута заканчивается на val

[attr*=val] значение атрибута включает val

[attr“=val] значение атрибута включает val как слово

[attг|=val] значение атрибута начинается с val и необязательного дефиса

Фильтры по типам элементов

:button :header :password :submit

:checkbox :image :radio :text

:file :input :reset

Фильтры no состоянию элементов

:animated :disabled :hidden :visible

:checked :enabled :selected

Фильтры no позиции

:eq(n) :first :last :nth(n)

:even :gt(n) :lt(n) :odd

Фильтры no позиции в документе

:first-child :nth-child(n)

:last-child :nth-child(even)

:only-child :nth-child(odd)

:nth-child(xn+y)

Прочие фильтры

:contains(text) :not(selector)

:empty :parent

:has(selector)

Базовые свойства и методы объекта jQuery

Ниже перечислены базовые свойства и методы объектов jQuery. Они не влияют на выбор или на выбранные элементы, но позволяют обращаться к выбранным элементам и выполнять итерации по ним. Дополнительные сведения приводятся в разделе 19.1.2.