prop()

посл. ред. 12.08.2016

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

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

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

jQ_object.prop(свойство) => String: Возвращает значение указанного свойства для первого элемента выборки. Если свойство отсутствует, тогда возвращается undefined.
jQ_object.prop(свойство, значение) => jQuery: Каждому элементу выборки устанавливает/изменяет значение указанного свойства. Значение свойства передаётся вторым аргументом.
jQ_object.prop({свойство1: значение1, свойство2: значение2, ...}) => jQuery: Каждому элементу выборки устанавливает/изменяет значения указанных свойств. Значения свойств передаются в виде объекта.
jQ_object.prop(свойство, функция) => 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').prop('id', 'new');
/* добавление параграфу свойства id */
alert($('p').prop('title'));
/* выводит пустую строку, а не undefined, так как свойство title существует */
</script>

Параграф