Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLAnchorElement: indirizzo href e destinazione target

HTMLAnchorElement rappresenta un collegamento ipertestuale nel DOM del browser. La proprietà href specifica l’indirizzo della risorsa, mentre target seleziona il contesto di navigazione in cui aprirla. Scopri la differenza tra la proprietà href e l’attributo e il significato di _blank.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

const anchor = document.createElement("a");
anchor.href = "https://example.com/guide";
anchor.target = "_blank";
anchor.rel = "noopener";

HTMLAnchorElement è l’interfaccia DOM dell’elemento di collegamento ipertestuale a ed eredita da HTMLElement. Due proprietà del collegamento consentono di scegliere separatamente dove porta (href) e dove deve comparire la risorsa (target). È una Web API del browser, non una parte di ECMAScript; la versione di Node.js nel repository non ne dimostra la disponibilità.

Impostare anchor.href aggiorna l’attributo href. Quando viene letto, un indirizzo relativo valido è risolto rispetto all’URL di base del documento, mentre anchor.getAttribute("href") restituisce il testo memorizzato nell’attributo senza questa trasformazione. Se l’attributo manca, anchor.href restituisce una stringa vuota. Se l’attributo è presente ma vuoto, il suo valore viene risolto rispetto all’URL di base del documento. Con un URL di base gerarchico, il risultato non conserva l’eventuale frammento dell’URL di base. Con un URL di base opaco, come un URL data:, la risoluzione può fallire; in tal caso, anchor.href restituisce comunque una stringa vuota. Un URL non valido può essere restituito senza modifiche: leggere href non è una convalida di sicurezza.

anchor.target riflette l’attributo target. _self seleziona il contesto corrente, _blank uno nuovo, _parent quello genitore e _top quello più alto. Se manca l’antenato corrispondente, _parent e _top si comportano come _self. Il valore può anche indicare un contesto con nome. _blank non garantisce l’apertura in una scheda anziché in una finestra; la scelta dipende dalle impostazioni del browser.

Per _blank, puoi impostare esplicitamente anchor.rel = "noopener" per impedire l’accesso tramite window.opener; i browser moderni lo fanno anche implicitamente per _blank. Il testo visibile del collegamento dovrebbe avvisare della nuova scheda o finestra. La sola assegnazione delle proprietà non avvia la navigazione. MDN indica che href e target sono ampiamente disponibili da luglio 2015; ciò non implica che tutte le funzionalità di HTMLAnchorElement siano supportate allo stesso modo.

Esempi

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);

Risultato

https://example.com/guide
https://example.com/guide
_blank

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti