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.