<link>: Элемент ссылки на внешний ресурс

Этот элемент включает глобальные атрибуты.

as

Этот атрибут обязателен, когда rel="preload" установлен для элемента <link>, необязателен, когда установлен rel="modulepreload", и в противном случае не должен использоваться. Он определяет тип загружаемого содержимого <link>, что необходимо для сопоставления запросов, применения правильной политики безопасности содержимого и установки правильного заголовка запроса Accept.

Кроме того, rel="preload" использует его как сигнал для приоритетизации запросов. В таблице ниже перечислены допустимые значения этого атрибута и соответствующие элементы или ресурсы.

Значение	Применяется к
audio	<audio> элементы
document	<iframe> и <frame> элементы
embed	<embed> элементы
fetch	fetch, XHR Примечание: Это значение также требует, чтобы <link> содержал атрибут crossorigin, см. CORS-активированные запросы fetch.
font	CSS @font-face Примечание: Это значение также требует, чтобы <link> содержал атрибут crossorigin, см. CORS-активированные запросы fetch.
image	<img> и <picture> элементы со srcset или imageset атрибутами, SVG <image> элементы, CSS *-image правила
object	<object> элементы
script	<script> элементы, Worker importScripts
style	<link rel=stylesheet> элементы, CSS @import
track	<track> элементы
video	<video> элементы
worker	Worker, SharedWorker

blocking Экспериментальный

Этот атрибут явно указывает, что определенные операции должны быть заблокированы при загрузке внешнего ресурса. Он должен использоваться только тогда, когда атрибут rel содержит ключевые слова expect или stylesheet. Операции, которые должны быть заблокированы, должны быть перечислены в виде разделителя пробелов ниже.

• render: Отображение содержимого на экране заблокировано.

crossorigin

Этот перечисляемый атрибут указывает, нужно ли использовать CORS при загрузке ресурса. CORS-активированные изображения можно повторно использовать в элементе <canvas> без повреждения. Допустимые значения:

anonymous

Выполняется междоменный запрос (т. е. с заголовком HTTP Origin), но никаких данных не отправляется (т. е. без cookie, сертификата X.509 или аутентификации HTTP Basic). Если сервер не предоставляет данные для сайта-источника (не задав заголовок HTTP Access-Control-Allow-Origin), ресурс будет поврежден и его использование ограничено.

use-credentials

Выполняется междоменный запрос (т. е. с заголовком HTTP Origin) вместе с отправкой данных (т. е. отправляются cookie, сертификат и/или выполняется аутентификация HTTP Basic). Если сервер не предоставляет данные для сайта-источника (через заголовок HTTP Access-Control-Allow-Credentials), ресурс будет поврежден и его использование ограничено.

Если атрибут отсутствует, ресурс загружается без запроса CORS (т. е. без отправки заголовка HTTP Origin), что предотвращает его использование без повреждения. Если значение некорректно, оно обрабатывается так, как если бы использовалось перечисляемое ключевое слово anonymous. Дополнительная информация см. в разделе Атрибуты настроек CORS.

disabled

Только для rel="stylesheet", атрибут disabled (булево) указывает, должна ли описываемая таблицы стилей загружаться и применяться к документу. Если disabled указано в HTML при загрузке, таблица стилей не будет загружена во время загрузки страницы. Вместо этого таблица стилей будет загружена по требованию, если и когда атрибут disabled изменится на false или будет удален.

Установка свойства disabled в DOM приводит к удалению таблицы стилей из списка Document.styleSheets документа.

fetchpriority

Представляет подсказку о приоритете при загрузке предварительно загруженного ресурса. Допустимые значения:

high

Указывает на загрузку высокого приоритета по отношению к другим ресурсам того же типа.

low

Указывает на загрузку низкого приоритета по отношению к другим ресурсам того же типа.

auto

По умолчанию: указывает на автоматическое определение приоритета загрузки по отношению к другим ресурсам того же типа.

href

Этот атрибут указывает URL связанного ресурса. URL может быть абсолютным или относительным.

