CKTIS / JavaScript
HTMLAnchorElement: adres łącza i cel nawigacji
`href` określa adres łącza, a `target` wskazuje kontekst przeglądania, w którym łącze ma się otworzyć.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
anchor.href; // Reads the URL property
anchor.href = urlString; // Sets the href attribute
anchor.target; // Reads the target attribute as a string
anchor.target = targetName; // Sets the target attribute
anchor.getAttribute("href"); // Reads the stored value or null
anchor.getAttribute("target"); // Reads the stored value or nullhref i target to właściwości do odczytu i zapisu elementu a. Należą do interfejsu DOM platformy WWW, a nie do ECMAScript 2024. Samo przypisanie wartości zmienia odpowiedni atrybut HTML, ale nie uruchamia nawigacji.
Przy odczycie anchor.href przeglądarka zwraca bezwzględny adres URL, wyznaczony względem bieżącego bazowego URL dokumentu, który może ustawić element base. Bez atrybutu href właściwość zwraca "", a element nie tworzy hiperłącza. Jeśli atrybut istnieje, ale nie daje się zinterpretować jako URL, właściwość zwraca jego wartość bez zmian, zamiast zgłaszać wyjątek. Obecny, lecz pusty atrybut jest pustym odwołaniem względnym, nie brakiem adresu. getAttribute("href") zwraca zapisaną wartość lub null, jeśli atrybutu nie ma.
anchor.target zwraca zapisaną wartość, a przy braku atrybutu "", nie faktyczny cel nawigacji. Przy podążaniu za łączem brak atrybutu pozwala użyć domyślnego celu ustawionego przez base; bez takiego ustawienia domyślny jest bieżący kontekst. _self oznacza bieżący kontekst, _parent nadrzędny, a _top najwyższy. _blank żąda nowego kontekstu, ale nie gwarantuje karty zamiast okna. Nazwa może wskazać istniejący nazwany kontekst, np. ramkę iframe.
Zgodnie z obecnym standardem HTML _blank domyślnie działa jak rel="noopener", chyba że jawnie użyto rel="opener". Jawne rel="noopener" zapobiega udostępnieniu nowemu kontekstowi odwołania do strony otwierającej przez window.opener; rel="noreferrer" dodatkowo nie przekazuje informacji o stronie odsyłającej.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTMLAnchorElement: href and target</title>
</head>
<body>
<script>
const doc = document.implementation.createHTMLDocument();
const base = doc.createElement("base");
base.href = "https://example.com/course/";
base.target = "_self";
doc.head.append(base);
const anchor = doc.createElement("a");
console.log(JSON.stringify([anchor.href, anchor.getAttribute("href")]));
anchor.href = "lesson-38#demo";
console.log(JSON.stringify([anchor.getAttribute("href"), anchor.href]));
console.log(JSON.stringify([anchor.target, anchor.getAttribute("target")]));
anchor.target = "_blank";
console.log(JSON.stringify([anchor.target, anchor.getAttribute("target")]));
</script>
</body>
</html>Wynik
["",null] ["lesson-38#demo","https://example.com/course/lesson-38#demo"] ["",null] ["_blank","_blank"]
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. Osobny dokument ustala bazowy URL. Porównaj wartości właściwości z wartościami atrybutów: domyślny cel dokumentu nie pojawia się w `anchor.target`. Kod nie otwiera łącza.
Powiązane lekcje
- JavaScript · Lekcja 38 · Zaawansowany · Wersja: 4