Атрибут name устанавливает идентификатор метатега для пары «имя=значение». Одновременно использовать атрибуты name и http-equiv недопустимо.
Синтаксис
<meta name="<значение>">
Значения
Ниже приведены некоторые допустимые значения атрибута name.
- application-name
-
Название веб-приложения, которое выполняется на веб-странице. Если никакого веб-приложения нет, то application-name не указывается.
<meta name="application-name" content="Справочник HTML">
- author
-
Имя автора документа.
<meta name="author" content="Вася Пупкин">
- color-scheme
-
Используется для указания предпочтительной цветовой схемы веб-страницы и позволяет браузеру автоматически применять светлую или тёмную тему в зависимости от настроек пользователя. Значения атрибута content приведены в табл. 1.
Табл. 1. Значения для <meta name="color-scheme">
| Значение |
Описание |
| normal |
Используется цветовая схема по умолчанию. |
| light | dark |
Цветовые схемы доступные в документе: light — светлая тема; dark — тёмная тема. Если указаны два значения, то первая схема является предпочтительной. |
| only light |
Документ поддерживает только светлую тему. |
<meta name="color-scheme" content="light dark">
- description
-
Краткое описание текущего документа. Используется поисковыми системами для вывода описания веб-страницы в результатах поиска.
<meta name="description" content="Устанавливает время ожидания перед запуском цикла анимации.">
- generator
-
Название программы или системы управления сайтом, с помощью которой был сделан документ.
<meta name="generator" content="Drupal">
- googlebot
-
Директивы только для поискового робота Google. См. значение robots.
<meta name="googlebot" content="none">
- keywords
-
Список ключевых слов, встречающихся в документе. Между собой слова и фразы разделяются запятыми.
<meta name="keywords" content="HTM, CSS, вёрстка сайтов">
- referrer
-
Управляет заголовком HTTP Referer, который отправляется из текущего документа. Этот заголовок при переходе на другой сайт передаёт реферальные данные, в частности, адрес страницы и поисковые запросы. Некоторые значения атрибута content приведены в табл. 2.
Табл. 2. Значения для <meta name="referrer">
| Значение |
Описание |
| no-referrer |
Не отправлять реферальные данные. |
| origin |
Отправлять только первичные данные — протокол, хостинг, домен, порт соединения, а не полный адрес документа. |
| no-referrer-when-downgrade |
Не отправлять реферальные данные при переходе с HTTPS на HTTP. |
| origin-when-cross-origin |
При переходе на другой домен отправлять первичные данные, в остальных случаях полный адрес. |
| same-origin |
Отправлять реферальные данные только в пределах одного домена. |
| strict-origin |
Отправлять первичные данные только при безопасном соединении (HTTP(S)→HTTPS), и не отправлять в противном случае (HTTPS→HTTP). |
| strict-origin-when-cross-origin |
В пределах одного домена отправлять полные адреса. Отправлять первичные данные только при безопасном соединении (HTTP(S)→HTTPS), в противном случае не отправлять реферальные данные. |
| unsafe-URL |
Отправлять полные адреса в реферальных данных. |
- robots
-
Директивы для поисковых роботов. Некоторые значения атрибута content приведены в табл. 3. Если требуется установить несколько значений, они перечисляются через запятую.
Табл. 3. Значения для <meta name="robots">
| Значение |
Описание |
| index |
Разрешает роботу индексировать данную страницу. |
| noindex |
Запрещает роботу индексировать текущую страницу, она не будет участвовать в результатах поиска. |
| follow |
Разрешает роботу переходить по ссылкам на данной странице. |
| nofollow |
Запрещает роботу переходить по ссылкам на данной странице. |
| archive |
Разрешает роботу кэшировать данную страницу и показывать её в результатах поиска. |
| noarchive |
Запрещает роботу кэшировать данную страницу. |
| all |
Соответствует директивам index и follow — разрешено индексировать текст и ссылки на странице. |
| none |
Соответствует директивам noindex, nofollow — запрещено индексировать текст и ссылки на странице. |
<meta name="robots" content="all">
- theme-color
Указывает желаемый цвет, который браузер должен использовать для настройки цветовой темы документа или пользовательского интерфейса. Значение должно быть в допустимом для CSS формате.
<meta name="theme-color" content="#303f9f">
- viewport
-
Указывает исходный размер области просмотра. Некоторые значения атрибута content приведены в табл. 4. Если требуется установить несколько значений, они перечисляются через запятую.
Табл. 4. Значения для <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 |
Число от 0.0 до 10.0 |
Задаёт минимальное значение масштаба. Должно быть меньше или равно maximum-scale, в противном случае игнорируется. |
| user-scalable |
yes или no |
Если указано no, то пользователь не сможет масштабировать веб-страницу. По умолчанию используется yes. |
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- yandex
-
Директивы только для поискового робота Yandex. См. значение robots.
<meta name="yandex" content="noarchive">
Значение по умолчанию
Нет.
Пример
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>META, атрибут name</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="keywords"
content="HTML, META, метатег, тег, поисковая система">
</head>
<body>
<p>...</p>
</body>
</html>
Браузеры
Браузеры
В таблице браузеров применяются следующие обозначения.
- — элемент полностью поддерживается браузером;
- — элемент браузером не воспринимается и игнорируется;
- — при работе возможно появление различных ошибок, либо элемент поддерживается с оговорками.
Число указывает версию браузреа, начиная с которой элемент поддерживается.