ElElemento HTMLAnchor<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.

Pruébalo

<p>You can reach Michael at:</p><ul>  <li><a href="https://example.com">Website</a></li>  <li><a href="mailto:m.bluth@example.com">Email</a></li>  <li><a href="tel:+123456789">Phone</a></li></ul>

li {  margin-bottom: 0.5rem;}

Atributos

Este elemento incluye losatributos globales.

download

Este atributo, indica descargar a los navegadores una URL en lugar de navegar hacia ella, por lo que el usuario será dirigido para salvarla como un archivo local. Si el atributo tiene un valor, éste se utilizará como nombre de archivo por defecto en el mensaje Guardar que se abre cuando el usuario hace clic en el enlace (sin embargo, el usuario puede cambiar el nombre antes de guardar el archivo). No hay restricciones sobre los valores permitidos, aunque: / y: \ se convertirán en guiones bajos (underscores), lo que evitará sugerencias de ruta específicas. Se debe tener en cuenta que la mayoría de los sistemas de archivos tienen limitaciones con respecto a los símbolos de puntuación admitidos en los nombres de archivo, por lo que los navegadores ajustarán los nombres de los archivos en consecuencia.

Nota:

• Este atributo sólo funciona para laspolíticas de mismo origen (same-origin URLs).
• Este atributo puede ser utilizado conblob: URLs ydata: URLs para descargar contenido generado por JavaScript, tales como fotografías creadas por una aplicación web de edición de imágenes.
• Si el encabezado (header) HTTPContent-Disposition: proporciona un nombre de archivo diferente al de este atributo, el encabezado HTTP tiene prioridad sobre este atributo.
• SiContent-Disposition: está ajustado ainline, Firefox priorizaContent-Disposition, como en el caso del nombre de archivo, mientras que Chrome prioriza el atributodownload.

href

Contiene una URL o un fragmento de URL al cual apunta el enlace.Un fragmento de URL es un nombre ("name") precedido por el símbolo de número (#), el cual especifíca una ubicación interna objetivo (unID 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:, andmailto: funcionan en la mayoría de los navegadores.Este atributo puede ser omitido (a partir de HTML5) para crear un enlace de marcador de posición. Un enlace de marcador de posición se parece a un enlace tradicional, pero que no dirige a algún lugar.

Nota:Puede ser utilizadohref="#top" o un fragmento vacíohref="#" para enlazar a la parte superior de la página actual.Este comportamiento está especficado en HTML5.

hreflang

Este atributo indica el lenguaje humano del recurso al que se enlaza. Este es únicamente informativo, sin ninguna funcionalidad incorporada. Los valores permitidos están determinados porBCP47.

referrerpolicyExperimental

Indica quereferencia (referer) enviar cuado la URL es recuperada:

• 'no-referrer' significaReferer: el encabezado no será enviado.
• 'no-referrer-when-downgrade' significa sinReferer: 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 elorigen (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.

rel

Especifica la relación del objeto de destino con el objeto de enlace. El valor es una lista separada por espacios de tipos de enlacetipos de enlace (link types).

target

Especifica en donde desplegar la URL enlazada. Es un nombre (name of), o palabra clave (keyword for), un contexto de navegación(browsing context): una pestaña, ventana, o<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 el 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 utilizatarget, considera agregarrel="noopener noreferrer" para evitar el uso de la APIwindow.opener.

type

Especifica el tipo de medio (media type) en la forma deMIME type para la URL enlazada. Esto es únicamente informativo, sin ninguna funcionalidad incorporada.

Atributos obsoletos

charsetObsoleto

Este atributo define lacodificación de caracteres (character encoding) de la URL enlazada. El valor debe de ser una lista delimitada por espacio y/o coma de caracteres definidos enRFC 2045. El valor por defecto esISO-8859-1.

Nota:Este atributo es obsoleto en HTML5 yno debe ser utilizado por autores. Para lograr su efecto, se debe utilzar el encabezado HTTPContent-Type: en la URL enlazada.

coordsObsoleto

Para utilizar con el siguiente atributoshape, este atributo utiliza una lista de números separada por comas para definir las coordenadas del enlace en la página.

nameObsoleto

Este atributo era requerido para anclas (anchors) que definían una posible ubicación dentro de la página. En HTML 4.01,id yname podían ser utilizados simultáneamente en un elemento<a> simpre y cuando tuvieran valores idénticos.

Nota:Este atributo es obsoleto en HTML5, se utiliza elatributo globalid en su lugar.

revObsoleto

Este atributo especifica un enlace inverso, la relación inversa del atributorel. Fue desechado por ser muy confuso.

shapeObsoleto

Este atributo era utilizado para definir una región de enlaces para crear un mapa de imagen. El valore escircle,default,polygon, yrect. El formato del atributocoords depende del valor de la forma geométrica. Paracircle, el valor esx,y,r dondex yy son las coordenadas en pixel para el centro del círculo yr es el valor del radio en pixeles. Pararect, el atributocoords debe serx,y,w,h. Los valoresx y y definen la esquina superior izquierda del rectángulo, mientras quew yh definen el ancho y el alto respectivamente. Un valor delpolygon parashape requiere los valoresx1,y1,x2,y2,... paracoords. Cada uno de los paresx,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 valordefault parashape Requiere que el área encerrada, típicamente una imágen, sea utilizada.

Nota:Utilice elatributousemap para el elemento<img> y el elemento asociado<map> para definir puntos de acceso (hotspots) en lugar del atributoshape.

Ejemplos

Enlazando a una ubicación externa

<!-- anclaje a un archivo externo --><a href="https://www.mozilla.com/">Enlace externo</a>

Resultado

Enlace externo

Enlazando a otra sección de la misma página

<!-- enlace a un elemento en esta página con --><a href="#attr-href">Descripción de enlaces de la misma página</a>

Resultado

Descripción de enlaces de la misma página

Creando una imagen clicable

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/">  <img src="mdn_logo.png" alt="MDN logo" /></a>

Resulta

Creando un enlace de correo

Es común crear enlaces que abren el programa de correo del usuario para permitir enviar un nuevo mensaje. Esto se hace con un enlacemailto:. Aquí tenemos un ejemplo:

<a href="mailto:nowhere@mozilla.org">Enviar correo a nowhere</a>

Resultado

Envia un correo a: nowhere

Para detalles adicionales acerca del esquema de la URLmailto, tales como incluir el asunto, el cuerpo u otros contenidos predeterminados, consultarEnlaces de correo (Email links) oRFC 6068.

Creando un enlace a un número de teléfono

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 URLtel, consultarRFC 2806 yRFC 2396.

Utilizando el atributodownload para guardar un<canvas> como PNG

Si deseas permitir a los usurios descargar una elemento HTML<canvas> como una imagen, puedes crear un enlace con una atributodownload 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/.

Notas

HTML 3.2 define sólo los atributosname,href,rel,rev, ytitle.

Recomendaciones de accesibilidad

Se abusa frecuntemente de las etiquetas de ancla (anchor tags) con el uso de los eventosonclick para crear pseudo-botones ajustandohref a"#" o"#" 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<button> en su lugar. En general, sólo se debe utilizar una ancla (anchor) para navegación utilizando una URL adecuada.

Especificaciones

Compatibilidad con navegadores

Véase también

• Otros elementos comunicando a nivel semántico de texto(text-level semantics):<abbr>,<em>,<strong>,<small>,<cite>,<q>,<dfn>,<time>,<code>,<var>,<samp>,<kbd>,<sub>,<sup>,<b>,<i>,<mark>,<ruby>,<rp>,<rt>,<bdo>,<span>,<br>,<wbr>.