CKTIS / HTML
ping — verifica dei collegamenti ipertestuali
L’attributo ping degli elementi a e area elenca gli URL a cui inviare una notifica quando si segue un collegamento ipertestuale. Non modifica la destinazione href e il browser può sopprimere le notifiche.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
ping="URL [URL ...]"ping consente di verificare l’uso dei collegamenti ipertestuali negli elementi a e area. href specifica la destinazione della navigazione, mentre ping indica i destinatari delle notifiche. Senza href, l’elemento non crea un collegamento ipertestuale.
Il valore è un elenco di URL separati da spazi ASCII, non da virgole. Ogni elemento deve essere un URL valido e non vuoto con schema HTTP(S). Gli URL relativi vengono risolti rispetto al documento.
Quando l’utente segue il collegamento ipertestuale, il browser può inviare a ciascun destinatario una richiesta POST con Content-Type: text/ping e corpo PING, indipendentemente dall’esito della navigazione. I corpi delle risposte vengono ignorati.
È un meccanismo di tracciamento dell’attività: in base alle preferenze dell’utente, il browser può sopprimere tutte le notifiche o solo alcune. Non considerare ping una prova garantita di una visita e non fare dipendere il corretto funzionamento dell’applicazione da questo attributo.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="Content-Security-Policy" content="connect-src 'none'">
<title>Hyperlink auditing targets</title>
</head>
<body>
<a id="continue" href="#destination" ping="./audit-one ./audit-two">Continue</a>
<p id="destination">Destination</p>
<script>
const link = document.getElementById('continue');
for (const type of ['click', 'auxclick']) {
link.addEventListener(type, event => event.preventDefault());
}
const targets = link.ping.match(/[^\t\n\f\r ]+/g) ?? [];
console.log('Ping targets: ' + targets.join(', '));
console.log('Link destination: ' + link.hash);
</script>
</body>
</html>Risultato
Ping targets: ./audit-one, ./audit-two Link destination: #destination
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.