Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLAnchorElement: adres href i cel target

HTMLAnchorElement reprezentuje odnośnik w DOM przeglądarki. Właściwość href określa adres zasobu, a target wskazuje kontekst przeglądania, w którym ma zostać otwarty. Poznaj różnicę między właściwością href a atrybutem oraz znaczenie _blank.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const anchor = document.createElement("a");
anchor.href = "https://example.com/guide";
anchor.target = "_blank";
anchor.rel = "noopener";

HTMLAnchorElement to interfejs DOM elementu odnośnika a, dziedziczący po HTMLElement. Właściwości odnośnika odpowiadają na dwa osobne pytania: dokąd prowadzi odnośnik (href) i gdzie ma zostać wyświetlony zasób (target). To Web API przeglądarki, a nie część samego ECMAScript; wersja Node.js w repozytorium nie potwierdza jego dostępności.

Ustawienie anchor.href aktualizuje atrybut href. Przy odczycie poprawny adres względny jest rozwiązywany względem bazowego URL dokumentu, natomiast anchor.getAttribute("href") zwraca zapis atrybutu bez tego przekształcenia. Jeśli atrybutu nie ma, anchor.href zwraca pusty ciąg. Jeśli atrybut jest obecny, ale pusty, jego wartość jest rozwiązywana względem bazowego URL dokumentu. Przy hierarchicznym URL bazowym wynik nie zawiera fragmentu, nawet jeśli adres bazowy go zawiera. Przy nieprzezroczystym URL bazowym, takim jak data:, rozwiązywanie może się nie powieść; wtedy anchor.href również zwraca pusty ciąg. Niepoprawny URL może zostać zwrócony bez zmian: odczyt href nie jest walidacją bezpieczeństwa.

anchor.target odzwierciedla atrybut target. _self wskazuje bieżący kontekst, _blank nowy, _parent nadrzędny, a _top najwyższy. Bez odpowiedniego przodka _parent i _top działają jak _self. Wartość może też wskazywać nazwany kontekst. _blank nie gwarantuje karty zamiast okna — zależy to od ustawień przeglądarki.

Dla _blank można jawnie ustawić anchor.rel = "noopener", aby odciąć dostęp przez window.opener; współczesne przeglądarki zapewniają to również domyślnie dla _blank. Widoczny tekst odnośnika powinien uprzedzać o nowej karcie lub oknie. Samo przypisanie właściwości nie uruchamia nawigacji. MDN oznacza href i target jako szeroko dostępne od lipca 2015 r.; nie oznacza to identycznego wsparcia wszystkich funkcji HTMLAnchorElement.

Przykłady

const anchor = document.createElement("a");
anchor.href = "https://example.com/guide";
anchor.target = "_blank";
anchor.rel = "noopener";

console.log(anchor.href);
console.log(anchor.getAttribute("href"));
console.log(anchor.target);

Wynik

https://example.com/guide
https://example.com/guide
_blank

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

Źródła