HTMLAreaElement
Базовая поддержка Широко доступна *
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
* Некоторые части этой функции могут иметь различный уровень поддержки.
Интерфейс HTMLAreaElement предоставляет специальные свойства и методы (помимо тех, которые присутствуют в стандартном объекте HTMLElement, которые он также наследует) для управления макетом и представлением элементов <area>.
Свойства экземпляра
Наследует свойства от родительского класса HTMLElement.
HTMLAreaElement.alt-
Строка, отражающая атрибут HTML
alt, содержащая альтернативный текст для элемента. HTMLAreaElement.coords-
Строка, отражающая атрибут HTML
coords, содержащая координаты для определения области активной зоны. HTMLAreaElement.download-
Строка, указывающая, что связанный ресурс предназначен для загрузки, а не отображения в браузере. Значение представляет предполагаемое имя файла. Если имя не является допустимым именем файла для операционной системы, браузер скорректирует его соответственно.
HTMLAreaElement.hash-
Строка, содержащая идентификатор фрагмента (включая ведущую диезу (#)), если таковой имеется, в ссылке URL.
HTMLAreaElement.host-
Строка, содержащая имя хоста и порт (если он не является стандартным портом) в ссылке URL.
HTMLAreaElement.hostname-
Строка, содержащая имя хоста в ссылке URL.
HTMLAreaElement.href-
Строка, которая отражает атрибут HTML
href, содержащая допустимый URL связанного ресурса. -
HTMLAreaElement.noHrefУстаревший -
Флаг булевого типа, указывающий, является ли область неактивной (
true) или активной (false). -
HTMLAreaElement.originТолько для чтения -
Возвращает строку, содержащую начало URL-адреса, то есть его схему, домен и порт.
HTMLAreaElement.password-
Строка, содержащая пароль, указанный перед именем домена.
HTMLAreaElement.pathname-
Строка, содержащая компонент имени пути, если таковой имеется, в ссылке URL.
HTMLAreaElement.ping-
Список URL-адресов, разделённых пробелами. При переходе по ссылке браузер отправит запросы
POSTс телом PING на эти URL-адреса. HTMLAreaElement.port-
Строка, содержащая компонент порта, если таковой имеется, в ссылке URL.
HTMLAreaElement.protocol-
Строка, содержащая компонент протокола (включая заключительную двоеточие
':'), в ссылке URL. HTMLAreaElement.referrerPolicy-
Строка, отражающая атрибут HTML
referrerpolicy, указывающий, какой отправитель использовать при получении связанного ресурса. HTMLAreaElement.rel-
Строка, отражающая атрибут HTML
rel, указывающий отношения текущего документа к связанному ресурсу. -
HTMLAreaElement.relListТолько для чтения -
Возвращает объект
DOMTokenList, который отражает атрибут HTMLrel, указывающий отношения текущего документа к связанному ресурсу, как список токенов. HTMLAreaElement.search-
Строка, содержащая элемент поиска (включая ведущий вопросительный знак
'?'), если таковой имеется, в ссылке URL. HTMLAreaElement.shape-
Строка, отражающая атрибут HTML
shape, указывающий форму активной зоны, ограниченную известными значениями. HTMLAreaElement.target-
Строка, отражающая атрибут HTML
target, указывающий контекст просмотра, в котором следует открыть связанный ресурс. HTMLAreaElement.username-
Строка, содержащая имя пользователя, указанное перед именем домена.
Методы экземпляра
Наследует методы от родительского класса HTMLElement.
HTMLAreaElement.toString()-
Возвращает строку, содержащую весь URL-адрес. Это синоним для
HTMLAreaElement.href.
Спецификации
| Спецификация |
|---|
| HTML # htmlareaelement |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
HTMLAreaElement |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
|---|---|---|---|---|---|---|---|---|---|---|---|
alt |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
attributionSrc |
133 | 133 | Нет | Нет | Нет | 133 | Нет | Нет | Нет | Нет | 133 |
coords |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
download |
54 | 13 | 20 | 41 | 10.1 | 54 | 20 | 41 | 10.3 | 6.0 | 54 |
hash |
1 | 12 | 1From Firefox 29 to Firefox 40, the returned value was incorrectly percent-decoded. |
15 | 1 | 18 | 4From 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 |
noHref |
1 | 12 | 1 | ≤12.1 | 1 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
origin |
32 | 17 | 26Before Firefox 49, results for URL using theblob scheme incorrectly returned null. |
19 | 10 | 32 | 26Before Firefox for Android 49, results for URL using theblob scheme incorrectly returned null. |
19 | 10 | 2.0 | ≤37 |
password |
32 | 79 | 26 | 19 | 10 | 32 | 26 | 19 | 10 | 2.0 | 4.4.3 |
pathname |
1 | 12 | 1Before Firefox 53, thepathname 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 | 4Before Firefox for Android 53, thepathname 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 | 1This property is exposed but has no effect if thebrowser.send_pings preference is not set to true. See bug 951104. |
15 | 5.1 | 18 | 4This property is exposed but has no effect if thebrowser.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.1 | 5251–52 | 50 | 41 | 14.5 | 6.05.0–6.0 | 5251–52 |
rel |
54 | 12 | 30 | 41 | 9 | 54 | 30 | 41 | 9 | 6.0 | 54 |
relList |
65 | 18 | 30 | 41 | 9 | 65 | 30 | 41 | 9 | 9.0 | 65 |
search |
1 | 12 | 1Before Firefox 53, thepathname 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 | 4Before Firefox for Android 53, thepathname 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 |
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 |
toString |
32 | 12 | 22 | 19 | 10.1 | 32 | 22 | 19 | 10.3 | 2.0 | 4.4.3 |
username |
32 | 79 | 26 | 19 | 10 | 32 | 26 | 19 | 10 | 2.0 | 4.4.3 |
См. также
- Элемент HTML, реализующий этот интерфейс:
<area>
© 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/HTMLAreaElement
