text()

посл. ред. 12.08.2016

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

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

jQ_object.text() => String: Возвращает текст, содержащийся в текущем элементе. Если элементов несколько, тогда весь текст объединяется в одну строку.
jQ_object.text(текст) => jQuery: Удаляет содержимое каждого элемента выборки и вставляет на это место указанный текст. Если в качестве текста передать HTML-код, то новые элементы созданы не будут, так как все специальные символы будут экранированы. Для вставки HTML-кода необходимо использовать метод html().
jQ_object.text(функция) => jQuery: Заменяет содержимое каждого элемента выборки на текст, возвращённый указанной функцией. Данная функция выполняется для каждого элемента выборки отдельно.
При запуске функции первым аргументом передаётся индекс элемента в выборке. Вторым аргументом передаётся текущее текстовое содержимое элемента. Ссылка на сам элемент хранится в переменной this.

Примеры

<html>
<head>
  <title>Работа с элементами DOM</title>
  <script type="text/javascript" src="js/jquery.js"></script>
</head>
<body>
  <p>Параграф <b>1</b></p>
  <p><a href="par2">Параграф <b>2</b></a></p>
</body>
</html>
 
<script>
$('p')
/* выбор всех параграфов */
  .text(function (index, content) {
    return content;
  });
/* редактирование всех параграфов */
</script>

Параграф 1

Параграф 2

<html>
<head>
  <title>Работа с элементами DOM</title>
  <script type="text/javascript" src="js/jquery.js"></script>
</head>
<body>
  <p>Параграф 1</p>
  <p>Параграф 2</p>
  <p>Параграф 3</p>
</body>
</html>
 
<script>
alert($('p').text());
/* выводит текст всех параграфов */
</script>