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