CKTIS / HTML
ping — praćenje hiperveza
Atribut ping elemenata a i area sadrži URL-ove na koje se može poslati obavijest kada se slijedi hiperveza. Ne mijenja odredište href, a preglednik može potisnuti obavijesti.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
ping="URL [URL ...]"ping omogućuje praćenje hiperveza na elementima a i area. href određuje odredište navigacije, dok ping navodi primatelje obavijesti. Bez href element ne stvara hipervezu.
Vrijednost je popis URL-ova razdvojenih ASCII razmacima, a ne zarezima. Svaki token mora biti valjan, neprazan URL sa shemom HTTP(S). Relativni URL-ovi razrješavaju se u odnosu na dokument.
Kada korisnik slijedi hipervezu, preglednik može svakom primatelju poslati zahtjev POST s Content-Type: text/ping i tijelom PING, neovisno o ishodu navigacije. Tijela odgovora zanemaruju se.
Riječ je o mehanizmu praćenja aktivnosti: preglednik može, ovisno o korisničkim postavkama, potisnuti sve obavijesti ili samo neke. Nemojte smatrati ping zajamčenim dokazom posjeta niti o njemu ovisiti ispravno funkcioniranje aplikacije.
Primjeri
<!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>Rezultat
Ping targets: ./audit-one, ./audit-two Link destination: #destination
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.