Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLAnchorElement.target — cel nawigacji odsyłacza

Odczytuj i ustawiaj atrybut `target` odsyłacza. Odróżniaj zapisaną wartość od kontekstu, który przeglądarka wybierze po użyciu odsyłacza.

Wersja: Current web platform; runtime support varies

Składnia

anchor.target
anchor.target = targetNameOrKeyword;

HTMLAnchorElement.target to właściwość DOM do odczytu i zapisu dostępna na elemencie a. Odczyt zwraca tekst atrybutu target albo pusty ciąg "", gdy atrybutu nie ma. Przypisanie ciągu ustawia atrybut, ale nie uruchamia nawigacji. Adres odsyłacza określa href; target określa, gdzie ten adres ma zostać otwarty.

_self wskazuje bieżący kontekst przeglądania, _parent — nadrzędny (lub bieżący, jeśli nadrzędnego nie ma), a _top — kontekst najwyższego poziomu. _blank żąda nowego kontekstu, niekoniecznie nowej karty. Nazwa taka jak report może wskazać istniejącą ramkę o tej nazwie; bez dostępnego dopasowania przeglądarka może otworzyć nowy kontekst. Ustawienia przeglądarki i ograniczenia sandbox mogą wpłynąć na wynik.

Jeśli odsyłacz nie ma atrybutu target, podczas nawigacji stosuje się wartość z pierwszego elementu base z tym atrybutem, jeśli taki istnieje. Bez takiej wartości zwykłym celem jest bieżący kontekst. Jawne anchor.target = '' pozostawia pusty atrybut i pomija wartość z base. Użyj getAttribute('target'), aby odróżnić brak (null) od pustej wartości (""), a removeAttribute('target'), aby przywrócić stosowanie wartości domyślnej.

Jeśli celem nawigacji jest _blank, standard stosuje domyślnie zachowanie noopener, więc nowa strona nie otrzymuje dostępu do strony otwierającej przez window.opener. rel="opener" znosi tę domyślną ochronę; jawne rel="noopener" ją zachowuje. To API platformy WWW, a nie funkcja ECMAScript 2024; środowisko bez DOM nie udostępnia go automatycznie.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLAnchorElement.target</title>
</head>
<body>
  <script>
    const anchor = document.createElement('a');
    anchor.href = '#demo';
    const log = () => console.log(JSON.stringify([
      anchor.target, anchor.getAttribute('target')
    ]));

    log();
    anchor.target = '_blank';
    log();
    anchor.setAttribute('target', 'report');
    log();
    anchor.target = '';
    log();
    anchor.removeAttribute('target');
    log();
  </script>
</body>
</html>

Wynik

["",null]
["_blank","_blank"]
["report","report"]
["",""]
["",null]

Zapisz przykład jako plik HTML i otwórz go w przeglądarce. Każdy wiersz w konsoli pokazuje kolejno wartość właściwości i atrybutu. Kod nie wstawia ani nie aktywuje odsyłacza.

Powiązane lekcje

  • JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4

Źródła