attr()

посл. ред. 12.08.2016

Метод attr() изменяет значение указанного атрибута у каждого элемента выборки или возвращает значение данного атрибута у первого элемента.

Данный метод работает только с атрибутами (связь свойств с атрибутами элементов). Для работы со свойствами элементов страницы необходимо использовать метод prop().

Варианты использования

jQ_object.attr(атрибут) => String: Возвращает значение указанного атрибута для первого элемента выборки. Если атрибут отсутствует, тогда возвращается undefined.
jQ_object.attr(атрибут, значение) => jQuery: Каждому элементу выборки устанавливает/изменяет значение указанного атрибута. Значение атрибута передаётся вторым аргументом.
jQ_object.attr({атрибут1: значение1, атрибут2: значение2, ...}) => jQuery: Каждому элементу выборки устанавливает/изменяет значения указанных атрибутов. Значения атрибутов передаются в виде объекта.
jQ_object.attr(атрибут, функция) => jQuery: У каждого элемента выборки изменяет значение указанного атрибута на новое, возвращённое указанной функцией. Данная функция выполняется для каждого элемента выборки отдельно.
При запуске функции первым аргументом передаётся индекс элемента в выборке. Вторым аргументом передаётся текущее значение данного атрибута. Ссылка на сам элемент хранится в переменной this.

Примеры

<html>
<head>
  <title>Работа с элементами DOM</title>
  <script type="text/javascript" src="js/jquery.js"></script>
  <style>
    #new {
      color: red;
    }
  </style>
</head>
<body>
  <p>Параграф</p>
</body>
</html>
 
<script>
$('p').attr('id', 'new');
/* добавление параграфу атрибута id */
alert($('p').attr('title'));
/* выводит undefined, так как атрибут title не задан */
</script>

Параграф