val()

34
посл. ред. 12.08.2016

Метод val() изменяет значение свойства value у выбранных элементов формы или возвращает значение свойства у первого элемента. Значение свойства value берётся:

  • для <input> - из атрибута value;
  • для <textarea> - содержимое тега;
  • для <select> - из атрибута value выбранной опции.

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

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

jQ_object.val() => String
Возвращает значение свойства value у первого элемента выборки. Для элемента <select> с несколькими выбранными опциями возвращается массив значений.
jQ_object.val(значение) => jQuery
Каждому элементу выборки устанавливает/изменяет значение свойства value.
jQ_object.val(функция) => jQuery
У каждого элемента выборки изменяет значение свойства value на новое, возвращённое указанной функцией. Данная функция выполняется для каждого элемента выборки отдельно.
При запуске функции первым аргументом передаётся индекс элемента в выборке. Вторым аргументом передаётся текущее значение свойства value. Ссылка на сам элемент хранится в переменной this.

Примеры

<html>
<head>
  <title>Работа с элементами DOM</title>
  <script type="text/javascript" src="js/jquery.js"></script>
</head>
<body>
  <form autocomplete="off">
    <textarea>Текст</textarea>
    <select multiple>
      <option value="1" selected>Число 1</option>
      <option value="2" selected>Число 2</option>
    </select>
  </form>
</body>
</html>
 
<script>
alert($('textarea').val()); /* Текст */
alert($('select').val()[1]); /* 2 */
</script>