Тег output (от английского output, «вывод») показывает результат вычисления или действия пользователя. Он относится к элементам формы и по умолчанию имеет роль status, поэтому программа чтения может сообщить об изменении результата. Само вычисление выполняет скрипт: тег только хранит и показывает значение. Закрывающий </output> обязателен.
Поля для ввода создаёт тег input внутри тега form, а надпись к результату можно задать через тег label. В данные формы результат не попадает.
<form>
<input id="a" type="number" value="2">
+
<input id="b" type="number" value="3">
=
<output for="a b">5</output>
</form>
В этой статье
- Тег output в HTML: что это и для чего нужен
- Атрибут for: откуда взято значение
- Значение output: value, textContent и defaultValue
- Output и отправка формы: name, elements и form
- Label для output
- Что записывают внутри output
- Состояния output: disabled и проверка
- Тег output и JavaScript: oninput и value
- Доступность output: роль status
- Атрибуты тега output
- Вопросы про тег output: readonly и отправка
- Частые ошибки с тегом output
Тег output в HTML: что это и для чего нужен
Типичные случаи: калькулятор, сумма заказа, значение ползунка, итог теста. Вычисленный display у output равен inline, то есть он встраивается в строку, как span. Без скрипта значение не меняется: тег не следит за полями и не пересчитывает результат сам.
<form oninput="total.value = Number(a.value) + Number(b.value)">
<input id="a" type="number" value="2">
<input id="b" type="number" value="3">
<output id="total">5</output>
</form>
Пример: output без скрипта и с пересчётом
Выберите запись: под результатом значение output.
Атрибут for: откуда взято значение
Атрибут for перечисляет через пробел id полей, из которых получен результат. Это только объявление связи: при вводе в поле output сам не меняется. Свойство htmlFor возвращает те же id списком (DOMTokenList), а изменения списка и атрибута видны друг в друге. Проверка HTML не требует, чтобы такие id существовали.
<output id="o" for="a b">5</output>
Пример: for и htmlFor
Выберите запись: под результатом список htmlFor и пояснение.
Значение output: value, textContent и defaultValue
Свойство value совпадает с текстом внутри output, а defaultValue хранит начальный текст. Пока value не присвоено, правка textContent меняет и defaultValue. После присваивания value правка текста меняет только значение. Сброс формы через reset возвращает defaultValue.
const output = document.querySelector("output");
output.value = "9";
form.reset();
console.log(output.value);
Пример: value, textContent и defaultValue
Выберите запись: под результатом три значения output.
Output и отправка формы: name, elements и form
В данные формы output не попадает: ни в FormData, ни в параметры адреса при отправке GET. Зато он входит в form.elements, учитывается в length и доступен как form.result. Атрибут form привязывает output, записанный вне формы. Если результат нужен на сервере, его дублируют в скрытое поле.
<form id="order">
<input name="qty" type="number" value="2">
</form>
<output name="total" form="order">5</output>
Пример: output и данные формы
Выберите запись: под результатом данные и элементы формы.
Label для output
Надпись к результату задают тем же label, что и к полю. Это работает и с атрибутом for, и когда output находится внутри label: свойство labels возвращает надпись, а label.control указывает на output.
<label for="total">Сумма</label>
<output id="total">5</output>
Пример: label для output
Выберите запись: под результатом связь надписи с output.
Что записывают внутри output
Внутри output допустимы текст и строчные теги. Присвоение value заменяет всё содержимое одним текстом, и вложенные теги пропадают. Блочный div внутри проверка HTML считает ошибкой.
<output>Итого <b>5</b> <span>руб.</span></output>
Пример: что допустимо внутри output
Выберите запись: под результатом число дочерних тегов и значение.
Состояния output: disabled и проверка
Атрибута disabled у output нет, и группа, которую создаёт тег fieldset, с disabled его не отключает: :disabled остаётся false. В проверке формы он не участвует: willValidate равен false, а checkValidity() всегда даёт true.
<fieldset disabled>
<input name="a">
<output name="r">5</output>
</fieldset>
Пример: disabled и проверка
Выберите запись: под результатом состояние output.
Тег output и JavaScript: oninput и value
Событие input формы срабатывает при вводе в любое поле, поэтому одного обработчика oninput на форму хватает. Элемент находят через form.elements.result. Числа берут через valueAsNumber, а результат записывают в value: число превращается в строку, а дробные значения округляют через toFixed.
form.oninput = () => {
output.value = a.valueAsNumber + b.valueAsNumber;
};
Пример: oninput, toFixed и число в value
Выберите запись: под результатом ответ скрипта.
Доступность output: роль status
У output роль status, поэтому программа чтения может сообщать об изменении текста без перехода фокуса. Атрибут aria-live роль не убирает, а role="none" убирает: результат читается как простой текст. Содержимое output лучше делать простым текстом. Явный role="status" проверка HTML считает лишним.
<label for="total">Сумма</label>
<output id="total">5</output>
Пример: роль output
Выберите запись: под результатом роль для программы чтения с экрана.
Атрибуты тега output
У output три собственных атрибута: for, form и name. Остальные глобальные. Часть атрибутов знакома по полям формы, но у output они не допускаются.
| Атрибут | Статус | Что делает | Пример записи |
|---|---|---|---|
for | допускается | Список id полей, из которых получен результат | for="a b" |
form | допускается | Привязка к форме по её id, в том числе вне формы | form="order" |
name | допускается | Название для form.elements, в данные не попадает | name="total" |
id | глобальный | Идентификатор, например для label | id="total" |
class | глобальный | Класс для оформления | class="result" |
title | глобальный | Всплывающая подсказка | title="Сумма" |
value | не существует | Значение задают текстом внутри или через value в скрипте | value="5" |
type | не существует | Тип не задают | type="text" |
disabled | не существует | Отключить output нельзя | disabled |
readonly | не существует | Результат и так нельзя править | readonly |
Вопросы про тег output: readonly и отправка
Результат вычисления часто путают с полем только для чтения и пытаются отправить вместе с формой.
Чем output отличается от input с readonly?
Поле readonly отправляется вместе с формой и выглядит как поле ввода, а output не отправляется и имеет роль status. Для результата, который нужен только на экране, подходит output.
<input name="r" value="5" readonly>
<output name="r">5</output>
Пример: output и поле readonly
Выберите запись: под результатом данные формы и проверка.
Как отправить результат output на сервер?
Значение дублируют в скрытое поле input type="hidden" с нужным именем в name и обновляют их вместе. Само output может быть без name.
<output id="o">5</output>
<input type="hidden" name="r" id="h" value="5">
Пример: output и скрытое поле
Выберите запись: под результатом данные формы.
Частые ошибки с тегом output
Ошибки с output чаще всего связаны с ожиданиями: тег показывает значение, но не вычисляет и не отправляет его.
| Ошибка | Что происходит | Как исправить |
|---|---|---|
Расчёт на то, что for запустит пересчёт | Атрибут только объявляет связь, при вводе значение не меняется | Обновлять value скриптом |
Расчёт на то, что output уйдёт на сервер | В FormData и в параметрах адреса его нет | Дублировать значение в скрытое поле |
value, type, disabled или readonly у output | Атрибуты не допускаются, проверка HTML сообщает об ошибке | Убрать, значение писать внутри тега |
Присваивать value, когда внутри теги | Теги заменяются одним текстом | Писать результат в вложенный span |
div внутри output | Проверка HTML сообщает об ошибке | Использовать текст или span |
| Выводить дробный результат без округления | В значении остаётся длинный хвост цифр | Округлять через toFixed |
Расчёт на то, что fieldset disabled отключит output | Он остаётся доступным, :disabled равен false | Менять вид результата стилями |
form у output указывает не на форму | Проверка HTML сообщает об ошибке, привязки нет | Указать id формы |
Выводить результат в div вместо output | У div нет роли status, программа чтения изменение не объявит | Использовать output |