hreflang

Этот атрибут указывает язык связанного ресурса. Он является чисто рекомендательным. Допустимые значения указаны в RFC 5646: Теги для идентификации языков (также известны как BCP 47). Используйте этот атрибут только если присутствует атрибут href.

imagesizes

Только для rel="preload" и as="image", атрибут imagesizes — атрибут sizes, который указывает на предварительную загрузку соответствующего ресурса, используемого элементом img с соответствующими значениями для его атрибутов srcset и sizes.

imagesrcset

Только для rel="preload" и as="image", атрибут imagesrcset — атрибут sourceset, который указывает на предварительную загрузку соответствующего ресурса, используемого элементом img с соответствующими значениями для его атрибутов srcset и sizes.

integrity

Содержит встроенные метаданные — кодированный в base64 криптографический хэш ресурса (файла), который вы говорите браузеру загрузить. Браузер может использовать его для проверки того, что загруженный ресурс был доставлен без непредвиденных изменений. Атрибут должен быть указан только если атрибут rel указан со значениями stylesheet, preload, или modulepreload. См. Subresource Integrity.

media

Этот атрибут указывает среду, к которой относится связанный ресурс. Его значение должно быть типом среды / запрос на среду. Этот атрибут в основном полезен при ссылке на внешние таблицы стилей — он позволяет агенту пользователя выбрать наиболее подходящую для устройства, на котором он работает.

referrerpolicy

Строка, указывающая, какой использовать referrer при загрузке ресурса:

• no-referrer означает, что заголовок Referer не будет отправлен.
• no-referrer-when-downgrade означает, что заголовок Referer не будет отправлен при переходе к источнику без TLS (HTTPS). Это поведение по умолчанию агента пользователя, если не указано иное.
• origin означает, что referrer будет источником страницы, что примерно соответствует схеме, хосту и порту.
• origin-when-cross-origin означает, что переход к другим источникам будет ограничен схемой, хостом и портом, а переход к тому же источнику будет включать путь referrer.
• unsafe-url означает, что referrer будет включать источник и путь (но не фрагмент, пароль или имя пользователя). Этот случай небезопасен, так как может выдать источники и пути из защищенных TLS ресурсов в незащищенные источники.

rel

Этот атрибут называет отношение связанного документа к текущему документу. Атрибут должен быть списком значений типа ссылки, разделенных пробелами.

sizes

Этот атрибут определяет размеры значков для визуальных медиафайлов, содержащихся в ресурсе. Он должен присутствовать только в том случае, если rel содержит значение icon или нестандартный тип, такой как Apple's apple-touch-icon. Он может иметь следующие значения:

• any, что означает, что значок может быть масштабирован до любого размера, так как он находится в векторном формате, как image/svg+xml.
• список размеров, разделённых пробелами, каждый в формате <width in pixels>x<height in pixels> или <width in pixels>X<height in pixels>. Каждый из этих размеров должен быть включён в ресурс.

Примечание: Большинство форматов значков могут хранить только один значок; поэтому в большинстве случаев атрибут sizes содержит только одну запись. Форматы ICO от Microsoft и ICNS от Apple могут хранить несколько размеров значков в одном файле. ICO имеет лучшую поддержку браузеров, поэтому вы должны использовать этот формат, если для вас важна кроссбраузерная поддержка.

title

Атрибут title имеет специальную семантику в элементе <link>. При использовании на элементе <link rel="stylesheet"> он определяет стандартный или альтернативный стиль.

type

Этот атрибут используется для определения типа связанного содержимого. Значение атрибута должно быть типом MIME, таким как text/html, text/css и так далее. Общее использование этого атрибута заключается в определении типа ссылаемого стиля (например, text/css), но учитывая, что CSS — единственный язык стилей, используемый в веб, не только можно опустить атрибут type, но это и рекомендуется. Также он используется в ссылках типа rel="preload" для того, чтобы убедиться, что браузер загружает только поддерживаемые типы файлов.