---
title:
slug: Web/HTML/Element/a
tags:
- Contenido
- Ejemplo
- Elemento
- HTML
- Principiante
- Referencia
- Web
translation_of: Web/HTML/Element/a
original_slug: Web/HTML/Elemento/a
---
El Elemento HTML Anchor
<a>
crea un enlace a otras páginas de internet, archivos o ubicaciones dentro de la misma página, direcciones de correo, o cualquier otra URL.
Categorías de contenido | Contenido de flujo, contenido de párrafo, contenido interactivo, contenido palpable |
---|---|
Contenido permitido | Transparente, que contiene contenido de flujo (excluyendo contenido interactivo) o contenido de párrafo. |
Omisión de etiquetas | {{no_tag_omission}} |
Elementos principales permitidos | Cualquier elemento que acepte contenido de párrafo o cualquier elemento que acepte contenido de flujo, sin embargo simpre excluyendo los elementos <a> (de acuerdo con el principio lógico de simetría, si una etiqueta <a> como padre, no puede contener contenido interactivo, entonces el mismo contenido de <a> no puede tener una etiqueta <a> como su padre). |
Roles ARIA permitidos | {{ARIARole("button")}}, {{ARIARole("checkbox")}}, {{ARIARole("menuitem")}}, {{ARIARole("menuitemcheckbox")}}, {{ARIARole("menuitemradio")}}, {{ARIARole("option")}}, {{ARIARole("radio")}}, {{ARIARole("switch")}}, {{ARIARole("tab")}}, {{ARIARole("treeitem")}} |
Interfaz DOM | {{domxref("HTMLAnchorElement")}} |
Este elemento incluye los atributos globales.
blob:
URLs y data:
URLs para descargar contenido generado por JavaScript, tales como fotografías creadas por una aplicación web de edición de imágenes.Content-Disposition:
proporciona un nombre de archivo diferente al de este atributo, el encabezado HTTP tiene prioridad sobre este atributo.Content-Disposition:
está ajustado a inline
, Firefox prioriza Content-Disposition
, como en el caso del nombre de archivo, mientras que Chrome prioriza el atributo download
.#
), el cual especifíca una ubicación interna objetivo (un ID de un elemento HTML) dentro del actual documento. Las URLs no están restringidas sólo a documentos de internet basados en HTTP, sin embargo pueden utilizar cualquier protocolo soportado por el navegador. Por ejemplo, file:
, ftp:
, and mailto:
funcionan en la mayoría de los navegadores.Nota: Puede ser utilizado href="#top"
o un fragmento vacío href="#"
para enlazar a la parte superior de la página actual. Este comportamiento está especficado en HTML5.
'no-referrer'
significa Referer:
el encabezado no será enviado.'no-referrer-when-downgrade'
significa sin Referer:
el encabezado será enviado cuando se navega a un origen (origin
) sin HTTPS. Este es un comportamiento por defecto.'origin'
significa que el "referrer" estará en el origen (origin
) de la página, no incluye la información posterior al dominio.'origin-when-cross-origin'
significa que la navegación a otros orígenes (origins) será limitada al esquema (scheme), el host y el puerto, mientras que la navegación en el mismo origen (origin) incuirá la trayectoria de referencia (referrer's path).'unsafe-url'
significa que la referencia (referrer) incuirá el origen(origin
) y la trayectoria (path), pero no el fragmento, contraseña o nombre de usuario. Esto es inseguro, ya que puede filtrar datos desde una URL segura hacia URLs inseguras.<iframe>
. Las siguientes palabras clave (keywords) tienen significado especial:
_self
: Carga la URL en el mismo contexto de navegación que el actual. Este es el comportamiento por defecto._blank
: Carga la URL en un nuevo contexto de navegación. Usualmente es una pestaña, sin embargo, los usuarios pueden configurar los navegadores para utilizar una ventana nueva en lugar de la pestaña._parent
: Carga la URL en el contexto de navegación padre (parent) del actual. Si no existe el padre, este se comporta del mismo modo que _self
._top
: Carga la URL en le contexto más alto de navegación (el cual es un ancestro del actual, y no tiene padre (parent)). Si no hay padre (parent), este se comporta del mismo modo que _self
.Nota: Cuando se utiliza target
, considera agregar rel="noopener noreferrer"
para evitar el uso de la API window.opener
.
ISO-8859-1
.
Nota de uso: Este atributo es obsoleto en HTML5 y no debe ser utilizado por autores. Para lograr su efecto, se debe utilzar el encabezado HTTP Content-Type:
en la URL enlazada.
shape
, este atributo utiliza una lista de números separada por comas para definir las coordenadas del enlace en la página.id
y name
podían ser utilizados simultáneamente en un elemento <a>
simpre y cuando tuvieran valores idénticos.
Nota de uso: Este atributo es obsoleto en HTML5, se utiliza el atributo global id
en su lugar.
circle
, default
, polygon
, y rect
. El formato del atributo coords
depende del valor de la forma geométrica. Para circle
, el valor es x,y,r
donde x
y y
son las coordenadas en pixel para el centro del círculo y r
es el valor del radio en pixeles. Para rect
, el atributo coords
debe ser x,y,w,h
. Los valores x y y
definen la esquina superior izquierda del rectángulo, mientras que w
y h
definen el ancho y el alto respectivamente. Un valor del polygon
para shape
requiere los valores x1,y1,x2,y2,...
para coords
. Cada uno de los pares x,y
definen un punto en el polígono, con puntos sucesivos que son unidos por líneas rectas y el útlimo punto se une al primer punto. El valor default
para shape
Requiere que el área encerrada, típicamente una imágen, sea utilizada.
usemap
para el elemento {{HTMLElement("img")}} y el elemento asociado {{HTMLElement("map")}} para definir puntos de acceso (hotspots) en lugar del atributo shape
.<!-- anclaje a un archivo externo -->
<a href="https://www.mozilla.com/">
Enlace externo
</a>
<!-- enlace a un elemento en esta página con id="attr-href" -->
<a href="#attr-href">
Descripción de enlaces de la misma página
</a>
Descripción de enlaces de la misma página
Este ejemplo utiliza una imagen que enlaza a la página de inicio de MDN. La página de inicio se abrirá en un contexto de navegación nuevo, esto es, en una nueva página o nueva ventana.
<a href="https://developer.mozilla.org/en-US/" target="_blank">
<img src="https://mdn.mozillademos.org/files/6851/mdn_logo.png"
alt="MDN logo" />
</a>
Es común crear enlaces que abren el programa de correo del usuario para permitir enviar un nuevo mensaje. Esto se hace con un enlace mailto:
. Aquí tenemos un ejemplo:
<a href="mailto:nowhere@mozilla.org">Enviar correo a nowhere</a>
Para detalles adicionales acerca del esquema de la URL mailto
, tales como incluir el asunto, el cuerpo u otros contenidos predeterminados, consultar Enlaces de correo (Email links) o {{RFC(6068)}}.
Ofrecer enlaces a números de teléfono es muy útil para los ususarios que observan documentos de internet desde computadoras portátiles conectadas a teléfonos o desde teléfonos celulares (móviles)
<a href="tel:+491570156">+49 157 0156</a>
Para detalles adicionales acerca del esquema de la URL tel
, consultar {{RFC(2806)}} y {{RFC(2396)}}.
download
para guardar un <canvas>
como PNGSi deseas permitir a los usurios descargar una elemento HTML {{HTMLElement("canvas")}} como una imagen, puedes crear un enlace con una atributo download
y la información canvas como un archivo URL:
var link = document.createElement('a');
link.innerHTML = 'download image';
link.addEventListener('click', function(ev) {
link.href = canvas.toDataURL();
link.download = "mypainting.png";
}, false);
document.body.appendChild(link);
Puedes ver como funciona en: jsfiddle.net/codepo8/V6ufG/2/.
HTML 3.2 define sólo los atributos name
, href
, rel
, rev
, y title
.
Se abusa frecuntemente de las etiquetas de ancla (anchor tags) con el uso de los eventos onclick
para crear pseudo-botones ajustando href a "#"
o "javascript:void(0)"
para prevenir la recarga de la página. Estos valores provocan comportamientos inesperados con los enlaces de copiado/dibujado, la apertura de enlaces en nuevas pestañas/ventanas, el guardado de enlaces (bookmarking), y cuando JavaScript está aún descargando, esto arroja errores, o es deshabilitado. Esto tambíen lleva a semánticas (semantics) incorrectas para tecnologías de asistencia (p.ej., lectores de pantalla). En estos casos, se recomienda utilizar un {{HTMLElement("button")}} en su lugar. En general, sólo se debe utilizar una ancla (anchor) para navegación utilizando una URL adecuada.
Cuando se clicea sobre un {{HTMLElement("a")}} las consecuencias varían de acuerdo al navegador y el sistema operativo.
Navegadores de escritorio | Windows 8.1 | OS X 10.9 |
---|---|---|
Firefox 30.0 | Si | Si |
Chrome ≥39 (Chromium bug 388666) |
Si | Si |
Safari 7.0.5 | N/A | Sólo cuando tiene un tabindex |
Internet Explorer 11 | Si | N/A |
Presto (Opera 12) | Si | Si |
Navegadores móviles | iOS 7.1.2 | Android 4.4.4 |
---|---|---|
Safari Mobile | Sólo cuando tiene un tabindex |
N/A |
Chrome 35 | ??? | Sólo cuando tiene un tabindex |
Especificación | Estatus | Comentario |
---|---|---|
{{SpecName("Referrer Policy", "#referrer-policy-delivery-referrer-attribute", "referrer attribute")}} | {{Spec2("Referrer Policy")}} | Added the referrerpolicy attribute. |
{{SpecName("HTML WHATWG", "textlevel-semantics.html#the-a-element", "<a>")}} | {{Spec2("HTML WHATWG")}} | |
{{SpecName("HTML5 W3C", "textlevel-semantics.html#the-a-element", "<a>")}} | {{Spec2("HTML5 W3C")}} | |
{{SpecName("HTML4.01", "struct/links.html#h-12.2", "<a>")}} | {{Spec2("HTML4.01")}} |
{{Compat("html.elements.a")}}