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

CKTIS / JavaScript

HTMLAnchorElement.target — destino de navegação de uma ligação

Lê ou define o atributo `target` de uma ligação e distingue o valor guardado do contexto de navegação que o navegador escolhe quando a ligação é seguida.

Versão: Current web platform; runtime support varies

Sintaxe

anchor.target
anchor.target = targetNameOrKeyword;

HTMLAnchorElement.target é uma propriedade do DOM de leitura e escrita de um elemento a. A leitura devolve o texto do atributo target ou a cadeia vazia "" se o atributo não existir. Atribuir uma cadeia define o atributo, mas não inicia a navegação. href indica o URL da ligação e target indica onde o abrir.

_self seleciona o contexto de navegação atual, _parent seleciona o contexto imediatamente acima (ou o atual, se não houver um) e _top seleciona o contexto de nível superior. _blank pede um novo contexto, não necessariamente um novo separador. Um nome como report pode selecionar uma moldura existente com esse nome. Se não houver uma correspondência utilizável, o navegador pode abrir um novo contexto. As definições do navegador e as restrições de sandbox podem afetar o resultado.

Se a ligação não tiver o atributo target, a navegação usa o valor do primeiro elemento base que tenha esse atributo, caso exista. Sem esse valor predefinido, o destino habitual é o contexto atual. Com anchor.target = '', o atributo fica presente mas vazio e o valor de base não é usado. Usa getAttribute('target') para distinguir um atributo ausente (null) de um atributo vazio ("") e removeAttribute('target') para repor o recurso ao valor predefinido.

Na navegação com _blank, a norma aplica noopener por predefinição: a nova página não pode aceder à que a abriu através de window.opener. rel="opener" desativa essa proteção predefinida; rel="noopener" mantém-na explicitamente. Esta API pertence à plataforma Web, não ao ECMAScript 2024. Um ambiente de execução sem DOM não a disponibiliza automaticamente.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLAnchorElement.target</title>
</head>
<body>
  <script>
    const anchor = document.createElement('a');
    anchor.href = '#demo';
    const log = () => console.log(JSON.stringify([
      anchor.target, anchor.getAttribute('target')
    ]));

    log();
    anchor.target = '_blank';
    log();
    anchor.setAttribute('target', 'report');
    log();
    anchor.target = '';
    log();
    anchor.removeAttribute('target');
    log();
  </script>
</body>
</html>

Resultado

["",null]
["_blank","_blank"]
["report","report"]
["",""]
["",null]

Guarda o exemplo como ficheiro HTML e abre-o num navegador. Cada linha na consola do navegador mostra primeiro o valor da propriedade e depois o do atributo. O código não insere nem ativa a ligação.

Lições relacionadas

  • JavaScript · Lição 37 · Avançado · Versão: 4

Fontes