Стандартные имена метаданных
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Элемент <meta> может использоваться для предоставления метаданных документа в виде пар имя-значение, при этом атрибут name задаёт имя метаданных, а атрибут content — значение.
Стандартные имена метаданных, определённые в спецификации HTML
Спецификация HTML определяет следующий набор стандартных имён метаданных:
-
application-name: имя приложения, работающего на веб-странице.Примечание:
- Браузеры могут использовать это для идентификации приложения. Оно отличается от элемента
<title>, который обычно содержит имя приложения, но также может содержать информацию, такую как имя документа или статус. - Простые веб-страницы не должны определять имя приложения.
- Браузеры могут использовать это для идентификации приложения. Оно отличается от элемента
-
author: имя автора документа. -
description: краткое и точное описание содержимого страницы. Поисковые системы, такие как Google, могут использовать это поле для управления отображением веб-страницы в результатах поиска. -
generator: идентификатор программного обеспечения, сгенерировавшего страницу. -
keywords: слова, относящиеся к содержимому страницы, разделённые запятыми. -
referrer: управляет заголовком HTTPRefererзапросов, отправленных с документа:Значения атрибута 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недействителен, потому что принуждение документа к отображению в тёмном режиме, когда он на самом деле с ним не совместим, может привести к тому, что контент будет нечитаемым; все основные браузеры по умолчанию используют светлый режим, если не указано иное.
Это работает на уровне документа так же, как свойство CSShtml<meta name="color-scheme" content="dark light" />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+ игнорирует его по умолчанию.yesnoилиnoЕсли установлено значение yes, пользователь не может увеличить масштаб веб-страницы. По умолчанию установлено значениеviewport-fit. Настройки браузера могут игнорировать это правило, а iOS10+ игнорирует его по умолчанию.autocontain,coverилиautoЗначение
containне влияет на начальную область просмотра, и вся веб-страница отображается.Значение
coverозначает, что область просмотра масштабируется для адаптации к самой большой прямоугольной области, вмещающейся в дисплей.Значение
user-scalableозначает, что область просмотра масштабируется для заполнения дисплея устройства. Настоятельно рекомендуется использовать переменные отступов безопасной зоны, чтобы убедиться, что важный контент не оказывается за пределами дисплея.Предупреждение:
Отключение возможности масштабирования, задав
noзначениеcreator, препятствует пользователям с нарушениями зрения читать и понимать содержимое страницы.
Другие имена метаданных
Страница вики WHATWG MetaExtensions содержит большой набор нестандартных имён метаданных, которые ещё не были официально приняты; однако некоторые из указанных там имён уже довольно часто используются на практике — в том числе следующие:
-
creator: имя создателя документа, например, организации или учреждения. Если их несколько, следует использовать несколько элементов<meta>. -
googlebot, синонимrobots, используется только роботом Googlebot (индексирующим ботом Google). -
publisher: имя издателя документа. -
robots: поведение, которое должны использовать кооперативные роботы (или «боты») с данной страницей. Это список значений, разделённых запятыми:Значение Описание Используется indexРазрешает роботу индексировать страницу (по умолчанию). Все noindexЗапрашивает робота не индексировать страницу. Все followРазрешает роботу следовать ссылкам на странице (по умолчанию). Все nofollowЗапрашивает робота не следовать ссылкам на странице. Все allЭквивалентно index, followGoogle noneЭквивалентно noindex, nofollowGoogle noarchiveЗапрашивает поисковую систему не кэшировать содержимое страницы. Google, Yahoo, Bing nosnippetПрепятствует отображению описания страницы в результатах поиска. Google, Bing noimageindexЗапрашивает, чтобы эта страница не отображалась как страница, ссылающаяся на индексированное изображение. Google nocacheСиноним noarchive.Bing Примечание:
- Эти правила следуют только кооперативные роботы. Не ожидайте, что они помогут предотвратить сбор электронных адресов.
- Для прочтения этих правил роботу всё равно нужно получить доступ к странице. Чтобы предотвратить использование пропускной способности, подумайте, не лучше ли использовать файл robots.txt.
- Тег
robots<meta>и файлrobots.txtслужат для разных целей:robots.txtконтролирует сканирование страниц и не влияет на индексацию или другое поведение, регулируемое тегомrobotsmeta. Страница, которую нельзя просканировать, всё равно может быть индексирована, если на неё есть ссылка с другой страницы. - Если вы хотите удалить страницу,
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 | Нет |
См. также
© 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