Чтение онлайн

ЖАНРЫ

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

void select

Выделяет весь текст, отображаемый в элементе

Input
. Во многих броузерах это означает, что при вводе очередного символа выделенный текст будет удален и замещен введенным символом.

void setSelectionRange(unsigned long start, unsigned long end)

Этот метод выделяет текст, отображаемый в элементе Input, начиная с символа в позиции start и до (не включая) символа в позиции end.

void stepDown([long n])*

Для элементов, поддерживающих свойство step, уменьшает текущее значение на n шагов.

void stepUp([long n])*

Для

элементов, поддерживающих свойство step, увеличивает текущее значение на n шагов.

jQuery jQuery 1.4

библиотека jQuery

Описание

Это краткий справочник по библиотеке jQuery. Более полное описание библиотеки и примеры ее использования приводятся в главе 19. Эта справочная статья организована несколько иначе, чем все остальные. При оформлении сигнатур методов здесь использовались следующие соглашения. Аргументы с именем sel являются селекторами библиотеки jQuery. Аргументы с именем idx являются целочисленными индексами. Аргументы с именем elt или elts являются элементами документа или объектами, подобными массивам, содержащими элементы документа. Аргументы с именем f являются функциями обратного вызова, а вложенные круглые скобки используются, чтобы показать аргументы, которые передаются библиотекой jQuery при вызове этой функции. Квадратные скобки указывают на необязательные аргументы. Если за именем необязательного аргумента следует знак «равно» и значение, это означает, что указанное значение используется по умолчанию, если аргумент был опущен. Вслед за закрывающей круглой скобкой и двоеточием следует значение, возвращаемое функцией или методом. Если возвращаемое значение не указано, это означает, что метод возвращает объект jQuery, относительно которого он был вызван.

Фабричная функция 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.

context

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

$
или объект
Document.

each(f(idx,elt))

Вызывает f как метод для каждого выбранного элемента. Останавливает итерации, как только функция вернет false. Возвращает объект jQuery, относительно которого был вызван данный метод.

get(icfx):elt

Поделиться с друзьями: