Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLAnchorElement: indirizzo del link e destinazione della navigazione

`href` imposta l’indirizzo del link; `target` indica al browser quale contesto di navigazione usare quando si segue il link.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

anchor.href;                      // Reads the URL property
anchor.href = urlString;           // Sets the href attribute
anchor.target;                    // Reads the target attribute as a string
anchor.target = targetName;       // Sets the target attribute
anchor.getAttribute("href");       // Reads the stored value or null
anchor.getAttribute("target");     // Reads the stored value or null

href e target sono proprietà di lettura e scrittura di un elemento a. Appartengono al DOM della piattaforma web, non a ECMAScript 2024. Assegnare un valore aggiorna il relativo attributo HTML senza avviare la navigazione.

In lettura, anchor.href restituisce una stringa con l’URL assoluto, risolto rispetto all’URL di base attuale del documento, che può essere impostato da un elemento base. Se manca l’attributo href, la proprietà restituisce "" e l’elemento non crea un collegamento ipertestuale. Se il parsing dell’URL fallisce, la proprietà restituisce il valore dell’attributo senza modificarlo e senza generare un’eccezione. Un attributo presente ma vuoto è un riferimento relativo vuoto, non un indirizzo assente. getAttribute("href") restituisce il valore memorizzato o null se l’attributo è assente.

anchor.target restituisce il valore memorizzato, oppure "" se l’attributo manca, non la destinazione effettiva della navigazione. Quando si segue il link, in assenza dell’attributo si può usare la destinazione predefinita di base; se manca anche quella si usa il contesto corrente. _self indica il contesto corrente, _parent il contesto padre e _top quello di livello più alto. _blank richiede un nuovo contesto, senza imporre una scheda anziché una finestra. Un nome può selezionare un contesto esistente con quel nome, per esempio un iframe.

Secondo lo standard HTML attuale, _blank implica il comportamento di rel="noopener", a meno che si richieda esplicitamente un contesto di apertura con rel="opener". Impostare rel="noopener" impedisce al nuovo contesto di ottenere tramite window.opener un riferimento al contesto che lo ha aperto; rel="noreferrer" omette anche le informazioni sulla provenienza.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLAnchorElement: href and target</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument();
    const base = doc.createElement("base");
    base.href = "https://example.com/course/";
    base.target = "_self";
    doc.head.append(base);

    const anchor = doc.createElement("a");
    console.log(JSON.stringify([anchor.href, anchor.getAttribute("href")]));

    anchor.href = "lesson-38#demo";
    console.log(JSON.stringify([anchor.getAttribute("href"), anchor.href]));
    console.log(JSON.stringify([anchor.target, anchor.getAttribute("target")]));

    anchor.target = "_blank";
    console.log(JSON.stringify([anchor.target, anchor.getAttribute("target")]));
  </script>
</body>
</html>

Risultato

["",null]
["lesson-38#demo","https://example.com/course/lesson-38#demo"]
["",null]
["_blank","_blank"]

Salva l’esempio come file HTML, aprilo in un browser e controlla l’output nella console. Un documento separato fissa l’URL di base. Confronta le proprietà con i valori degli attributi: la destinazione predefinita del documento non compare in `anchor.target`. Il codice non apre il link.

Lezioni correlate

  • JavaScript · Lezione 38 · Avanzato · Versione: 4

Fonti