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

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

• Вместо того чтобы определять парные методы, библиотека jQuery использует одни и те же методы как для чтения, так и для записи. Если передать методу новое значение, он запишет это значение. Если новое значение не указано, метод вернет текущее значение.

• При использовании методов для записи они записывают новое значение во все элементы, находящиеся в объекте

jQuery
, и возвращают объект
jQuery
, что позволяет использовать их в цепочках вызовов методов.

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

map
.) Поскольку методы чтения не возвращают объект
jQuery
, они могут использоваться только в конце цепочек вызовов методов.

• При использовании методов для записи они часто могут принимать объекты в виде аргументов. В этом случае каждое свойство указанного объекта будет определять имя и устанавливаемое значение.

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

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

jQuery
.

19.2.1. Чтение и запись значений HTML-атрибутов

Метод

attr
объекта
jQuery
– это метод чтения/записи значений HTML-атрибутов, и к нему относятся все обобщения, описанные выше. Метод
attг
предусматривает решение проблемы несовместимости броузеров и обработку специальных случаев и позволяет использовать имена HTML-атрибутов или имена эквивалентных им свойств в языке JavaScript (где они отличаются). Например, можно использовать имя «for» или «htmlFor», «class» или «className».
removeAttr
– это родственная функция, которая полностью удаляет атрибут из всех выбранных элементов. Ниже приводятся несколько примеров использования этих методов:,

$("form").attr("action"); // Получить атрибут action 1-й формы

$("#icon").attr("src", "icon.gif"); // Установить атрибут sre

$("#banner").attr({src:"banner.gif", alt:"Advertisement", // Установить сразу 4 атрибута

width:720, height:64});

$("a").attr("target", "_blank"); // Все ссылки загружать в новых окнах

S("a").attr("target", function { // Локальные ссылки загружать локально

if (this.host == location.host) return "_self"

else return ”_blank"; // Внешние ссылки загружать в новых окнах

});

S("a").attr((target: function {...}}); // Можно также передать функцию

$("а"). removeAttr("target"); // Все ссылки загружать в этом окне

19.2.2. Чтение и запись значений CSS-атрибутов

Метод

css
напоминает метод
attr,
но работает не с HTML-атрибутами, а со стилями CSS элемента. При чтении значений стилей метод
css
возвращает текущий (или «вычисленный»; раздел 16.4) стиль элемента: возвращаемое значение может быть определено в атрибуте
style
или в таблице стилей. Обратите внимание, что нельзя получить значения составных стилей, таких как «font» или «margin». Вместо этого следует запрашивать отдельные стили, такие как «font-weight», «font-family», «margin-top» или «margin-left». При записи значений стилей метод
css
просто добавляет их в атрибут style элемента. Метод
css
позволяет указывать имена стилей CSS с дефисами («background-color») или имена свойств в языке JavaScript с переменным регистром символов («backgroundColor»). При чтении значений стилей метод
css
возвращает числовые значения в виде строк с добавлением единиц измерения в конце. Однако при записи он преобразует числа в строки и добавляет суффикс «рх» (pixels - пикселы), если это необходимо:

$("h1").css("font-weight"); // Насыщенность шрифта первого элемента <h1>

$("hi").css("fontWeight"); // Допускается использовать имена свойств

$(”h1").css("font"); // Ошибка: нельзя запрашивать составные стили

$("h1").css("font-variant", "smallcaps”); // Установить стиль всех элементов <h1>

SC’div.note").css("border", "solid black 2px"); // Составные стили можно устанавливать