Propriedade target do HTML <a>

Etiqueta HTML <a>

Definição e uso

target A propriedade define o local onde o documento de link será aberto.

Exemplo

A propriedade target define o local onde o documento de link será aberto:

<a href="https://www.codew3c.com" target="_blank">Acessar CodeW3C.com</a>

Experimente pessoalmente

Sintaxe

<a target="_blank|_self|_parent|_top|framename">

target O uso dessa propriedade é informar ao navegador onde deseja exibir o recurso linkado. Padrãomente, o navegador usa a janela, a aba ou o quadro (iframe) que exibe o documento atual, então o novo documento substituirá o documento que está sendo exibido no momento. No entanto, há outras opções, consulte a tabela a seguir:

Valor do atributo

Valor Descrição
_blank Abrir o documento de link em uma nova janela ou aba.
_self Abrir o documento de link no mesmo quadro onde foi clicado (padrão).
_parent Abrir o documento de link no quadro pai.
_top Abrir o documento de link no corpo inteiro da janela.
framename Abrir o documento de link no iframe especificado.

Explicação detalhada

Se um atributo target estiver contido dentro de uma etiqueta <a>, o navegador carregará e exibirá o documento nomeado com o atributo href dessa etiqueta, que coincide com o nome desse destino, em um quadro ou janela. Se esse quadro ou janela com o nome ou id especificado não existir, o navegador abrirá uma nova janela, dará a essa janela um marcador especificado e carregará o novo documento naquela janela. A partir de então, os documentos de link poderão apontar para essa nova janela.

Abrir nova janela

Os links de destino tornam fácil criar ferramentas de navegação eficazes. Por exemplo, uma lista simples de documentos de conteúdo, que pode redirecionar os documentos para uma janela separada:

<h3>Sumário</h3>
<ul>
  <li><a href="pref.html" target="view_window">Prefácio</a></li>
  <li><a href="chap1.html" target="view_window">Capítulo 1</a></li>
  <li><a href="chap2.html" target="view_window">Capítulo 2</a></li>
  <li><a href="chap3.html" target="view_window">Capítulo 3</a></li>
</ul>

Experimente pessoalmente

Quando o usuário seleciona pela primeira vez um link da lista de conteúdo, o navegador abre uma nova janela, a marca como "view_window", e então mostra o conteúdo do documento desejado. Se o usuário selecionar outro link dessa lista e a "view_window" ainda estiver aberta, o navegador novamente carregará o documento selecionado naquela janela, substituindo os documentos anteriores.

Ao longo do processo, a janela que contém a lista de conteúdo é acessível ao usuário. Ao clicar em um link da janela, o conteúdo da outra janela muda.

Abrir janela no frame

Em vez de abrir uma janela completa do navegador, o método mais comum de usar o target é redirecionar o conteúdo de um hiperlink para um ou mais frames dentro de um <frameset>. Pode-se colocar essa lista de conteúdo em um dos frames de um documento com dois frames e usar esse frame adjacente para exibir o documento selecionado:

<frameset cols="100,*">
  <frame src="toc.html">
  <frame src="pref.html" name="view_frame">
</frameset>

Experimente pessoalmente

Quando os dois frames são exibidos inicialmente pelo navegador, o frame à esquerda contém o catálogo e o frame à direita contém o prefácio.

Este é o código-fonte de "toc.html":

<h3>Sumário</h3>
<ul>
  <li><a href="pref.html" target="view_frame">Prefácio</a></li>
  <li><a href="chap1.html" target="view_frame">Capítulo 1</a></li>
  <li><a href="chap2.html" target="view_frame">Capítulo 2</a></li>
  <li><a href="chap3.html" target="view_frame">Capítulo 3</a></li>
</ul>

Por favor, note que no documento "toc.html", o destino de cada link é "view_frame", ou seja, a caixa à direita.

Quando o usuário seleciona um link do catálogo na caixa à esquerda, o navegador carregará e exibirá o documento associado na caixa "view_frame" à direita. Quando outro link for selecionado, o conteúdo da caixa à direita também mudará, enquanto a caixa à esquerda permanecerá inalterada.

Destino especial

Existem 4 nomes de destino reservados para operações especiais de redirecionamento de documentos:

_blank

O navegador sempre carrega o documento alvo em uma nova janela não nomeada.

_self

Este alvo é o valor padrão para todos os <a> tags que não especificarem um alvo, faz com que o documento alvo seja carregado e exibido no mesmo frame ou janela que o documento original. Este alvo é desnecessário e inútil, a menos que seja usado juntamente com a propriedade target do tag <base> do título do documento.

_parent

Este alvo faz com que o documento seja carregado na janela pai ou na frame set que contém o frame para o qual o hyperlink faz referência. Se essa referência estiver na janela ou no frame superior, então é equivalente ao alvo _self.

_top

Este alvo faz com que o documento seja carregado na janela que contém este hyperlink, usando o alvo _top limpa todos os frames contidos e carrega o documento na janela do navegador inteira.

Dica:Todos os 4 valores de target mencionados começam com uma sublinhada. Qualquer outra janela ou alvo que comece com uma sublinhada será ignorado pelo navegador, portanto, não use uma sublinhada como o primeiro caractere de qualquer nome ou id definido no documento.

Suporte a navegadores

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte

Etiqueta HTML <a>