HTML элемент <meta>
представляет такие метаданные, которые не могут быть представлены другими HTML-метатегами, такими как <base>
, <link>
, <script>
, <style>
или <title>
.
Категории контента | Мета данные. Если задан itemprop атрибут: flow content, phrasing content. |
---|---|
Разрешенное содержимое | Отсутствует - это пустой элемент. |
Пропуск тега | Так как это пустой элемент, то открывающий тег должен присутствовать, а закрывающий - отсутствовать. |
Разрешенные родительские элементы | <meta charset> , <meta http-equiv> : <head> элемент. Если http-equiv это не заявленная декларация, то может быть внутри элемента <noscript> или <head> . |
Разрешёные роли ARIA | Отсутствуют |
DOM интерфейс | HTMLMetaElement |
Атрибуты
Этот элемент включает в себя глобальные атрибуты.
Примечание: атрибут name
имеет особое значение для элемента <meta>
и атрибут itemprop
не должен быть задан в <meta>
элементе в котором уже определены какие-либо name
, http-equiv
или charset
атрибуты.
charset
- Этот атрибут задает кодировку символов, используемую на странице. Он должен содержать стандартное имя IANA MIME для кодировки символов. Хотя стандарт не требует определенной кодировки, он рекомендует:
- Авторам рекомендуется использовать
UTF-8
. - Не следует использовать ASCII-несовместимые кодировки, чтобы избежать угроз безопасности: браузеры, не поддерживающие их, могут интерпретировать вредоносный контент как HTML. Это относится к семейству кодировок
JIS_C6226-1983
,JIS_X0212-1990
,HZ-GB-2312
,JOHAB
иEBCDIC
.
Примечание: ASCII-несовместимые кодировки - это те, которые не преобразуют 8-битные коды точек
0x20
,0x7E
,0x0020
,0x007E
в коды Unicode точек.- Авторы не должны использовать
CESU-8
,UTF-7
,BOCU-1
и/илиSCSU
, так как есть примеры атак межсайтового скриптинга использующих данные кодировки. - Авторам не следует использовать кодировку
UTF-32
, потому что не все алгоритмы кодирования HTML5 могут отличить её отUTF-16
.
Примечание:- Указанный набор символов должен соответствовать одной странице.
Нет веских оснований для объявления неточного набора символов. <meta>
элемент должен находиться внутри элемента<head>
и задаваться в 1024 первых байтах HTML страницы, поскольку некоторые браузеры смотрят только эти байты перед выбором кодировки.- Этот
<meta>
элемент - часть алгоритма, определяющего набор символов (algorithm to determine the character set) страницы, который браузер поддерживает. ЗаголовокContent-Type
и любые Byte-Order Marks элементы переопределяют данный элемент. - Настоятельно рекомендуется определить кодировку символов. Если для страницы не определён набор символов, то некоторые cross-scripting тхнологии могут повредить страницу, например такие как UTF-7 fallback cross-scripting technique. Постоянная установка этого элемента будет защищать Вас от этого риска.
- Этот
<meta>
элемент это синоним для pre-HTML5<meta http-equiv="Content-Type" content="text/html; charset=IANAcharset">
гдеIANAcharset
соответствует значению эквивалентногоcharset
атрибута.
Этот синтаксис по-прежнему разрешен, хотя и устарел и больше не рекомендуется.
- Авторам рекомендуется использовать
content
- Этот атрибут содержит значение для
http-equiv
илиname
атрибута, в зависимости от контекста. http-equiv
- Этот атрибут определяет прагму, которая может изменять поведение серверов и пользователей. Значение прагмы определяется с помощью
content
и может быть следующим:"content-language"
- Эта прагма определяет значение языка страницы по умолчанию.
Не используйте эту прагму, так как она устарела Используйте глобальный атрибут
<html>
элемента вместо этого. "Content-Security-Policy"
- Это значение позволит администратору веб-сайта определить политику содержания для обслуживаемых ресурсов. За некоторыми исключениями, политика в основном включают в себя указание происхождения сервера и конечные точки сценария. Это помогает предотвратить атаки межсайтового скриптинга.
"content-type"
- Этот атрибут определяет MIME type документа. За ним следует синтаксис такой же как и в поле заголовка объекта содержимого HTTPI, однако как и внутри HTML элемента, большинство этих значений не доступно.
Поэтому допустимым синтаксисом для его содержимого является литеральная строка 'text/html
', за которой следует набор символов со следующим синтаксисом: '; charset=
IANAcharset
' гдеIANAcharset
это предпочтительное MIME имя для набора символов, который определяется как IANA.Замечания:- Не используйте эту прагму, так как она устарела. Используйте атибут
charset
в элементе<meta>
вместо этого. <meta>
не может быть использована для выбора типа документа в XHTML документе, или в HTML5 документе, за которым следует XHTML синтаксис, никогда не задавайте MIME тип как XHTML MIME. Это будет некорректно.- Только HTML документ может использовать контент-тип, так что большинство из них являются неиспользуемыми, поэтому они являются устаревшими и заменяются
charset
атрибутом.
- Не используйте эту прагму, так как она устарела. Используйте атибут
"default-style"
- Специализация этой прагмы - предпочтительный стиль таблиц, используемый на странице.
content
атрибут должен содержать заголовок<link>
элемента которыйhref
связывает атрибут с CSS таблцей стилей, или заголовок<style>
элемента, который содержит CSS таблицу стилей. "refresh"
- Эта прагма определяет:
- Количество секунд перезагрузки таблицы, если
content
атрибут содержит только положительный целочисленный номер; - Время, в количестве секунд, за которое страница должна быть перенаправлена на другую, если
content
атрибут содержит положительный целочисленный номер, заканчивающийся строкой ';url=
' и корректный URL.
- Количество секунд перезагрузки таблицы, если
"set-cookie"
- Эта прагма определяет cookie для страницы. Её содержимое должно заканчиваться синтаксисом, определяемым IETF HTTP Cookie Specification.
Замечание: Не используете эту прагму, так как она устарела. Используйте HTTP header set-cookie вместо этого.
name
- Этот атрибут определяет имя уровня документа метаданных.
Его не следует устанавливать, если один из атрибутовitemprop
,http-equiv
илиcharset
также указан в наборе.
Имя этого документального уровня метаданных связано со значением, которое содержится вcontent
атрибуте.Допустимые значения для имени элемента, со связанными с ними значениями, хранятся посредтвомcontent
атрибута:application-name
, определяет имя веб-приложения, запущенного на веб-странице;Замечание:- Браузеры могут использовать его для идентификации приложения. Он отличается от
<title>
элемента, который обычно состоит из имени приложения, но также может содержать специальную информацию, как например име документа или статус; - Простые веб-страницы не определяют application-name meta.
- Браузеры могут использовать его для идентификации приложения. Он отличается от
автор
определяет в свободном формате имя автора документа;- описание, содержащее краткое и точное резюме содержания страницы. В некоторых браузерах, среди которых Firefox и Opera, этот мета используется как описание страницы по умолчанию в закладке;
- генератор, содержащий в свободном формате идентификатор программного обеспечения, создавшего страницу;;
- Ключевые слова, представленные строками, разделенными запятыми, связанные с содержанием страницы
referrer
контролирует содержимое HTTP.Referer
HTTP - заголовок, прикрепленный к любому запросу, отправленному из этого документа:Значения содержимого атрибута <meta name="referrer"> no-referrer
Не отправлять HTTP Referer
заголовок.origin
Отправить оригинал. no-referrer-when-downgrade
Отправить оригинал, как ссылку по умолчанию на безопасный пункт (https->https), но не отправлять ссылку на менее безопасную структуру (https->http). Это поведение по умолчанию. origin-when-crossorigin
Отправляет полный URL (удаленный из параметров) при выполнении запроса с тем же источником, или только оригинал документа в других случаях. unsafe-URL
Отправляет полный URL (удалённый из параметров), при выполнении запроса того же или перекрестного происхождения. Замечание: Некоторые браузеры поддерживают ключевые слова всегда, по умолчанию и никогда для реферера. Эти значения устарели.
Замечание: Динамическая вставка<meta name="referrer">
(с помощью document.write или appendChild) создаёт недетерминизм, когда дело доходит до отправки рефереров. Также стоит отметить, что когда определяется несколько конфликтующих политик, применяется No-referrer policy.
Атрибут также может иметь значение, взятое из существующего листа определений WHATWG Wiki MetaExtensions page. Хотя ни один из них официально не был принят, в число предложений входят несколько часто используемых имен:
creator
, определят в свободном формате имя создателя документа. Это также может быть имя института. Если же имен больше чем одно, то несколько<meta>
элементов должны быть использованы;googlebot
, синонимrobots
, но только следует за Googlebot, сканирует индексы для Google;publisher
, определяет в свободном формате имя того, кто опубликовал документ. Это также может быть имя института;robots
, определяет поведение, поисковых роботов на странице. Список этих значений представлен ниже:Значения для содержимого <meta name="robots"> Значение Описание Используется index
Позволяет роботу индексировать страницу All noindex
Освобождает робота от идексирования страниц All follow
Позволяет роботу переходить по ссылкам со страницы All nofollow
Запрещает роботу переходить по ссылкам со страницы All none
Эквивалетно noindex, nofollow
Google noodp
Запрещает использование Open Directory Project описания, если таковые имеются, как описание страницы на странице результатов поиска noarchive
Запрещает поисковой системе кэшировать содержимое страницы. Google, Yahoo, Bing nosnippet
Запрещает отображение любого описания страницы на странице результатов поиска Google, Bing noimageindex
Запрещает отображение этой страницы в качестве ссылающейся страницы индексированного изображения. Google nocache
Синоним noarchive
Bing Замечания:- Только кооперативные роботы будут следовать правилам, определенным именем роботов.
- Роботу необходимо получить доступ к странице, чтобы считать мета значение. Если Вы хотите скрыть от них информацию, то используйте robots.txt файл.
- Если вы хотите удалить страницу индекса, изменение мета в noindex будет работать, но только тогда, когда робот снова посетит страницу. Убедитесь, что файл robots.txt не предотвращает такие посещения. Некоторые поисковые системы имеют инструменты, позволяющие быстро удалить какую-либо страницу.
- Некоторые возможные значения взаимно исключают друг друга, такие как использование индекса и noindex или follow и nofollow одновременно. В этих случаях поведение робота не определено и может варьироваться от одного к другому. Поэтому избегайте этих случаев.
- Некоторые поисковые роботы-роботы, такие как Google, Yahoo Search или Bing, поддерживают те же значения в директиве HTTP, X-Robot-Tags: это позволяет им использовать эту прагму для документов, отличных от HTML, например изображений.
slurp
,синонимrobots
, но следует только за Slurp, индексирующим роботом от Yahoo Search;
Наконец несколько общих терминов:
viewport
, который дает подсказки о размере изначального размера viewport. Эта прагма используется только на некоторых мобильных устройствах.Значения для содержания <meta name="viewport">
Значение Допустимые значения Описание width
положительный целочисленный номер или литерал device-width
Определяет ширину области просмотра в пикселях height
положительный целочисленный номер или литерал device-height
Определяет высоту области просмотра в пикселях initial-scale
положительное число между 0.0
и10.0
Определяет соотношение между шириной устройства и размером области просмотра maximum-scale
положительное число между 0.0
и10.0
Определяет максимальное значение зума; должен быть больше или равен минимальному масштабу или быть неопределенным. minimum-scale
положительное число между 0.0
и10.0
Определяет минимальное значение зума; должен быть меньше или равен максимальному масштабу или быть неопределенным. user-scalable
булевское значение (да или нет) Если весь набор содержит значения нет, то пользователю не доступен зум на веб-странице. По умолчанию задано значение да. Спецификация Статус Комментарий CSS Device Adaptation
Определение '<meta name="viewport">' в этой спецификации.Рабочий черновик Ненормативно описывает элемент META Viewport Смотрите также:@viewport
Замечания:- Хотя и не стандартизирован, этот атрибут используется разными мобильными браузерами, например Safari Mobile, Firefox for Mobile or Opera Mobile.
- Значения по умолчанию могут быть изменены у разных браузеров или устройств..
- Для изучения этой прагмы на Firefox for Mobile, посмотрите статью this article.
scheme
- Этот атрибут определяет схему, которая описывает метаданные.
Схема - это контекст, ведущий к правильной интерпретацииcontent
значения, например формата.Замечание: Не используйте этот атрибут, так как он устарел. Для него нет никакой замены, поскольку реально он не использовался. Опустите его.
Замечания
В зависимости от установленных атрибутов, тип метаданных может быть одним из следующих:
- Если в наборе
name
, то это document-level metadata, применяемая ко всей странице. - Если в наборе
http-equiv
, то это pragma directive,
то есть информация, веб-сервер предоставляет информацию о том, как должна обслуживаться веб-страница. - Если в наборе
charset
, то это charset declaration,
то есть кодировка, используемая для сериализованной формы веб-страницы. - Если в наборе
itemprop
, то это user-defined metadata,
прозрачна для агента пользователя, поскольку семантика метаданных зависит от пользователя.
Пример
<!-- In HTML5 -->
<meta charset="utf-8">
<!-- Redirect page after 3 seconds -->
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org">
Спецификации
Спецификация | Статус | Комментарий |
---|---|---|
Referrer Policy Определение '<meta name="referrer">' в этой спецификации. |
Кандидат в рекомендации | Определяет значения и семантику <meta name="referrer"> . |
HTML Living Standard Определение '<meta>' в этой спецификации. |
Живой стандарт |
Добавлен |
HTML5 Определение '<meta>' в этой спецификации. |
Рекомендация | Добавлен charset атрибут |
HTML 4.01 Specification Определение '<meta>' в этой спецификации. |
Рекомендация |
Совместимость с браузерами
BCD tables only load in the browser