Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

href — adres odnośnika lub bazowy URL

Atrybut href określa adres URL używany przez elementy a, area, link i base. Jego znaczenie zależy od elementu: wskazuje cel hiperłącza, adres powiązanego zasobu albo bazowy URL dokumentu. Adresy względne są rozwiązywane względem bazowego URL.

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

Składnia

href="URL"

href nie jest atrybutem globalnym. W elementach a i area określa cel hiperłącza; bez niego te elementy nie tworzą hiperłączy. Wartość musi być poprawnym URL-em, opcjonalnie otoczonym spacjami. Może być bezwzględna albo względna, także w postaci fragmentu, takiego jak #intro.

W elemencie link atrybut href wskazuje adres powiązanego zasobu, a rel określa rodzaj relacji, na przykład stylesheet. Jeśli href występuje, jego URL musi być niepusty. Element link musi mieć co najmniej jeden z atrybutów href lub imagesrcset; samo href nie określa sposobu przetwarzania zasobu.

W elemencie base atrybut href określa bazowy URL dokumentu, używany do rozwiązywania adresów względnych. Dokument może zawierać najwyżej jeden element base. Jeśli ma on href, musi poprzedzać inne elementy z atrybutami przyjmującymi URL-e. Zmienia również sposób rozwiązywania odnośników fragmentowych, takich jak #intro.

W przykładzie getAttribute('href') zwraca zapisaną wartość atrybutu, a właściwość guide.href zwraca zserializowany, rozwiązany URL. Jawny base uniezależnia wynik od miejsca zapisania pliku. Puste href="" w a nie jest tym samym co brak atrybutu: nadal tworzy hiperłącze.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła