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

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

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

Методы, описываемые здесь, предназначены для чтения и записи значений HTML-атрибутов и свойств CSS-стилей элементов. Функции обратного вызова в аргументе current передается текущее значение атрибута или свойства, для которого вычисляется новое значение. Дополнительные сведения приводятся в разделе 19.2.

addClass(names)

addClass( f(idx, current): names)

Добавляет указанное

имя или имена CSS-классов в атрибут

class

каждого выбранного элемента. Или вызывает f как метод для каждого элемента для вычисления имени или имен классов, добавляемых в атрибут.

attr(name):value

attr(name, value)

attr(name, f(idx,current):value)

attr(obj)

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

css(name):value

css (name, value)

css (name, f(idx, current): value)

css (obj)

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

attr,

но возвращает или устанавливает не HTML-атрибуты, а атрибуты CSS-стиля.

data:obj

data(key): value

data(key, value)

data(obj)

При вызове без аргументов возвращает объект с данными для первого выбранного элемента. При вызове с одним строковым аргументом возвращает значение указанного свойства объекта с данными. При вызове с двумя аргументами устанавливает указанное свойство в объекте данных для всех выбранных элементов в значение value. При вызове с одним аргументом-объектом замещает им объекты с данными во всех выбранных элементах.

hasClass(name): boolean

Возвращает true, если какой-либо из выбранных элементов содержит имя класса

name

в своем атрибуте

class

.

height: int

height(h)

height(f(idx, current): int)

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

innerHeight: int

Возвращает

высоту плюс отступы для первого выбранного элемента.

innerWidth:int

Возвращает ширину плюс отступы для первого выбранного элемента.

offset:coords

offset(coords)

offset (f(idx, current): coords)

Возвращает координаты X и Y (относительно начала документа) первого выбранного элемента или перемещает все выбранные элементы в позицию с координатами coords или в позицию, вычисляемую функцией f, которая вызывается как метод для каждого выбранного элемента. Координаты определяются в виде объекта со свойствами

top

и

left

.

offsetParent: jQuery

Выбирает ближайшего позиционируемого предка для каждого выбранного элемента и возвращает результат в виде нового объекта jQuery.

outerHeight([/7?ar0jns=false]):int

Возвращает высоту плюс отступы и рамку, а также поля, если аргумент margins имеет значение true, первого выбранного элемента.

outerWidth(margins=false]):int

Возвращает ширину плюс отступы и рамку, а также поля, если аргумент margins имеет значение true, первого выбранного элемента.

position:coords

Возвращает позицию первого выбранного элемента относительно ближайшего позиционируемого предка. Возвращает объект со свойствами

top

и

left

.

removeAttr(name)

Удаляет указанный атрибут из всех выбранных элементов.

removeClass(names)

removeClass(f(idx, current): names)

Удаляет указанное имя или имена классов из атрибута

class

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

removeData([key])

Удаляет указанное свойство из объекта с данными в каждом выбраном элементе. Если имя свойства не указано, удаляется весь объект с данным целиком.

scrollLeft: int

scrollLeft(int)

Возвращает позицию горизонтальной полосы прокрутки для первого выбранного элемента или устанавливает ее для всех выбранных элементов.

scrollTop:int

scroHTop(int)

Возвращает позицию вертикальной полосы прокрутки для первого выбранного элемента или устанавливает ее для всех выбранных элементов.

toggleClass(names, [add])