Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.
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 unDOMString
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 unUSVString
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 unUSVString
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 unUSVString
que representa el nombre de host en la URL referenciada.HTMLHyperlinkElementUtils.href
Es unUSVString
que refleja el atributo HTMLhref
, que contiene una URL válida de un recurso vinculado.
HTMLAnchorElement.hreflang
Es unDOMString
que refleja el atributo HTMLhreflang
, que indica el idioma del recurso vinculado.
HTMLAnchorElement.media
Es unDOMString
que refleja el atributo HTMLmedia
, que indica los medios previstos para el recurso vinculado.
HTMLAnchorElement.name
Es unDOMString
que representa el nombre del ancla.
HTMLHyperlinkElementUtils.password
Es unUSVString
que contiene la contraseña especificada antes del nombre de dominio.HTMLHyperlinkElementUtils.origin
Read only
Devuelve unUSVString
que contiene el origen de la URL, que es su esquema, su dominio y su puerto.
HTMLHyperlinkElementUtils.pathname
Es unUSVString
que representa el componente del nombre de ruta, si lo hay, de la URL referenciada.
HTMLHyperlinkElementUtils.port
Es unUSVString
que representa el componente de puerto, si lo hay, de la URL a la que se hace referencia.
HTMLHyperlinkElementUtils.protocol
Es unUSVString
que representa el componente de protocolo, incluidos los puntos finales (':'), de la URL a la que se hace referencia.
HTMLAnchorElement.referrerPolicy
Es unDOMString
que refleja el atributoreferrerpolicy
HTML que indica qué referencia usar.
HTMLAnchorElement.rel
Es unDOMString
que refleja el atributo HTMLrel
, que especifica la relación del objeto de destino con el objeto vinculado.
HTMLAnchorElement.relList
Read only
Devuelve unDOMTokenList
que refleja el atributo HTMLrel
, como una lista de tokens.
HTMLAnchorElement.rev
Es unDOMString
que representa el atributo HTMLrev
, que especifica la relación del objeto de enlace con el objeto de destino.
HTMLHyperlinkElementUtils.search
Es unUSVString
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 unDOMString
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 unDOMString
que refleja el atributo HTMLtarget
, que indica dónde mostrar el recurso vinculado.
HTMLAnchorElement.text
Es unDOMString
un sinónimo de la propiedadNode.textContent
.
HTMLAnchorElement.type
Es unDOMString
que refleja el atributo HTMLtype
, que indica el tipo MIME del recurso vinculado.
HTMLHyperlinkElementUtils.nombre de usuario
Es unUSVString
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
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>