Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLAnchorElement.target — destinazione di un collegamento

Leggi o imposta l’attributo `target` di un collegamento e distingui il valore memorizzato dal contesto di navigazione scelto dal browser quando segui il link.

Versione: Current web platform; runtime support varies

Sintassi

anchor.target
anchor.target = targetNameOrKeyword;

HTMLAnchorElement.target è una proprietà DOM di lettura e scrittura di un elemento a. In lettura restituisce il testo dell’attributo target, oppure la stringa vuota "" se l’attributo è assente. Assegnare una stringa imposta l’attributo senza avviare la navigazione. href indica l’URL del collegamento, mentre target indica dove aprirlo.

_self seleziona il contesto di navigazione corrente, _parent seleziona quello genitore (o quello corrente se non esiste un genitore) e _top seleziona quello di livello superiore. _blank richiede un nuovo contesto, non necessariamente una nuova scheda. Un nome come report può selezionare un frame esistente con quel nome. Se non c’è una corrispondenza utilizzabile, il browser può aprire un nuovo contesto. Le impostazioni del browser e le restrizioni di sandbox possono influire sul risultato.

Se nel link manca l’attributo target, la navigazione usa il valore del primo elemento base che possiede quell’attributo, se esiste. Senza tale valore predefinito, la destinazione ordinaria è il contesto corrente. Con anchor.target = '' l’attributo resta presente ma vuoto e il valore di base non viene usato. Usa getAttribute('target') per distinguere l’assenza (null) dal valore vuoto ("") e removeAttribute('target') per ripristinare il ricorso al valore predefinito.

Per la navigazione con _blank, lo standard applica noopener per impostazione predefinita: la nuova pagina non può accedere, tramite window.opener, alla pagina che l’ha aperta. rel="opener" disattiva questa protezione predefinita; rel="noopener" la mantiene esplicitamente. È un’API della piattaforma web, non una funzionalità di ECMAScript 2024. Un ambiente di esecuzione senza DOM non la fornisce automaticamente.

Esempi

<!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>

Risultato

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

Salva l’esempio come file HTML e aprilo in un browser. Ogni riga nella console del browser mostra il valore della proprietà seguito da quello dell’attributo. Il codice non inserisce né attiva il collegamento.

Lezioni correlate

  • JavaScript · Lezione 37 · Avanzato · Versione: 4

Fonti