CKTIS / JavaScript
HTMLAnchorElement: dirección del enlace y destino de navegación
`href` fija la dirección del enlace; `target` indica al navegador qué contexto de navegación debe usar al seguirlo.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
anchor.href; // Reads the URL property
anchor.href = urlString; // Sets the href attribute
anchor.target; // Reads the target attribute as a string
anchor.target = targetName; // Sets the target attribute
anchor.getAttribute("href"); // Reads the stored value or null
anchor.getAttribute("target"); // Reads the stored value or nullhref y target son propiedades de lectura y escritura de un elemento a. Pertenecen al DOM de la plataforma web, no a ECMAScript 2024. Asignar un valor a cualquiera de ellas modifica el atributo HTML correspondiente sin iniciar la navegación.
Al leer anchor.href, se obtiene una URL absoluta en forma de cadena, resuelta con la URL base actual del documento, que puede establecer un elemento base. Si falta el atributo href, la propiedad devuelve "" y el elemento no crea un hiperenlace. Si no se puede interpretar el valor como URL, la propiedad devuelve el valor del atributo sin cambios en lugar de lanzar una excepción. Un atributo presente pero vacío es una referencia relativa vacía, no una dirección ausente. getAttribute("href") devuelve el valor almacenado o null si falta el atributo.
anchor.target devuelve el valor almacenado, o "" si falta el atributo, no el destino efectivo de navegación. Al seguir el enlace, si falta el atributo se puede usar el destino predeterminado de base; si no hay tal valor predeterminado, se usa el contexto actual. _self indica el contexto actual, _parent el padre y _top el de más alto nivel. _blank solicita un contexto nuevo, sin determinar si se abrirá una pestaña o una ventana. Un nombre puede seleccionar un contexto existente con ese nombre, como un iframe.
Según el estándar HTML actual, _blank implica el comportamiento de rel="noopener", salvo que se solicite explícitamente un abridor con rel="opener". Indicar rel="noopener" impide que el nuevo contexto obtenga una referencia al que lo abrió mediante window.opener; rel="noreferrer" también omite la información de referencia.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTMLAnchorElement: href and target</title>
</head>
<body>
<script>
const doc = document.implementation.createHTMLDocument();
const base = doc.createElement("base");
base.href = "https://example.com/course/";
base.target = "_self";
doc.head.append(base);
const anchor = doc.createElement("a");
console.log(JSON.stringify([anchor.href, anchor.getAttribute("href")]));
anchor.href = "lesson-38#demo";
console.log(JSON.stringify([anchor.getAttribute("href"), anchor.href]));
console.log(JSON.stringify([anchor.target, anchor.getAttribute("target")]));
anchor.target = "_blank";
console.log(JSON.stringify([anchor.target, anchor.getAttribute("target")]));
</script>
</body>
</html>Resultado
["",null] ["lesson-38#demo","https://example.com/course/lesson-38#demo"] ["",null] ["_blank","_blank"]
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y revisa la salida en la consola. Un documento separado fija la URL base. Compara las propiedades con los valores de los atributos: el destino predeterminado del documento no aparece en `anchor.target`. El código no sigue el enlace.
Lecciones relacionadas
- JavaScript · Lección 38 · Avanzado · Versión: 4