Интерфейс HTMLAnchorElement представляет элементы гиперссылки и предоставляет специальные свойства и методы (помимо обычного объектного интерфейса HTMLElement, который они наследуют) для управления макетом и представлением таких элементов.
Этот интерфейс соответствует элементу <a>; не путать с < link>, который представлен HTMLLinkElement.
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ru/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ru/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ru/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ru/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25 501,20 501,30 491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ru/docs/Web/API/HTMLAnchorElement" target="_top"><rect x="321" y="65" width="170" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="406" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLAnchorElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
Свойства
Наследует свойства от его родителя,HTMLElement, и реализует те из URLUtils.
HTMLAnchorElement.accessKey- Это
DOMStringотображает собой единичный символ, который переключает фокус ввода на гиперссылку. HTMLAnchorElement.charset- Это
DOMStringотображает кодировку символов связаного ресурса. HTMLAnchorElement.coords- Это
DOMStringотображает список координат разделенный запятыми. HTMLAnchorElement.download- Это
DOMStringпоказыват что связаный ресурс предназначен для загрузки, а не для отображения в браузере. Значение представляет предполагаемое имя файла. Если имя не является допустимым именем файла нижележащей ОС, браузер будет адаптировать его. Значение это URL по схемеhttp:,file:,data:или дажеblob:(созданный с помощьюURL.createObjectURL). URLUtils.hash- Это
DOMStringотображает фрагмент идентификатора, включая ведущий hash mark ('#'), если, указан в URL. URLUtils.host- Это
DOMStringотображает имя хоста порт (если это не порт по умолчанию) в указанном URL. URLUtils.hostname- Это
DOMStringотбражает имя хоста в указанном URL. URLUtils.href- Это
DOMStringчто отображаетhrefHTML атрибут, содержащий действительный URL связанного ресурса. HTMLAnchorElement.hreflang- Это
DOMStringчто отображает HTML атрибутhreflang, показывающий язык связанного ресурса. HTMLAnchorElement.media- Это
DOMStringчто отображаетmediaHTML атрибут, с указанием предполагаемого media для связанного ресурса. HTMLAnchorElement.name- Это
DOMStringотображает имя якоря. URLUtils.password- Это
DOMStringсодержащий пароль, указанный перед именем домена. URLUtils.originТолько для чтения- Возвращает
DOMStringсодержащий источник, то есть его схему, его домен и его порт. URLUtils.pathname- Это
DOMStringотображающий состовную часть пути имени, любого, ссылающегося URL. URLUtils.port- Это
DOMStringотображающий составную часть порта, любого, ссылающегося URL. URLUtils.protocol- Is a
DOMStringотображаеющий составную часть протокола, включая двоеточия (':'), ссылающегося URL. HTMLAnchorElement.referrer- Это
DOMStringчто отображаетreferrerHTML аттрибут, показывающий какой referrer используется, когда выбранно изображение. HTMLAnchorElement.rel- Это
DOMStringчто отображаетrelHTML атрибут, уточняя взаимоотношения целевого объекта к связанному объекту. HTMLAnchorElement.relListТолько для чтения- Возвращает
DOMTokenListкоторый отображаетrelHTML атрибут, как список токенов. HTMLAnchorElement.rev- Это
DOMStringотображающий какrevHTML атрибут, уточняя взаимоотношения связанного объекта к целевому объекту URLUtils.search- Это
DOMStringотображающий искомый элемент, включая ведущий знак вопроса ('?'), если таковой имеется, в ссылающемся URL. HTMLAnchorElement.shape- Это
DOMStringотображающий вид активной области. HTMLAnchorElement.tabindex- Это
longсодержащий положение элемента в норядке навигационного переключения для текущего документа. HTMLAnchorElement.target- Это
DOMStringкоторый отображаетtargetHTML атрибут, указывая где отображается связанный ресурс. HTMLAnchorElement.text- Это
DOMStringявляется синонимомNode.textContentсвойства. HTMLAnchorElement.type- Это
DOMStringкоторое отображаетtypeHTML атрибут, показывающий MIME тип связанного ресурса. URLUtils.username- Это
DOMStringсодержащий имя пользователя определенное перед именем домена.
Методы
Наследует методы от его родителя, HTMLElement, и реализует те из URLUtils.
HTMLElement.blur()- Удаляет фокус клавиатуры из текущего элемента.
HTMLElement.focus()- Дает фокус клавиатуры на текущий элемент.
URLUtils.toString()- Возвращает
DOMStringсодержащий весь URl. Это синонимURLUtils.href, хотя он не может быть использован для изменения значения.
blur() и focus() методы наследуемые от HTMLElement для HTML5, но они были определены в HTMLAnchorElement в DOM Level 2 HTML и более ранней спецификации.
Спецификации
| Спецификация | Статус | Комментарий |
|---|---|---|
| Referrer Policy Определение 'referrer attribute' в этой спецификации. |
Кандидат в рекомендации | Добавлено referrer свойство. |
| HTML Living Standard Определение 'HTMLAnchorElement' в этой спецификации. |
Живой стандарт | Следующте свойство были добавлены: download.Технически Technically, URL связанные свойства, media, host, hostname, pathname, port, protocol, search, и hash, были перемещены в URLUtils интерфейс, и HTMLAreaElement реализует этот интерфейс. |
| HTML5 Определение 'HTMLAnchorElement' в этой спецификации. |
Рекомендация | Методы blur() и focus(), а также свойства tabindex и accessKey, теперь определены в HTMLElement.Следующие свойства сейча устарели: charset, coords, name, rev, и shape.Следующие свойства были добавлены: hash, host, hostname, media, pathname, port, protocol, relList, search, and text. |
| Document Object Model (DOM) Level 2 HTML Specification Определение 'HTMLAnchorElement' в этой спецификации. |
Устаревшая | Никаких изменений с Document Object Model (DOM) Level 1 Specification. |
| Document Object Model (DOM) Level 1 Specification Определение 'HTMLAnchorElement' в этой спецификации. |
Устаревшая | Изначальное описание. |
Совместимомть с браузерами
We're converting our compatibility data into a machine-readable JSON format.
This compatibility table still uses the old format,
because we haven't yet converted the data it contains.
Find out how you can help!
| Свойство | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Базовая поддержка | (Да) | 1.0 (1.7 или ранее) | (Да) | (Да) | (Да) |
download |
14 | 20 | ? | 15 | ? |
username, password, and origin |
? | 26.0 (26.0) | ? | ? | ? |
referrer |
Нет | 42 (42) | Нет | Нет | Нет |
| Свойство | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | (Да) | 1.0 (1.0) | (Да) | (Да) | (Да) |
download |
? | ? | ? | ? | ? |
username, password, and origin |
? | 26.0 (26.0) | ? | ? | ? |
referrer |
Нет | 42.0 (42) | Нет | Нет | Нет |
Смотрите также
- HTML элемент реализующий это интерфейс:
<a>