Получает или устанавливает значение(я) атрибута(ов) элементов набора jQuery в зависимости от заданного(ых) параметра(ов).

Варианты работы функции attr() в зависимости от переданных ей параметров:

1.attr ( name ) - получает значение атрибута...

2. attr ( name, value ) - устанавливает значение атрибута...

3. attr ( object ) - устанавливает значение атрибута...

4. attr ( name, function() ) - устанавливает значение атрибута...

* * *

Синтаксис и описание:

· Добавлено в jQuery 1.0

· .attr( name )

· Метод attr(name) получает значение заданного атрибута соответствующего элемента набора jQuery, либо первого элемента в наборе jQuery (если их несколько). Возвращает значение undefined, если у элемента указанный атрибут отсутствует или в наборе нет элементов.

Возвращаемое значение: (строка) Значение искомого атрибута или undefined.

Параметры:

· name – (строка) Имя атрибута, значение которого необходимо получить.

1. Примечание:

Чтобы получить значения атрибутов для каждого элемента в наборе jQuery, можно использовать методы .each() или .map().

2. Примечание:

Можно использовать собственные нестандартные имена атрибутов.

3. Примечание:

Библиотека jQuery предоставляет дополнительные нормализованные имена атрибутов для кроссбраузерной работы команды .attr(): class (от ClassName), float, cssFloat, styleFloat, for (от HtmlFor), maxlength, readonly.

4. Примечание:

Удалить атрибут средствами jQuery можно с помощью функции .removeAttr().

Примеры:
1. // Получить значение атрибута alt первого изображения на странице2. // и, используя его, установить значение атрибута title.3. 4. var title = $("img").attr("alt") + " -> Увеличить";5. $("img:first").attr("title", title);6. // Сохранить в массив значения атрибутов id 7. // всех элементов <div> в документе.8. 9. var arr = new Array();10.$("div").each(function(){11. arr[] = $(this).attr("id");12.});
* * *

· Добавлено в jQuery 1.0.attr( name, value )

· Метод attr(name, value) присваивает атрибуту name значение value для всех элементов набора jQuery.

Возвращаемое значение: (объект) Набор jQuery.

Параметры:

· name – (строка) Имя атрибута, которому необходимо присвоить значение.

· value – (строка | массив) Значение присваиваемое атрибуту или выражение JavaScript, вычисленное значение которого (возможно даже массив) присваивается атрибуту.

1. Примечание:

Можно использовать собственные нестандартные имена атрибутов.

2. Примечание:

Библиотека jQuery предоставляет дополнительные нормализованные имена атрибутов для кроссбраузерной работы команды .attr(): class (от ClassName), float, cssFloat, styleFloat, for (от HtmlFor), maxlength, readonly.

3. Примечание:

Браузер IE (Internet Explorer) не позволяет изменять значение атрибута name элементов<input>. Кроссбраузерное решение – замена всего элемента <input> на новый с требуемым именем name.

4. Примечание:

Удалить атрибут средствами jQuery можно с помощью функции .removeAttr().

Примеры:
1. // Добавить атрибуты alt и title первому изображению.2. 3. $("img:first").attr("alt", "Первое изображение")4. .attr("title", "Первое изображение -> Увеличить");
[ наверх ]

* * *

· Добавлено в jQuery 1.0

· .attr( object )

· Метод attr(object) устанавливает значения атрибутов, полученные в виде парключ:'значение' объекта object :

{'attributeName1': 'value1', 'attributeName2': 'value2',…, 'attributeNameN': 'valueN'},