HTMLAnchorElement

在此页

特性
方法
规范
浏览器兼容性
另请参阅
相关话题

HTMLAnchorElement interface represents hyperlink elements and provides special properties and methods (beyond those of the regular HTMLElement object interface that they inherit from) for manipulating the layout and presentation of such elements. This interface corresponds to <a> element; not to be confused with <link> , which is represented by 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="../API/EventTarget.html" 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="../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="../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="../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="../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 ，和实现那些来自 HTMLHyperlinkElementUtils .

Element.accessKey: 是 DOMString representing a single character that switches input focus to the hyperlink.
HTMLAnchorElement.download: 是 DOMString indicating that the linked resource is intended to be downloaded rather than displayed in the browser. The value represent the proposed name of the file. If the name is not a valid filename of the underlying OS, browser will adapt it.
HTMLHyperlinkElementUtils.hash: 是 USVString representing the fragment identifier, including the leading hash mark (' # '), if any, in the referenced URL.
HTMLHyperlinkElementUtils.host: 是 USVString representing the hostname and port (if it's not the default port) in the referenced URL.
HTMLHyperlinkElementUtils.hostname: 是 USVString representing the hostname in the referenced URL.
HTMLHyperlinkElementUtils.href: 是 USVString that is the result of parsing the href HTML attribute relative to the document, containing a valid URL of a linked resource.
HTMLAnchorElement.hreflang: 是 DOMString that reflects the hreflang HTML attribute, indicating the language of the linked resource.
HTMLAnchorElement.media: 是 DOMString that reflects the media HTML attribute, indicating the intended media for the linked resource.
HTMLHyperlinkElementUtils.password: 是 USVString containing the password specified before the domain name.
HTMLHyperlinkElementUtils.origin 只读: 返回 USVString containing the origin of the URL, that is its scheme, its domain and its port.
HTMLHyperlinkElementUtils.pathname: 是 USVString representing the path name component, if any, of the referenced URL.
HTMLHyperlinkElementUtils.port: 是 USVString representing the port component, if any, of the referenced URL.
HTMLHyperlinkElementUtils.protocol: 是 USVString representing the protocol component, including trailing colon (' : '), of the referenced URL.
HTMLAnchorElement.referrerPolicy: 是 DOMString that reflects the referrerpolicy HTML attribute indicating which referrer to use.
HTMLAnchorElement.rel: 是 DOMString that reflects the rel HTML attribute, specifying the relationship of the target object to the linked object.
HTMLAnchorElement.relList 只读: 返回 DOMTokenList that reflects the rel HTML attribute, as a list of tokens.
HTMLHyperlinkElementUtils.search: 是 USVString representing the search element, including leading question mark (' ? '), if any, of the referenced URL.
HTMLElement.tabindex: 是 long containing the position of the element in the tabbing navigation order for the current document.
HTMLAnchorElement.target: 是 DOMString that reflects the target HTML attribute, indicating where to display the linked resource.
HTMLAnchorElement.text: 是 DOMString being a synonym for the Node.textContent 特性。
HTMLAnchorElement.type: 是 DOMString that reflects the type HTML attribute, indicating the MIME type of the linked resource.
HTMLHyperlinkElementUtils.username: 是 USVString containing the username specified before the domain name.

过时特性

HTMLAnchorElement.charset: 是 DOMString representing the character encoding of the linked resource.
HTMLAnchorElement.coords: 是 DOMString representing a comma-separated list of coordinates.
HTMLAnchorElement.name: 是 DOMString representing the anchor name.
HTMLAnchorElement.rev: 是 DOMString representing that the rev HTML attribute, specifying the relationship of the link object to the target object. 注意 : Currently the W3C HTML 5.2 spec states that rev is no longer obsolete, whereas the WHATWG living standard still has it labeled obsolete. Until this discrepancy is resolved, you should still assume it is obsolete.
HTMLAnchorElement.shape: 是 DOMString representing the shape of the active area.

方法

继承方法来自其父级 HTMLElement ，和实现那些来自 HTMLHyperlinkElementUtils .

HTMLElement.blur()
HTMLElement.focus()
HTMLHyperlinkElementUtils.toString(): 返回 USVString containing the whole URL. It is a synonym for HTMLHyperlinkElementUtils.href , though it can't be used to modify the value.

blur() and focus() methods are inherited from HTMLElement from HTML5 on, but were defined on HTMLAnchorElement in DOM Level 2 HTML and earlier specifications.

规范

规范	状态	注释
HTML 实时标准 The definition of 'HTMLAnchorElement' in that specification.	实时标准	The following property has been added: `download` . Technically, the URL-related properties, `media` , `host` , `hostname` , `pathname` , `port` , `协议` , `search` ，和 `hash` , have been moved to the `HTMLHyperlinkElementUtils` mixin, and `HTMLAnchorElement` implements this mixin.
HTML5 The definition of 'HTMLAnchorElement' in that specification.	推荐	方法 `blur()` and `focus()` , as well as the properties `tabindex` and `accessKey` , are now defined on `HTMLElement` . The following properties are now obsolete: `charset` , `coords` , `名称` , `rev` ，和 `shape` . The following properties have been added: `hash` , `host` , `hostname` , `media` , `pathname` , `port` , `协议` , `relList` , `search` ，和 `text` .
DOM (文档对象模型) 2 级 HTML 规范 The definition of 'HTMLAnchorElement' in that specification.	过时	无变化自 DOM (文档对象模型) 1 级规范 .
DOM (文档对象模型) 1 级规范 The definition of 'HTMLAnchorElement' in that specification.	过时	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`HTMLAnchorElement`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`accessKey`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`charset` 弃用非标	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`coords` 弃用非标	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`download`	Chrome 14	Edge 13	Firefox 20	IE ?	Opera 15	Safari Yes	WebView Android Yes	Chrome Android 18	Firefox Android Yes	Opera Android Yes	Safari iOS ?	Samsung Internet Android 1.0
`hreflang`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`media`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`名称` 弃用非标	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`referrerPolicy`	Chrome 51	Edge 79	Firefox 50	IE 不支持 No	Opera 38	Safari 11.1	WebView Android 51	Chrome Android 51	Firefox Android 50	Opera Android 41	Safari iOS 不支持 No	Samsung Internet Android 7.2
`rel`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`relList`	Chrome 65	Edge 18	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android 65	Chrome Android 65	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android 9.0
`rev` 弃用非标	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`shape` 弃用非标	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`tabindex`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`target`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`text`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes
`type`	Chrome Yes	Edge 12	Firefox 1	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes

图例

完整支持
不支持
兼容性未知 ?

弃用。不要用于新网站。

另请参阅

The HTML element implementing this interface: <a>

元数据

最后修改： Feb 27, 2020

在此页

特性

过时特性

方法

规范

浏览器兼容性

图例

另请参阅

相关话题