<a>

Resumo

O elemento HTML <a> (ou o Elemento Ancora HTML define uma hiperligação (hyperlink), o destino de uma hiperligação, ou ambos.

• Categorias de conteúdo Conteúdo de fluxo, conteúdo de fraseamento, conteúdo interativo, conteúdo palpável.
• Conteúdo permitido Transparente, contendo tanto conteúdo de fluxo ou conteúdo de fraseamento.
• Omissão de tag None, both the starting and ending tag are mandatory.
• Elementos pais permitidos Qualquer elemento que aceite conteúdo de fraseamento, ou qualquer elemento que aceite conteúdo de fluxo.
• Interface DOM HTMLAnchorElement

Atributos

Este elemento inclui os atributos globais.

charset Obsolete since HTML5

Este atributo define a codificação de caracteres do link de destino. O valor é uma lista delimitada por espaço ou vírgula de conjuntos de caracteres, tal como definido na RFC 2045. O valor padrão é ISO-8859-1.

Nota de Uso: Este atributo tornou-se  obsoleto no HTML5 e não deve ser utilizado por autores. Para alcançar o seu efeito, use o cabeçalho HTTP Content-Type no recurso vinculado.

coords somente HTML 4, Obsolete since HTML5

Para uso com formas de objetos, este atributo usa uma lista separada por vírgula de números para definir as coordenadas do objeto na página.

datafld

Este atributo especifica o nome da coluna do objeto que fornece o dado vinculado.

Nota de uso: Este atributo não é padronizado e não deve ser usado por autores. Para obter seu efeito, use scripts e algum mecanismo tal como XMLHttpRequest para povoar a página dinamicamente.

Suporte	Gecko	Presto	WebKit	Trident
	Não Implementado	Não Implementado	Não Implementado	IE4, IE5, IE6, IE7 (Removido no IE8)
Padrões de documento	Microsoft's Data Binding: dataFld Property (MSDN)

datasrc

Este atributo indica o ID do objeto de origem que fornece o dado que associado à este elemento.

Nota de uso: Este atributo não é padronizado e não deve ser usado por autores. Para obter seus efeitos, use scripts e um mecanismo como XMLHttpRequest para preencher a página dinamicamente.

Suporte	Gecko	Presto	WebKit	Trident
	Não implementado	Não implementado	Não implementado	IE4, IE5, IE6, IE7 (Removido no IE8)
Documento normativo	Microsoft's Data Binding: dataSrc Property (MSDN)

download HTML5

Este atributo, se presente, indica que o autor planeja que a hiperligação seja usada para fazer download de um recurso de modo que quando um usuário clicar em um link ele seja questionado se deseja salvar seu conteúdo como um arquivo local. Se o atributo possui um valor, ele será usado como um nome sugerido para o arquivo na janela que for abrir quando o usuário clicar no link (o usuário pode mudar tal nome antes de realmente salvar o arquivo, é claro). Não existem restrições sobre valores permitidos, mas você deve considerar que a maioria dos sistemas de arquivos possuem limitações em relação à quais pontuações são suportadas em nomes de arquivos, e navegadores poderão ajustar os nomes de acordo com isso.

Nota:

Pode ser usado com blob: URLs e data: URLs, para tornar fácil aos usuários baixarem conteúdo gerado programaticamente usando JavaScript (por exemplo, uma imagem criada usando uma ferramenta de desenho web).

Se o cabeçalho HTTP Content-Disposition: estiver presente e der um nome diferente deste atributo, o cabeçalho HTTP tem prioridade sobre este atributo.

Se este atributo estiver presente e Content-Disposition: for ajustado para inline, Firefox dá prioridade para Content-Disposition, como no caso do nome do arquivo, enquanto Chrome dá prioridade para o atributo download.

No Firefox 20 este atributro só é honrado para ligações a recursos com a mesma origem do documento com o link.

href

Este é o único atributo obrigatório para âncoras definindo uma ligação para um hipertexto. Ele indica o alvo do link, seja uma URL ou um fragmento de URL. Um fragmento de URL é um nome precedido por  uma cerquilha (#), a qual especifica um destino interno (um ID) dentro do documento atual. URLs não precisam se limitar à documentos Web baseados em HTTP. URLs podem usar qualquer protocolo suportado pelo navegador. Por exemplo, file, ftp, e mailto funcionam na maioria dos navegadores.

Nota: Você pode usar o fragmento especial "top" para criar um link para o topo da página; por exemplo <a href="#top">Volte ao topo </a>. Este comportamento é especificado pelo HTML5.

hreflang

Este atributo especifica a linguagem do documento ligado. É puramente aconselhável.  Valores permitidos são determinados pelo BCP47 para HTML5 e pelo RFC1766 para HTML4. Use este atributo somente se o atributo href estiver presente.

media HTML5

Este atributo especifica o tipo de mídia para a qual o recurso linkado se aplica. Seu valor precisa ser um tipo de mídia. Este atributo é útil principalmente quando cria-se um link para uma folha de estilo externa, permitindo ao navegador escolher aquela melhor adaptada ao dispositivo em que está executando.

Nota de uso:

No HTML 4, somente uma lista com descrições de mídias simples separada por espaços como em tipos de mídia e grupos eram definidos e permitidos como valores para este atributo, como print, screen, aural, braille, ... HTML 5 estendeu isso para qualquer tipo de especificação de mídia, as quais são um superconjunto dos valores permitidos do HTML 4.

Navegadores que não suportam os tipos de mídia do CSS3 não necessariamente irão reconhecer o link adequado; não esqueça de ajustar links alternativos para o conjunto de mídia mais restrito definido em HTML 4 para garantir que algum link será reconhecido.

 

methods

O valor deste atributo fornece informação sobre as funções que podem ser realizadas sobre um objeto. Os valores normalmente são dadas pelo protocolo HTTP quando são usadas, mas elas podem (por razões similares como as do atributo "title") ser úteis para incluir informação adicional prévia para aconselhar o navegador em relação à alguma ação sobre o link. Por exemplo, o navegador pode escolher renderizar de modo diferente um link de acordo com as funções especificadas; alguma coisa que pode ser buscada pode ganhar um ícone diferente, ou um link externo pode ser renderizado de modo que indique que se está deixando o site atual. Este atributo não é bem compreendido nem suportado, nem mesmo pelo navegador que o definiu, Internet Explorer 4. Ver Propriedade de Métodos (MSDN)

name somente HTML 4, Obsolete since HTML5

Este atributo é necessário em uma âncora definindo o alvo de outra âncora dentro de uma página. Um valor para nome é similar a um valor para o atributo id e deve ser um identificador alfanumérico único para o documento. Sob a especificação HTML 4.01, id e name podem ser ambos usados com o elemento <a> desde que tenham valores idênticos.

Nota de uso: Este atributo é obsoleto em HTML5, use atributo global id no lugar.

ping HTML5

O suporte para "ping" foi desabilitado à partir do Firefox 3 beta 3. bug 415168

rel

Para âncoras contendo o atributo href, este atributo especifica qual a relação do destino do link em relação ao documento atual. O valor é uma lista separada por espaços de valores de relações possíveis. Os valores e sua semântica serão registrados por alguma autoridade que possa ter algum significado para o autor do documento. A relação padrão, se nenhuma outra for fornecida, é "void". Use este atributo somente se o atributo href estiver presente.

rev somente paraHTML 4, Obsolete since HTML5

Este atributo especifica uma ligação reversa, o relacionamento inverso ao atributo rel. Ele é útil para indicar de onde um objeto veio, bem como o autor de um documento.

shape somente para HTML 4, Obsolete since HTML5

Este atributo é utilizado para definir uma região selecionável dentro de uma imagem e transformá-la em um link, criando assim um mapeamento dentro da imagem.  Os valores possíveis para o atributo são circle, default, polygon, e rect. O formato do atributo coords depende do valor da forma, definido por este atributo. Para circle (círculo), o valor é x,y,r onde x e y são as coordenadas em pixels para o centro do círculo e r é o valor do raio em pixels. Para rect (retângulo), o atributo coords deve ser x,y,w,h. Os valores x,y definem o canto superior esquerdo do retângulo, enquanto w e h definem a largura e altura, respectivamente. Um valor polygon para shape requer valores x1,y1,x2,y2,... para coords. Cada um dos pares x,y definem um ponto no polígono, com sucessivos pontos sendo ligados por linhas retas e o último ponto se unindo ao primeiro. O valor default para formas requer que toda a área indicada, normalmente uma imagem inteira, seja usada.

 

target

Este atributo especifica onde mostrar o recurso linkado. No HTML4, o valor é um nome ou uma palavra-chave que se refere a um frame. No HTML5, é um nome ou palavra-chave que se refere a um contexto de navegação (por exemplo, aba, janela ou um frame inserido dentro de uma linha ("iframe"). As seguintes palavras-chave possuem significados especiais:

• _self: Carrega a resposta no mesmo frame HTML4 (ou contexto de navegação HTML5) em que o link está. Este é o valor padrão se o atributo não for especificado.
• _blank: Carrega a resposta em uma nova janela sem nome HTML4 ou contexto de navegação HTML5.
• _parent: Carrega a resposta no frame pai do frame atual em HTML4 ou no contexto de navegação pai do atual no HTML5. Se não existe um pai, este atributo se comporta de forma idêntica ao _self.
• _top: Em HTML4: Carrega a resposta na janela original cheia, cancelando todos os outros frames. Em HTML5:Carrega a resposta no contexto de navegação do topo (isto é, o contexto de navegação ancestral do atual, e que não tem pai). Se não existe um pai no contexto atual, esta opção se comporta de modo idêntico que_self.

Use este atributo somente se o atributo href estiver presente.

type

Este atributo especifica o tipo de mídia na forma de um tipo MIME para o link. Geralmente isso é fornecido meramente  para fins de informação; no entanto, no futuro um navegador pode adicionar um pequeno íconepara tipos multimídia. Por exemplo, um navegador pode adicionar um pequeno ícone de caixa de som quando um tipo for ajustado para audio/wav. Para uma lista completa de tipos MIME reconhecidos, veja https://www.w3.org/TR/html4/references.html#ref-MIMETYPES. Use este atributo somente se o atributo href estiver presente.

urn

Este atributo supostamente suportado pela Microsoft relaciona um nome de recurso uniforme (URN) com o link. Embora seja baseado em padrões trabalhados à anos, o significado dos URNs ainda não estão bem-definidos, então este atributo não tem nenhum sentido. Veja urn Property (MSDN).

Exemplo

<!-- âncora ligando a um arquivo externo -->
<a href="https://www.mozilla.com/">
Link Externo
</a>

Resultado

Link Externo

Especificações

Navegadores compatíveis

Notas

As seguintes teclas são reservadas para atalhos de teclado dos navegadores e não devem ser usadas como valores para o atributo accesskey: a, c, e, f, g, h, , v, seta esquerda e seta direita.

HTML 3.2 define somente name, href, rel, rev, e title.

O atributo target não é definido em navegadores que não suportam frames, tais como navegadores da geração Netscape 1. Além disso, target não é permitido sob variantes estritas de  XHTML sendo limitado a framesets ou formulários de transição.

Recomendações de JavaScript

Frequentemente uma âncora é usada com o atributo de evento onclick. De modo a impedir que a página seja recarregada, href é frequentemente ajustada para "#" ou "javascript:void(0)". Ambos os valores podem levar a erros inesperados quando links são copiados e abertos em uma nova aba ou janela. Esteja ciente disso por razões de usabilidade, ao fazer isso você previne o comportamento padrão de links.

Veja também

• Outros elementos que envolvem semântica à nível de texto:<abbr>, <em>, <strong>, <small>, <cite>, <q>, <dfn>, <time>, <code>, <var>, <samp>, <kbd>, <sub>, <sup>, <b>, <i>, <mark>, <ruby>, <rp>, <rt>, <bdo>, <span>, <br>, <wbr>.