HTMLAnchorElement

Estás leyendo la versión en inglés del artículo porque aún no existe una traducción para este idioma. ¡Ayúdanos a traducir este artículo!

La interfaz HTMLAnchorElement representa elementos de hipervínculo y proporciona propiedades y métodos especiales (más allá de los de la interfaz de objeto HTMLElement regular de la que heredan) para manipular el diseño y la presentación de dichos elementos.

Propiedades

  <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/es/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/es/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/es/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/es/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/es/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;}

Hereda propiedades de su elemento primario, HTMLElement, y las implementa desde HTMLHyperlinkElementUtils.

HTMLAnchorElement.accessKey
Es un DOMString que representa un solo carácter que cambia el foco de entrada al hipervínculo.

HTMLAnchorElement.charset
Es un DOMString que representa la codificación de caracteres del recurso vinculado.

HTMLAnchorElement.coords
Es un DOMString que representa una lista de coordenadas separadas por comas.

HTMLAnchorElement.download Es un DOMString que indica que el recurso vinculado está destinado a descargarse en lugar de mostrarse en el navegador. El valor representa el nombre propuesto del archivo. Si el nombre no es un nombre de archivo válido del sistema operativo subyacente, el navegador lo adaptará.
HTMLHyperlinkElementUtils.hash Es un USVString que representa el identificador de fragmento, incluida la marca hash inicial ('#'), si la hay, en la URL a la que se hace referencia.
HTMLHyperlinkElementUtils.host Es un USVString que representa el nombre de host y el puerto (si no es el puerto predeterminado) en la URL a la que se hace referencia.
HTMLHyperlinkElementUtils.hostname Es un USVString que representa el nombre de host en la URL referenciada.
HTMLHyperlinkElementUtils.href Es un USVString que refleja el atributo HTML href, que contiene una URL válida de un recurso vinculado.
HTMLAnchorElement.hreflang Es un DOMString que refleja el atributo HTML hreflang, que indica el idioma del recurso vinculado.
HTMLAnchorElement.media Es un DOMString que refleja el atributo HTML media, que indica los medios previstos para el recurso vinculado.
HTMLAnchorElement.name Es un DOMString que representa el nombre del ancla. HTMLHyperlinkElementUtils.password Es un USVString que contiene la contraseña especificada antes del nombre de dominio.
HTMLHyperlinkElementUtils.origin Read only Devuelve un USVString que contiene el origen de la URL, que es su esquema, su dominio y su puerto.
HTMLHyperlinkElementUtils.pathname Es un USVString que representa el componente del nombre de ruta, si lo hay, de la URL referenciada.
HTMLHyperlinkElementUtils.port Es un USVString que representa el componente de puerto, si lo hay, de la URL a la que se hace referencia.
HTMLHyperlinkElementUtils.protocol Es un USVString que representa el componente de protocolo, incluidos los puntos finales (':'), de la URL a la que se hace referencia.
HTMLAnchorElement.referrerPolicy Es un DOMString que refleja el atributo referrerpolicy HTML que indica qué referencia usar.
HTMLAnchorElement.rel Es un DOMString que refleja el atributo HTML rel, que especifica la relación del objeto de destino con el objeto vinculado.
HTMLAnchorElement.relList Read only Devuelve un DOMTokenList que refleja el atributo HTML rel, como una lista de tokens.
HTMLAnchorElement.rev Es un DOMString que representa el atributo HTML rev, que especifica la relación del objeto de enlace con el objeto de destino.
HTMLHyperlinkElementUtils.search Es un USVString que representa el elemento de búsqueda, incluido el signo de interrogación principal ('?'), Si lo hay, de la URL a la que se hace referencia.
HTMLAnchorElement.shape Es un DOMString que representa la forma del área activa.
HTMLAnchorElement.tabindex Es un largo que contiene la posición del elemento en el orden de navegación de tabulación para el documento actual.
HTMLAnchorElement.target Es un DOMString que refleja el atributo HTML target, que indica dónde mostrar el recurso vinculado.
HTMLAnchorElement.text Es un DOMString un sinónimo de la propiedad Node.textContent.
HTMLAnchorElement.type Es un DOMString que refleja el atributo HTML type, que indica el tipo MIME del recurso vinculado.
HTMLHyperlinkElementUtils.nombre de usuario Es un USVString que contiene el nombre de usuario especificado antes del nombre de dominio.

Metodos

Hereda los métodos de su padre, HTMLElement, y los implementa desde HTMLHyperlinkElementUtils.

HTMLElement.blur ()
Elimina el foco del teclado del elemento actual.
HTMLElement.focus ()
Da el foco del teclado al elemento actual.
HTMLHyperlinkElementUtils.toString ()
Devuelve un USVString que contiene la URL completa. Es un sinónimo de URLUtils.href, aunque no se puede usar para modificar el valor.
Los métodos blur () y focus () se heredan de HTMLElement de HTML5 on, pero se definieron en HTMLAnchorElement en DOM Level 2 HTML y especificaciones anteriores.

Especificaciones

Epecificacion	Estado	Commentario
Referrer Policy La definición de 'referrer attribute' en esta especificación.	Candidate Recommendation	Se agregó la propiedad de referencia.
HTML Living Standard La definición de 'HTMLAnchorElement' en esta especificación.	Living Standard	Se agregó el refe. Se agregó la siguiente propiedad: descargar. Técnicamente, las propiedades relacionadas con URL, medios, host, nombre de host, ruta, puerto, protocolo, búsqueda y hash, se han movido a la interfaz `URLUtils`, y HTMLAreaElement implementa esta propiedad de interface.
HTML5 La definición de 'HTMLAnchorElement' en esta especificación.	Recommendation	Los métodos blur () y focus (), así como las propiedades tabindex y accessKey, ahora están definidos en `HTMLElement`. Las siguientes propiedades ahora están obsoletas: charset, coords, name, rev y shape. Se han agregado las siguientes propiedades: hash, host, nombre de host, medios, ruta, puerto, protocolo, relList, búsqueda y texto.
Document Object Model (DOM) Level 2 HTML Specification La definición de 'HTMLAnchorElement' en esta especificación.	Obsolete	Sin cambios desde Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification La definición de 'HTMLAnchorElement' en esta especificación.	Obsolete	definicion Inicial .

Browser compatibility

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!

Escritorio
Móvil

Feature	Chrome	Edge	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	(Yes)	(Yes)	1.0 (1.7 o anterior)	(Yes)	(Yes)	(Yes)
`download`	14	(Yes)	20	?	15	?
`username`, `password`, and `origin`	Sin soporte	?	26.0 (26.0)	?	?	?
`referrerPolicy`	51	?	50 (50)	Sin soporte	Sin soporte	Sin soporte

Feature	Android Webview	Chrome for Android	Edge	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Basic support	(Yes)	(Yes)	(Yes)	1.0 (1.0)	(Yes)	(Yes)	(Yes)
`download`	14	14	(Yes)	?	?	?	?
`username`, `password`, and `origin`	Sin soporte	Sin soporte	?	26.0 (26.0)	?	?	?
`referrerPolicy`	51	51	?	50.0 (50)	Sin soporte	Sin soporte	Sin soporte

Ver tambien

El elemento HTML que implementa esta interfaz: <a>

Última actualización: Mar 18, 2019, by MDN contributors