HTMLAnchorElement

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

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

* Некоторые части этой функции могут иметь различный уровень поддержки.

Интерфейс HTMLAnchorElement представляет элементы гиперссылок и предоставляет специальные свойства и методы (помимо тех, которые унаследованы от обычного интерфейса объекта HTMLElement) для управления макетом и представлением таких элементов. Этот интерфейс соответствует элементу <a>; не следует путать с элементом <link>, который представлен интерфейсом HTMLLinkElement.

Свойства экземпляра

Наследует свойства от родительского класса HTMLElement.

HTMLAnchorElement.attributionSrc Безопасный контекст Экспериментально: Получает и устанавливает атрибут attributionsrc элемента <a> программно, отражая значение этого атрибута. attributionsrc указывает, что вы хотите, чтобы браузер отправлял заголовок Attribution-Reporting-Eligible. На стороне сервера это используется для запуска отправки заголовка Attribution-Reporting-Register-Source в ответе для регистрации источника атрибуции на основе навигации.
HTMLAnchorElement.download: Строка, указывающая, что связанный ресурс предназначен для загрузки, а не для отображения в браузере. Значение представляет предполагаемое имя файла. Если имя не является допустимым именем файла для ОС, браузер его адаптирует.
HTMLAnchorElement.hash: Строка, представляющая идентификатор фрагмента, включая ведущую диез (#), если таковой имеется, в ссылке URL.
HTMLAnchorElement.host: Строка, представляющая имя хоста и порт (если он не является стандартным) в ссылке URL.
HTMLAnchorElement.hostname: Строка, представляющая имя хоста в ссылке URL.
HTMLAnchorElement.href: Строка, являющаяся результатом анализа атрибута href HTML относительно документа, содержащего действительный URL связанного ресурса.
HTMLAnchorElement.hreflang: Строка, отражающая атрибут hreflang HTML, указывающая язык связанного ресурса.
HTMLAnchorElement.origin Только для чтения: Возвращает строку, содержащую происхождение URL, то есть его схему, домен и порт.
HTMLAnchorElement.password: Строка, содержащая пароль, указанный перед именем домена.
HTMLAnchorElement.pathname: Строка, содержащая начальный / символ, за которым следует путь URL, без строки запроса или фрагмента.
HTMLAnchorElement.ping: Список URL, разделенных пробелами. При переходе по ссылке браузер отправит запросы POST с телом PING на указанные URL.
HTMLAnchorElement.port: Строка, представляющая компонент порта, если он есть, в ссылке URL.
HTMLAnchorElement.protocol: Строка, представляющая компонент протокола, включая конечную двоеточие (:) в ссылке URL.
HTMLAnchorElement.referrerPolicy: Строка, отражающая атрибут referrerpolicy HTML, указывающая какой referrer использовать.
HTMLAnchorElement.rel: Строка, отражающая атрибут rel HTML, определяющая отношение целевого объекта к объекту ссылки.
HTMLAnchorElement.relList Только для чтения: Возвращает объект DOMTokenList, отражающий атрибут rel HTML в виде списка токенов.
HTMLAnchorElement.search: Строка, представляющая элемент поиска, включая ведущий вопросительный знак (?), если таковой имеется, в ссылке URL.
HTMLAnchorElement.target: Строка, отражающая атрибут target HTML, указывающий, где отобразить связанный ресурс.
HTMLAnchorElement.text: Строка, являющаяся синонимом свойства Node.textContent.
HTMLAnchorElement.type: Строка, отражающая атрибут type HTML, указывающая MIME-тип связанного ресурса.
HTMLAnchorElement.username: Строка, содержащая имя пользователя, указанное перед именем домена.

Устаревшие свойства

HTMLAnchorElement.charset Устаревшее: Строка, представляющая кодировку символов связанного ресурса.
HTMLAnchorElement.coords Устаревшее: Строка, представляющая список координат, разделённых запятыми.
HTMLAnchorElement.name Устаревшее: Строка, представляющая имя якоря.
HTMLAnchorElement.rev Устаревшее: Строка, отражающая атрибут rev HTML, определяющая отношение объекта ссылки к целевому объекту.
HTMLAnchorElement.shape Устаревшее: Строка, представляющая форму активной области.

Методы экземпляра

Наследует методы от родительского класса HTMLElement.

HTMLAnchorElement.toString(): Возвращает строку, содержащую весь URL. Это синоним для HTMLAnchorElement.href, но не может использоваться для изменения значения.

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

Спецификация
HTML # htmlanchorelement

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android

`HTMLAnchorElement`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	≤37
`attributionSourceId`	Нет	Нет	Нет	Нет	15.414.1–15.4	Нет	Нет	Нет	15.414.5–15.4	Нет	Нет
`attributionSrc`	125	125	Нет	111	Нет	125	Нет	83	Нет	27.0	125
`charset`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`coords`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`download`	15	13	20	15	10.1	18	20	14	10.3	1.0	4.4
`hash`	1	12	1 From Firefox 29 to Firefox 40, the returned value was incorrectly percent-decoded.	15	1	18	4 From Firefox for Android 29 to Firefox for Android 40, the returned value was incorrectly percent-decoded.	14	1	1.0	4.4
`host`	1	12	1	15	1	18	4	14	1	1.0	4.4
`hostname`	1	12	1	15	1	18	4	14	1	1.0	4.4
`href`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`hrefTranslate`	81	Нет	Нет	68	Нет	81	Нет	58	Нет	13.0	81
`hreflang`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`name`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`origin`	8	17	26 Before Firefox 49, results for URL using the `blob` scheme incorrectly returned `null`.	15	5.1	18	26 Before Firefox for Android 49, results for URL using the `blob` scheme incorrectly returned `null`.	14	5	1.0	3
`password`	32	79	26	19	10	32	26	19	10	2.0	4.4.3
`pathname`	1	12	1 Before Firefox 53, the `pathname` and `search` `HTMLHyperlinkElementUtils` properties returned the wrong parts of the URL. For example, for a URL of `https://z.com/x?a=true&b=false`, `pathname` would return `'/x?a=true&b=false'` and `search` would return '', rather than `'/x'` and `'?a=true&b=false'` respectively. This has now been fixed.	15	1	18	4 Before Firefox for Android 53, the `pathname` and `search` `HTMLHyperlinkElementUtils` properties returned the wrong parts of the URL. For example, for a URL of `https://z.com/x?a=true&b=false`, `pathname` would return `'/x?a=true&b=false'` and `search` would return '', rather than `'/x'` and `'?a=true&b=false'` respectively. This has now been fixed.	14	1	1.0	4.4
`ping`	12	17	1 This property is exposed but has no effect if the `browser.send_pings` preference is not set to `true`. See bug 951104.	15	5.1	18	4 This property is exposed but has no effect if the `browser.send_pings` preference is not set to `true`. See bug 951104.	14	5	1.0	≤37
`port`	1	12	1	15	1	18	4	14	1	1.0	4.4
`protocol`	1	12	1	15	1	18	4	14	1	1.0	4.4
`referrerPolicy`	5251–52	79	50	3938–39	14	5251–52	50	41	14	6.05.0–6.0	5251–52
`rel`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`relList`	65	18	30	52	9	65	30	47	9	9.0	65

`rev`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`search`	1	12	1 Перед Firefox 53, свойства `pathname` и `search` `HTMLHyperlinkElementUtils` возвращали неправильные части URL. Например, для URL `https://z.com/x?a=true&b=false`, `pathname` возвращало `'/x?a=true&b=false'`, а `search` — '', вместо `'/x'` и `'?a=true&b=false'` соответственно. Это теперь исправлено.	15	1	18	4 Перед Firefox для Android 53, свойства `pathname` и `search` `HTMLHyperlinkElementUtils` возвращали неправильные части URL. Например, для URL `https://z.com/x?a=true&b=false`, `pathname` возвращало `'/x?a=true&b=false'`, а `search` — '', вместо `'/x'` и `'?a=true&b=false'` соответственно. Это теперь исправлено.	14	1	1.0	4.4
`shape`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`target`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`text`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`toString`	52	12	22	39	3	52	22	41	1	6.0	52
`type`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`username`	32	79	26	19	10	32	26	19	10	2.0	4.4.3

См. также

HTML-элемент, реализующий этот интерфейс: <a>

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLAnchorElement