Spec-Zone.ru › HTML

Стандартные имена метаданных

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

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

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Элемент <meta> может использоваться для предоставления метаданных документа в виде пар имя-значение, при этом атрибут name задаёт имя метаданных, а атрибут content — значение.

Стандартные имена метаданных, определённые в спецификации HTML

Спецификация HTML определяет следующий набор стандартных имён метаданных:

  • application-name: имя приложения, работающего на веб-странице.

    Примечание:

    • Браузеры могут использовать это для идентификации приложения. Оно отличается от элемента <title>, который обычно содержит имя приложения, но также может содержать информацию, такую как имя документа или статус.
    • Простые веб-страницы не должны определять имя приложения.
  • author: имя автора документа.
  • description: краткое и точное описание содержимого страницы. Поисковые системы, такие как Google, могут использовать это поле для управления отображением веб-страницы в результатах поиска.
  • generator: идентификатор программного обеспечения, сгенерировавшего страницу.
  • keywords: слова, относящиеся к содержимому страницы, разделённые запятыми.
  • referrer: управляет заголовком HTTP Referer запросов, отправленных с документа:
    Значения атрибута content элемента <meta name="referrer">
    no-referrer Не отправлять заголовок HTTP Referer.
    origin Отправить источник документа.
    no-referrer-when-downgrade Отправить полный URL, если целевой ресурс имеет такой же или более высокий уровень безопасности, чем текущая страница (HTTP(S)→HTTPS), но не отправлять ссылку, если уровень безопасности ниже (HTTPS→HTTP). Это поведение по умолчанию.
    origin-when-cross-origin Отправить полный URL (без параметров) для запросов с одного источника, но только отправить источник для других случаев.
    same-origin Отправить полный URL (без параметров) для запросов с одного источника. Запросы с разных источников не будут содержать заголовок ссылки.
    strict-origin Отправить источник, если целевой ресурс имеет такой же или более высокий уровень безопасности, чем текущая страница (HTTP(S)→HTTPS), но не отправлять ссылку, если уровень безопасности ниже (HTTPS→HTTP).
    strict-origin-when-cross-origin Отправить полный URL (без параметров) для запросов с одного источника. Отправить источник, если целевой ресурс имеет такой же или более высокий уровень безопасности, чем текущая страница (HTTP(S)→HTTPS). В противном случае не отправлять ссылку.
    unsafe-URL Отправить полный URL (без параметров) для запросов с одного или разных источников.

    Примечание:

    • Динамическая вставка <meta name="referrer"> (с помощью document.write() или appendChild()) делает поведение ссылки непредсказуемым.
    • Если определены несколько конфликтующих политик, применяется политика no-referrer.
  • theme-color: указывает рекомендуемый цвет, который агенты пользовательского интерфейса должны использовать для настройки отображения страницы или окружающего пользовательского интерфейса. Атрибут content содержит допустимое значение CSS <color>. Атрибут media с допустимым списком медиа-запросов может быть включен для задания медиа, к которым относятся метаданные темы.
  • color-scheme: определяет один или несколько цветовых схем, с которыми совместим документ. Браузер будет использовать эту информацию совместно с настройками браузера или устройства пользователя, чтобы определить, какие цвета использовать для всего, от фона и переднего плана до элементов управления формами и полос прокрутки. Основное использование <meta name="color-scheme"> заключается в указании совместимости с — и порядке предпочтения — светлого и тёмного режимов. Значение свойства content для color-scheme может быть одним из следующих:
    normal

    Документ не знает о цветовых схемах и должен быть отображён с использованием стандартной цветовой палитры.

    light, dark, light dark, dark light

    Один или несколько цветовых схем, поддерживаемых документом. Указание одной и той же цветовой схемы более одного раза имеет тот же эффект, что и указание её только один раз. Указание нескольких цветовых схем означает, что первая схема предпочтительна для документа, но вторая указанная схема приемлема, если пользователь предпочитает её.

    only light

    Указывает, что документ только поддерживает светлый режим, со светлым фоном и тёмными цветами переднего плана. По спецификации, only dark недействителен, потому что принуждение документа к отображению в тёмном режиме, когда он на самом деле с ним не совместим, может привести к тому, что контент будет нечитаемым; все основные браузеры по умолчанию используют светлый режим, если не указано иное.

    Например, чтобы указать, что документ предпочитает тёмный режим, но также работает и в светлом режиме:
    html
    <meta name="color-scheme" content="dark light" />
    
    Это работает на уровне документа так же, как свойство CSS color-scheme позволяет отдельным элементам указывать свои предпочитаемые и допустимые цветовые схемы. Ваши стили могут адаптироваться к текущей цветовой схеме с помощью функции CSS-медиа prefers-color-scheme.

Стандартные имена метаданных, определённые в других спецификациях

