KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

href — linkadres of basis-URL

Het href-attribuut geeft een URL op die wordt gebruikt door a-, area-, link- en base-elementen. De betekenis hangt af van het element: het geeft het doel van een hyperlink, het adres van een gerelateerde bron of de basis-URL van het document aan. Relatieve URL’s worden afgezet tegen de basis-URL.

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

Syntax

href="URL"

href is geen globaal attribuut. Bij a en area geeft het het doel van een hyperlink aan; zonder dit attribuut maken deze elementen geen hyperlinks. De waarde moet een geldige URL zijn, eventueel omgeven door spaties. De URL kan absoluut of relatief zijn, waaronder een fragment zoals #intro.

Bij link geeft href het adres van een gerelateerde bron aan, terwijl rel de relatie specificeert, bijvoorbeeld stylesheet. Als href aanwezig is, mag de URL daarin niet leeg zijn. Een link-element moet ten minste een van de attributen href of imagesrcset hebben; alleen href bepaalt niet hoe de bron wordt verwerkt.

Bij base geeft href de basis-URL van het document aan, die wordt gebruikt om relatieve URL’s op te lossen. Een document mag hoogstens één base-element bevatten. Als dit element href heeft, moet het vóór andere elementen met URL-waarden staan. Het verandert ook hoe fragmentkoppelingen zoals #intro worden opgelost.

In het voorbeeld geeft getAttribute('href') de opgeslagen attribuutwaarde terug, terwijl de eigenschap guide.href de geserialiseerde, opgeloste URL teruggeeft. De expliciete base maakt het resultaat onafhankelijk van de locatie waar het bestand wordt opgeslagen. Een lege href="" bij a is niet hetzelfde als het weglaten van het attribuut: er wordt nog steeds een hyperlink gemaakt.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen