CKTIS / JavaScript
HTMLAnchorElement: endereço da ligação e destino da navegação
`href` define o endereço da ligação; `target` indica ao navegador que contexto de navegação deve usar ao segui-la.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
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 e target são propriedades de leitura e escrita de um elemento a. Pertencem ao DOM da plataforma Web, não ao ECMAScript 2024. Atribuir um valor atualiza o atributo HTML correspondente sem iniciar a navegação.
Ao ler anchor.href, obtém-se um URL absoluto em forma de cadeia de caracteres, resolvido em relação ao URL de base atual do documento, que um elemento base pode definir. Se o atributo href estiver ausente, a propriedade devolve "" e o elemento não cria uma hiperligação. Se a análise do URL falhar, a propriedade devolve o valor do atributo sem alterações, em vez de lançar uma exceção. Um atributo presente mas vazio é uma referência relativa vazia, não um endereço em falta. getAttribute("href") devolve o valor guardado, ou null se o atributo estiver ausente.
anchor.target devolve o valor guardado, ou "" se o atributo estiver ausente, e não o destino efetivo da navegação. Ao seguir a ligação, se não houver atributo, pode ser usado o destino predefinido por base; se não existir essa predefinição, é usado o contexto atual. _self indica o contexto atual, _parent o contexto superior imediato e _top o de nível mais alto. _blank pede um novo contexto, sem determinar se será um separador ou uma janela. Um nome pode selecionar um contexto existente com esse nome, como um iframe.
De acordo com a norma HTML atual, _blank implica o comportamento de rel="noopener", a menos que rel="opener" peça explicitamente uma referência ao contexto que abriu a ligação. Definir rel="noopener" impede que o novo contexto obtenha essa referência através de window.opener; rel="noreferrer" também omite a informação sobre a página de origem.
Exemplos
<!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 o exemplo como ficheiro HTML, abre-o num navegador e verifica o resultado na consola. Um documento separado fixa o URL de base. Compara as propriedades com os valores dos atributos: o destino predefinido do documento não aparece em `anchor.target`. O código não segue a ligação.
Lições relacionadas
- JavaScript · Lição 38 · Avançado · Versão: 4