Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 null

href 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

Fontes