Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

href — indirizzo del collegamento o URL di base

L’attributo href specifica un URL usato dagli elementi a, area, link e base. Il suo significato dipende dall’elemento: indica la destinazione di un collegamento ipertestuale, l’indirizzo di una risorsa correlata o l’URL di base del documento. Gli URL relativi vengono risolti rispetto all’URL di base.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

href="URL"

href non è un attributo globale. Su a e area specifica la destinazione di un collegamento ipertestuale; senza di esso, questi elementi non creano collegamenti ipertestuali. Il suo valore deve essere un URL valido, eventualmente circondato da spazi. Può essere assoluto o relativo, anche sotto forma di frammento come #intro.

Su link, href indica l’indirizzo di una risorsa correlata, mentre rel specifica il tipo di relazione, per esempio stylesheet. Se href è presente, l’URL che contiene non deve essere vuoto. Un elemento link deve avere almeno uno tra gli attributi href e imagesrcset; href da solo non determina come viene elaborata la risorsa.

Su base, href specifica l’URL di base del documento, usato per risolvere gli URL relativi. Un documento può contenere al massimo un elemento base. Se ha href, deve precedere gli altri elementi con attributi il cui valore è un URL. Cambia anche il modo in cui vengono risolti i collegamenti a frammenti come #intro.

Nell’esempio, getAttribute('href') restituisce il valore memorizzato dell’attributo, mentre la proprietà guide.href restituisce l’URL risolto e serializzato. Il base esplicito rende il risultato indipendente dal percorso in cui viene salvato il file. Un href="" vuoto su a non equivale all’assenza dell’attributo: crea comunque un collegamento ipertestuale.

Esempi

<!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>

Risultato

guide.html#intro
https://example.org/docs/guide.html#intro

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti