<meta>: Элемент метаданных

Базовая Широко доступная

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Элемент <meta> HTML представляет метаданные, которые нельзя представить с помощью других элементов HTML, относящихся к метаданным, таких как <base>, <link>, <script>, <style> или <title>.

Тип метаданных, предоставляемых элементом <meta> может быть следующим:

Если установлен атрибут name, элемент <meta> предоставляет метаданные уровня документа, применяемые ко всей странице.
Если установлен атрибут http-equiv, элемент <meta> является директивой прагмы, предоставляя информацию, эквивалентную информации, которую можно получить с помощью HTTP-заголовка с аналогичным названием.
Если установлен атрибут charset, элемент <meta> — это объявление кодировки символов, задающее кодировку символов, в которой закодирован документ.
Если установлен атрибут itemprop, элемент <meta> предоставляет метаданные, определенные пользователем.

Атрибуты

Этот элемент включает глобальные атрибуты.

Примечание: Атрибут name имеет специальное значение для элемента <meta> , а атрибут itemprop не должен быть установлен на том же элементе <meta> , у которого уже есть атрибуты name, http-equiv или charset.

charset

Этот атрибут объявляет кодировку символов документа. Если атрибут присутствует, его значение должно быть ASCII-строкой, нечувствительной к регистру, соответствующей строке "utf-8", поскольку UTF-8 является единственной допустимой кодировкой для документов HTML5. Элементы <meta> , которые объявляют кодировку символов, должны располагаться полностью в первых 1024 байтах документа.

content

Этот атрибут содержит значение для атрибута http-equiv или name, в зависимости от используемого.

http-equiv

Определяет директиву прагмы. Атрибут назван http-equiv(alent) , потому что все разрешенные значения являются именами определенных HTTP-заголовков:

content-security-policy Позволяет авторам страниц определять политику содержимого для текущей страницы. Политики содержимого в основном определяют разрешенные источники сервера и конечные точки сценариев, что помогает защититься от межсайтовых сценариев.
content-type Объявляет тип MIME и кодировку символов документа. Атрибут content должен иметь значение "text/html; charset=utf-8" , если указан. Это эквивалентно элементу <meta> с заданным атрибутом charset и имеет те же ограничения относительно размещения в документе. Примечание: Может использоваться только в документах, сервер которых использует тип MIME text/html — не в документах, сервер которых использует тип MIME XML.
default-style Устанавливает имя набора стандартных CSS-стилей.
x-ua-compatible Если указано, атрибут content должен иметь значение "IE=edge". Пользовательские агенты обязаны игнорировать эту прагму.
refresh Эта инструкция задает:
- Количество секунд до перезагрузки страницы — только если атрибут content содержит целое положительное число.
- Количество секунд до перенаправления страницы на другую — только если атрибут content содержит целое положительное число, за которым следует строка ';url=', и действительный URL.
Таймер запускается, когда страница полностью загружена, то есть после того, как оба события load и pageshow произошли.
Предупреждение:

Страницы, заданные с помощью значения refresh , рискуют иметь слишком короткий интервал времени. Пользователи, которые пользуются вспомогательными технологиями, такими как экранные читалки, могут не успеть прочитать и понять содержимое страницы перед автоматическим перенаправлением. Резкое, неожиданное обновление содержимого страницы также может быть дезориентирующим для людей с нарушениями зрения.

name

Атрибуты name и content могут использоваться вместе для предоставления метаданных документа в виде пар имя-значение, где атрибут name задаёт имя метаданных, а атрибут content задаёт значение.

См. стандартные имена метаданных для получения подробностей о наборе стандартных имён метаданных, определённых в спецификации HTML.

Примеры

html

<meta charset="utf-8" />

<!-- Redirect page after 3 seconds -->
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

Техническое резюме

Категории содержимого	Метаданные. Если присутствует атрибут `itemprop`: потоковое содержимое, фразовое содержимое.
Разрешенное содержимое	Нет; это пустой элемент.
Пропуск тега	Должен иметь начальный тег и не должен иметь конечный тег.
Разрешенные родительские элементы	`<meta charset>`, `<meta http-equiv>`: элемент `<head>`. Если `http-equiv` не является объявлением кодировки, он также может находиться внутри элемента `<noscript>`, который сам находится внутри элемента `<head>`. `<meta name>`: любой элемент, который принимает метаданные. `<meta itemprop>`: любой элемент, который принимает метаданные или потоковое содержимое.
Неявная роль ARIA	Нет соответствующей роли
Разрешенные роли ARIA	Нет `role` разрешенных ролей
Интерфейс DOM	`HTMLMetaElement`

Спецификации

Спецификация
Стандарт HTML # the-meta-element

Совместимость браузеров

	Рабочий стол					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`meta`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`charset`	1	12	1	15	3	18	4	14	2	1.0	4.4
`content`	1	12	1	≤12.1	≤4	18	4	≤12.1	≤3.2	1.0	4.4
`http-equiv`	1	12	1	≤12.1	≤4	18	4	≤12.1	≤3.2	1.0	4.4
`name`	1	12	1	≤12.1	≤4	18	4	≤12.1	≤3.2	1.0	4.4
`scheme`	1	12	1	≤12.1	≤4	18	4	≤12.1	≤3.2	1.0	4.4

См. также

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta