HTMLImageElement : propriété attributionSrc
Obsolète
En cours de suppression
Cette fonctionnalité est en cours de suppression des navigateurs. L'utiliser maintenant peut entraîner un dysfonctionnement dans les futures mises à jour. Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the attribution reporting API.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
La propriété attributionSrc de l'interface HTMLImageElement permet d'indiquer que vous souhaitez que le navigateur envoie un en-tête Attribution-Reporting-Eligible avec la requête d'image. Elle reflète l'attribut de contenu attributionsrc de l'élément HTML <img>.
Voir l'API Attribution Reporting pour plus de détails.
Valeur
Une chaîne de caractères vide ou une liste d'URL séparées par des espaces. Pour l'interprétation de cet attribut, voir la référence HTML <img>.
Exemples
Définir un attributionSrc vide
<img src="advertising-image.png" />
const imgElem = document.querySelector("img");
imgElem.attributionSrc = "";
Définir un attributionSrc contenant des URL
<img src="advertising-image.png" />
// Encoder les URL au cas où elles contiendraient des caractères spéciaux
// comme '=' qui seraient mal interprétés.
const encodedUrlA = encodeURIComponent("https://a.example/register-source");
const encodedUrlB = encodeURIComponent("https://b.example/register-source");
const imgElem = document.querySelector("img");
imgElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;