Тег output в HTML: что это, for и значение

Тег output (от английского output, «вывод») показывает результат вычисления или действия пользователя. Он относится к элементам формы и по умолчанию имеет роль status, поэтому программа чтения может сообщить об изменении результата. Само вычисление выполняет скрипт: тег только хранит и показывает значение. Закрывающий </output> обязателен.

Поля для ввода создаёт тег input внутри тега form, а надпись к результату можно задать через тег label. В данные формы результат не попадает.

HTML
<form>
  <input id="a" type="number" value="2">
  +
  <input id="b" type="number" value="3">
  =
  <output for="a b">5</output>
</form>

Тег output в HTML: что это и для чего нужен

Типичные случаи: калькулятор, сумма заказа, значение ползунка, итог теста. Вычисленный display у output равен inline, то есть он встраивается в строку, как span. Без скрипта значение не меняется: тег не следит за полями и не пересчитывает результат сам.

HTML
<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 существовали.

HTML
<output id="o" for="a b">5</output>

Пример: for и htmlFor

Результат

Выберите запись: под результатом список htmlFor и пояснение.

Значение output: value, textContent и defaultValue

Свойство value совпадает с текстом внутри output, а defaultValue хранит начальный текст. Пока value не присвоено, правка textContent меняет и defaultValue. После присваивания value правка текста меняет только значение. Сброс формы через reset возвращает defaultValue.

JavaScript
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, записанный вне формы. Если результат нужен на сервере, его дублируют в скрытое поле.

HTML
<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.

HTML
<label for="total">Сумма</label>
<output id="total">5</output>

Пример: label для output

Результат

Выберите запись: под результатом связь надписи с output.

Что записывают внутри output

Внутри output допустимы текст и строчные теги. Присвоение value заменяет всё содержимое одним текстом, и вложенные теги пропадают. Блочный div внутри проверка HTML считает ошибкой.

HTML
<output>Итого <b>5</b> <span>руб.</span></output>

Пример: что допустимо внутри output

Результат

Выберите запись: под результатом число дочерних тегов и значение.

Состояния output: disabled и проверка

Атрибута disabled у output нет, и группа, которую создаёт тег fieldset, с disabled его не отключает: :disabled остаётся false. В проверке формы он не участвует: willValidate равен false, а checkValidity() всегда даёт true.

HTML
<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.

JavaScript
form.oninput = () => {
  output.value = a.valueAsNumber + b.valueAsNumber;
};

Пример: oninput, toFixed и число в value

Результат

Выберите запись: под результатом ответ скрипта.

Доступность output: роль status

У output роль status, поэтому программа чтения может сообщать об изменении текста без перехода фокуса. Атрибут aria-live роль не убирает, а role="none" убирает: результат читается как простой текст. Содержимое output лучше делать простым текстом. Явный role="status" проверка HTML считает лишним.

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глобальныйИдентификатор, например для labelid="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.

HTML
<input name="r" value="5" readonly>
<output name="r">5</output>

Пример: output и поле readonly

Результат

Выберите запись: под результатом данные формы и проверка.

Как отправить результат output на сервер?

Значение дублируют в скрытое поле input type="hidden" с нужным именем в name и обновляют их вместе. Само output может быть без name.

HTML
<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
Категория
Поделиться в социальных сетях
Основные HTML-теги
Семантические теги HTML
Заголовки и абзацы
Теги для форматирования текста
Тег гиперссылки HTML
HTML-теги таблицы
Списки в HTML
Теги для форм
Мультимедиа и изображения
Интерактивные и служебные теги
Устаревшие HTML-теги

Отправить комментарий

0 Комментарии

Отправить комментарий (0)

#buttons=(Хорошо) #days=(20)

Мы используем файлы cookie для улучшения работы сайта. Подробнее
Хорошо
×