---
title: HTMLAnchorElement
slug: Web/API/HTMLAnchorElement
translation_of: Web/API/HTMLAnchorElement
---
<div>{{APIRef("HTML DOM")}}</div>

<p><strong><code>HTMLAnchorElement</code></strong> 接口表示超链接元素，并提供一些特别的属性和方法（除了那些继承自普通 {{domxref("HTMLElement")}}对象接口的之外）以用于操作这些元素的布局和显示。</p>

<h2 id="属性（Properties）">属性（Properties）</h2>

<p><em>继承其父类 {{domxref("HTMLElement")}} 的属性，并实现 {{domxref("URLUtils")}} 中（定义）的（属性）。</em></p>

<dl>
 <dt>{{domxref("HTMLAnchorElement.accessKey")}}</dt>
 <dd>是一个代表了单个字符的 {{domxref("DOMString")}}，单个字符可以切换输入焦点到超链接。</dd>
 <dt>{{domxref("HTMLAnchorElement.charset")}} {{obsolete_inline}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing the character encoding of the linked resource.</dd>
 <dt>{{domxref("HTMLAnchorElement.coords")}} {{obsolete_inline}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing a comma-separated list of coordinates.</dd>
 <dt>{{domxref("HTMLAnchorElement.download")}} {{experimental_inline}}</dt>
 <dd>Is a {{domxref("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. The value is a URL with a scheme like <code>http:</code>, <code>file:</code>, <code>data:</code> or even <code>blob:</code> (created with {{domxref("URL.createObjectURL")}}).</dd>
 <dt>{{domxref("URLUtils.hash")}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing the fragment identifier, including the leading hash mark ('<code>#</code>'), if any, in the referenced URL.</dd>
 <dt>{{domxref("URLUtils.host")}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing the hostname and port (if it's not the default port) in the referenced URL.</dd>
 <dt>{{domxref("URLUtils.hostname")}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing the hostname in the referenced URL.</dd>
 <dt>{{domxref("URLUtils.href")}}</dt>
 <dd>Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("href", "a")}} HTML attribute, containing a valid URL of a linked resource.</dd>
 <dt>{{domxref("HTMLAnchorElement.hreflang")}}</dt>
 <dd>Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("hreflang", "a")}} HTML attribute, indicating the language of the linked resource.</dd>
 <dt>{{domxref("HTMLAnchorElement.media")}}</dt>
 <dd>Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("media", "a")}} HTML attribute, indicating the intended media for the linked resource.</dd>
 <dt>{{domxref("HTMLAnchorElement.name")}} {{obsolete_inline}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing the anchor name.</dd>
 <dt>{{domxref("URLUtils.passport")}}</dt>
 <dd>Is a {{domxref("DOMString")}} 包含指定域名的密码。</dd>
 <dt>{{domxref("URLUtils.origin")}} {{readonlyInline}}</dt>
 <dd>Returns a {{domxref("DOMString")}} containing the origin of the URL, that is its scheme, its domain and its port.</dd>
 <dt>{{domxref("URLUtils.pathname")}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing the path name component, if any, of the referenced URL.</dd>
 <dt>{{domxref("URLUtils.port")}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing the port component, if any, of the referenced URL.</dd>
 <dt>{{domxref("URLUtils.protocol")}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing the protocol component, including trailing colon ('<code>:</code>'), of the referenced URL.</dd>
 <dt>{{domxref("HTMLAnchorElement.rel")}}</dt>
 <dd>Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("rel", "a")}} HTML attribute, specifying the relationship of the target object to the linked object.</dd>
 <dt>{{domxref("HTMLAnchorElement.relList")}} {{readonlyInline}}</dt>
 <dd>Returns a {{domxref("DOMTokenList")}} that reflects the {{htmlattrxref("rel", "a")}} HTML attribute, as a list of tokens.</dd>
 <dt>{{domxref("HTMLAnchorElement.rev")}} {{obsolete_inline}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing that the {{htmlattrxref("rev", "a")}} HTML attribute, specifying the relationship of the link object to the target object.</dd>
 <dt>{{domxref("URLUtils.search")}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing tThe search element, including leading question mark ('<code>?</code>'), if any, of the referenced URL.</dd>
 <dt>{{domxref("HTMLAnchorElement.shape")}} {{obsolete_inline}}</dt>
 <dd>Is a {{domxref("DOMString")}} representing the shape of the active area.</dd>
 <dt>{{domxref("HTMLAnchorElement.tabindex")}}</dt>
 <dd>Is a <code>long</code> containing the position of the element in the tabbing navigation order for the current document.</dd>
 <dt>{{domxref("HTMLAnchorElement.target")}}</dt>
 <dd>Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("target", "a")}} HTML attribute, indicating where to display the linked resource.</dd>
 <dt>{{domxref("HTMLAnchorElement.text")}}</dt>
 <dd>Is a {{domxref("DOMString")}} being a synonym for the {{domxref("Node.textContent")}} property.</dd>
 <dt>{{domxref("HTMLAnchorElement.type")}}</dt>
 <dd>Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("type", "a")}} HTML attribute, indicating the MIME type of the linked resource.</dd>
 <dt>{{domxref("URLUtils.username")}}</dt>
 <dd>Is a {{domxref("DOMString")}} containing the username specified before the domain name.</dd>
</dl>

<h2 id="Methods">Methods</h2>

<p><em>Inherits methods from its parent, {{domxref("HTMLElement")}}, </em><em>and implements those from {{domxref("URLUtils")}}</em><em>.</em></p>

<dl>
 <dt>{{domxref("HTMLElement.blur()")}}</dt>
 <dd>Removes the  keyboard focus from the current element.</dd>
 <dt>{{domxref("HTMLElement.focus()")}}</dt>
 <dd>Gives the keyboard focus to the current element.</dd>
 <dt>{{domxref("URLUtils.toString()")}}</dt>
 <dd>Returns a {{domxref("DOMString")}} containing the whole URL. It is a synonym for {{domxref("URLUtils.href")}}, though it can't be used to modify the value.</dd>
</dl>

<p>The <code>blur()</code> and <code>focus()</code> methods are inherited from {{domxref("HTMLElement")}} from HTML5 on, but were defined on <code>HTMLAnchorElement</code> in DOM Level 2 HTML and earlier specifications.</p>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', "text-level-semantics.html#the-a-element", "HTMLAnchorElement")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>The following property has been added: <code>download</code>.<br>
    Technically, the URL-related properties, <code>media</code>, <code>host</code>, <code>hostname</code>, <code>pathname</code>, <code>port</code>, <code>protocol</code>, <code>search</code>, and <code>hash</code>, have been moved to the {{domxref("URLUtils")}} interface, and <code>HTMLAreaElement</code> implements this interface.</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', "text-level-semantics.html#the-a-element", "HTMLAnchorElement")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>The methods <code>blur()</code> and <code>focus()</code>, as well as the properties <code>tabindex</code> and <code>accessKey</code>, are now defined on {{domxref("HTMLElement")}}.<br>
    The following properties are now obsolete: <code>charset</code>, <code>coords</code>, <code>name</code>, <code>rev</code>, and <code>shape</code>.<br>
    The following properties have been added: <code>hash</code>, <code>host</code>, <code>hostname</code>, <code>media</code>, <code>pathname</code>, <code>port</code>, <code>protocol</code>, <code>relList</code>, <code>search</code>, and <code>text</code>.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM2 HTML', 'html.html#ID-48250443', 'HTMLAnchorElement')}}</td>
   <td>{{Spec2('DOM2 HTML')}}</td>
   <td>No change from {{SpecName("DOM1")}}.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM1', 'level-one-html.html#ID-48250443', 'HTMLAnchorElement')}}</td>
   <td>{{Spec2('DOM1')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>

{{Compat("api.HTMLAnchorElement")}}

<h2 id="See_also">See also</h2>

<ul>
 <li>The HTML element implementing this interface: {{HTMLElement("a")}}</li>
</ul>