MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

            HTML meta элемент представляет любую информацию о метаданных, которая не может быть представлена другими, ориентированными на мета-данные элементами(<base>, <link>, <script>, <style> or <title>).
Content categories Метаданные. Если itemprop тогда атрибуты представляются: flow content, phrasing content.
Содержимый контент Отсутствует это пустой элемент(empty element).
Опускание тега Так как это пустой элемент, то открывающий тег должен присутствовать, а закрывающий отсутствовать.
Допустимые родители <meta charset>, <meta http-equiv>: <head> элемент. Если http-equiv iэто не заявленная декларация, то может быть внутри  <noscript> элемента, или внутри<head> элемента.
Permitted ARIA roles Отсутствуют.
DOM interface HTMLMetaElement

Атрибуты

Этот элемент включает в себя global attributes.

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

charset
Этот атрибут задает кодировку символов, используемую на странице. Может быть локально переопределен. Является символьной строкой и должен быть одним из имен MIME для символов, кодировка которых определяется IANA. Хотя стандарт не требует определенной кодировки, он дает некоторые рекомендации:
  • Авторам рекомендуется использовать UTF-8.
  • Настоятельно не рекомендуется использование  ASCII несовместных кодировок, поскольку они представляют угрозу безопасности.  Это применимо к следующим кодировокам: JIS_C6226-1983, JIS_X0212-1990, HZ-GB-2312, Johab, ISO-2022 и семьи EBCDIC.
  • Также не рекомендуется использование CESU-8, UTF-7, BOCU-1 и SCSU, так как они не предназначены для использования в интернете.
  • Авторам не следует использовать кодировку UTF-32, та как не все алгоритмы кодировки  HTML5 могут отличить её от UTF-16.
При этом:
  • Указанный набор символов должен соответствовать одной странице.
    Нет веских оснований для объявления неточного набора символов.
  • <meta> элемент должен находиться внутри  <head> элемента и 
    быть в пределах 1024 первых байтов страницы, так как некоторые браузеры смотрят только на эти первые байты, перед тем как определить набор символов страницы.
  • Этот <meta> элемент это часть алгоритма, определяющего набор символов (algorithm to determine the character set) страницы, который браузер поддерживает. Заголовок HTTP Content-Type и любые элементы спецификации имеют приоритет над этим элементом.
  • Это хорошая практика, настоятельно рекомендуемая для определения набора символов с использованием этого атрибута. Если для страницы не определён набор символов, то некоторые 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 описания, если таковые имеются, как описание страницы на странице результатов поиска

    Google, Yahoo, Bing

    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">.
WHATWG HTML Living Standard
Определение '<meta>' в этой спецификации.
Живой стандарт

Добавлен itemprop атрибут

HTML5
Определение '<meta>' в этой спецификации.
Рекомендация Добавлен charset атрибут
HTML 4.01 Specification
Определение '<meta>' в этой спецификации.
Рекомендация  

Browser compatibility

Особенность Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Стандартная поддержка (Да) (Да) 1.0 (1.7 или ранее) (Да) (Да) (Да)
name="referrer" 17 Нет 36.0 (36.0) [1] ? ? ?
Ограничено значениями, перечисленными в referrer (как указано в спецификации). 46.0 Нет        
Особенность Android Android Webview Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Стандартная поддержка (Да) (Да) (Да) 1.0 (1.0) (Да) (Да) (Да) (Да)
name="referrer" ? (Да) Нет 36.0 (36.0) [1] ? ? ? (Да)
Ограничено значениями, перечисленными в referrer (как указано в спецификации). Нет 46.0 Нет ? ? ? ? 46.0

[1] Значение реферера не учитывалось при навигации по контекстному меню или среднему клику до Firefox 39.

Также смотрите

Метки документа и участники

 Внесли вклад в эту страницу: hammurapiya
 Обновлялась последний раз: hammurapiya,