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