CKTIS / HTML
href — naslov povezave ali osnovni URL
Atribut href določa URL, ki ga uporabljajo elementi a, area, link in base. Njegov pomen je odvisen od elementa: označuje cilj hiperpovezave, naslov povezanega vira ali osnovni URL dokumenta. Relativni URL-ji se razrešijo glede na osnovni URL.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
href="URL"href ni globalni atribut. Pri elementih a in area določa cilj hiperpovezave; brez njega ti elementi ne ustvarijo hiperpovezav. Njegova vrednost mora biti veljaven URL, ki je lahko obdan s presledki. URL je lahko absoluten ali relativen, tudi v obliki fragmenta, kot je #intro.
Pri elementu link href določa naslov povezanega vira, rel pa določa vrsto povezave, na primer stylesheet. Če je href prisoten, URL v njem ne sme biti prazen. Element link mora imeti vsaj enega od atributov href ali imagesrcset; sam href ne določa, kako se vir obdela.
Pri elementu base href določa osnovni URL dokumenta, ki se uporablja za razreševanje relativnih URL-jev. Dokument lahko vsebuje največ en element base. Če ima atribut href, mora biti pred drugimi elementi z atributi, katerih vrednosti so URL-ji. Spremeni tudi način razreševanja povezav na fragmente, kot je #intro.
V primeru getAttribute('href') vrne shranjeno vrednost atributa, lastnost guide.href pa vrne serializiran, razrešen URL. Izrecni base zagotavlja, da rezultat ni odvisen od mesta, kamor je datoteka shranjena. Prazen href="" pri a ni enakovreden izpuščenemu atributu: še vedno ustvari hiperpovezavo.
Primeri
<!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>Rezultat
guide.html#intro https://example.org/docs/guide.html#intro
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.