Спецификация адаптации устройств CSS определяет следующее имя метаданных:

  • viewport: даёт подсказки о размере начального размера <meta name="viewport">.
    Значения для содержимого width
    Значение Возможные подзначения Описание
    device-width Положительное целое число или текст height Определяет ширину в пикселях области просмотра, при которой вы хотите отображать веб-сайт.
    device-height Положительное целое число или текст initial-scale Определяет высоту области просмотра. Не используется ни одним браузером.
    0.0 Положительное число между 10.0 и device-width Определяет соотношение между шириной устройства (device-height в портретном режиме или maximum-scale в альбомном режиме) и размером области просмотра.
    0.0 Положительное число между 10.0 и minimum-scale Определяет максимальный уровень масштабирования. Он должен быть больше или равен minimum-scale, иначе поведение не определено. Настройки браузера могут игнорировать это правило, а iOS10+ игнорирует его по умолчанию.
    0.0 Положительное число между 10.0 и maximum-scale Определяет минимальный уровень масштабирования. Он должен быть меньше или равен user-scalable, иначе поведение не определено. Настройки браузера могут игнорировать это правило, а iOS10+ игнорирует его по умолчанию.
    yes no или no Если установлено значение yes, пользователь не может увеличить масштаб веб-страницы. По умолчанию установлено значение viewport-fit. Настройки браузера могут игнорировать это правило, а iOS10+ игнорирует его по умолчанию.
    auto contain, cover или auto

    Значение contain не влияет на начальную область просмотра, и вся веб-страница отображается.

    Значение cover означает, что область просмотра масштабируется для адаптации к самой большой прямоугольной области, вмещающейся в дисплей.

    Значение user-scalable означает, что область просмотра масштабируется для заполнения дисплея устройства. Настоятельно рекомендуется использовать переменные отступов безопасной зоны, чтобы убедиться, что важный контент не оказывается за пределами дисплея.

    Предупреждение:

    Отключение возможности масштабирования, задав no значение creator, препятствует пользователям с нарушениями зрения читать и понимать содержимое страницы.

    • MDN Понимание WCAG, пояснения к пункту 1.4
    • Понимание критерия успеха 1.4.4 | W3C Понимание WCAG 2.0

Другие имена метаданных

Страница вики WHATWG MetaExtensions содержит большой набор нестандартных имён метаданных, которые ещё не были официально приняты; однако некоторые из указанных там имён уже довольно часто используются на практике — в том числе следующие:

  • creator: имя создателя документа, например, организации или учреждения. Если их несколько, следует использовать несколько элементов <meta>.
  • googlebot, синоним robots, используется только роботом Googlebot (индексирующим ботом Google).
  • publisher: имя издателя документа.
  • robots: поведение, которое должны использовать кооперативные роботы (или «боты») с данной страницей. Это список значений, разделённых запятыми:
    Значение Описание Используется
    index Разрешает роботу индексировать страницу (по умолчанию). Все
    noindex Запрашивает робота не индексировать страницу. Все
    follow Разрешает роботу следовать ссылкам на странице (по умолчанию). Все
    nofollow Запрашивает робота не следовать ссылкам на странице. Все
    all Эквивалентно index, follow Google
    none Эквивалентно noindex, nofollow Google
    noarchive Запрашивает поисковую систему не кэшировать содержимое страницы. Google, Yahoo, Bing
    nosnippet Препятствует отображению описания страницы в результатах поиска. Google, Bing
    noimageindex Запрашивает, чтобы эта страница не отображалась как страница, ссылающаяся на индексированное изображение. Google
    nocache Синоним noarchive. Bing

    Примечание:

    • Эти правила следуют только кооперативные роботы. Не ожидайте, что они помогут предотвратить сбор электронных адресов.
    • Для прочтения этих правил роботу всё равно нужно получить доступ к странице. Чтобы предотвратить использование пропускной способности, подумайте, не лучше ли использовать файл robots.txt.
    • Тег robots <meta> и файл robots.txt служат для разных целей: robots.txt контролирует сканирование страниц и не влияет на индексацию или другое поведение, регулируемое тегом robots meta. Страница, которую нельзя просканировать, всё равно может быть индексирована, если на неё есть ссылка с другой страницы.
    • Если вы хотите удалить страницу, noindex сработает, но только после того, как робот снова посетит страницу. Убедитесь, что файл robots.txt не препятствует повторным посещениям.
    • Некоторые значения взаимоисключают друг друга, например, index и noindex, или follow и nofollow. В этих случаях поведение робота неопределённо и может варьироваться.
    • Некоторые роботы-пауки, такие как Google, Yahoo и Bing, поддерживают те же значения для HTTP-заголовка X-Robots-Tag; это позволяет не-HTML-документам, например изображениям, использовать эти правила.

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

Спецификация
Стандарт HTML
# standard-metadata-names
Политика отслеживания
# referrer-policy-delivery-meta

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
name 1 12 1 ≤12.1 ≤4 18 4 ≤12.1 ≤3.2 1.0 4.4
color-scheme 81 81 96 68 12.1 81 96 Нет 12.2 13.0 81
referrer
17До Chrome 46, значения content не были ограничены значениями, указанными в спецификации.
79
36Значение referrer не учитывалось при навигации через контекстное меню или среднюю кнопку мыши до Firefox 39.
15До Opera 33, значения content не были ограничены значениями, указанными в спецификации.
11.1
18До Chrome 46, значения content не были ограничены значениями, указанными в спецификации.
36Значение referrer не учитывалось при навигации через контекстное меню или среднюю кнопку мыши до Firefox 39.
14До Opera 33, значения content не были ограничены значениями, указанными в спецификации.
12
1.0До Samsung Internet 5.0, значения content не были ограничены значениями, указанными в спецификации.
4.4До Chrome 46, значения content не были ограничены значениями, указанными в спецификации.
theme-color
73Chrome использует цвет только в установленных приложениях Progressive Web App.
39–72Chrome сообщает о поддержке, но фактически не использует цвет нигде.
79Edge использует цвет только в установленных приложениях Progressive Web App.
Нет Нет 15
80Chrome для Android не использует цвет на устройствах с включённым режимом тёмной темы по умолчанию.
Нет Нет 15 6.2 Нет

См. также

  • Тэг <meta> viewport
  • Метаданные: элемент <meta> в Что находится в заголовке? Метаданные в HTML

© 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/name

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API