CKTIS / HTML
href — endereço da ligação ou URL base
O atributo href especifica um URL utilizado pelos elementos a, area, link e base. O seu significado depende do elemento: identifica o destino de uma hiperligação, o endereço de um recurso relacionado ou o URL base do documento. Os URL relativos são resolvidos com base no URL base.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
href="URL"href não é um atributo global. Em a e area, especifica o destino de uma hiperligação; sem ele, estes elementos não criam hiperligações. O seu valor tem de ser um URL válido, podendo estar rodeado de espaços. Pode ser absoluto ou relativo, incluindo um fragmento como #intro.
Em link, href identifica o endereço de um recurso relacionado, enquanto rel especifica a relação, como stylesheet. Quando href está presente, o URL nele indicado não pode estar vazio. Um elemento link tem de ter pelo menos um dos atributos href ou imagesrcset; href, por si só, não determina a forma como o recurso é processado.
Em base, href especifica o URL base do documento, utilizado para resolver URL relativos. Um documento pode conter, no máximo, um elemento base. Se tiver href, este tem de preceder outros elementos com atributos cujo valor seja um URL. Também altera a forma como são resolvidas ligações a fragmentos, como #intro.
No exemplo, getAttribute('href') devolve o valor armazenado do atributo, enquanto a propriedade guide.href devolve o URL resolvido e serializado. O base explícito torna o resultado independente do local onde o ficheiro é guardado. Um href="" vazio em a não equivale à omissão do atributo: continua a criar uma hiperligação.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>href example</title>
<base href="https://example.org/docs/">
</head>
<body>
<a id="guide" href="guide.html#intro">Guide</a>
<pre id="result"></pre>
<script>
const guide = document.getElementById('guide');
document.getElementById('result').textContent =
guide.getAttribute('href') + '\n' + guide.href;
</script>
</body>
</html>Resultado
guide.html#intro https://example.org/docs/guide.html#intro
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.