Piloter la roue avec JavaScript
Le code copié fonctionne tel quel. Si vous écrivez vous-même le code de votre page, vous pouvez aussi lancer des tours, modifier les entrées et lire chaque gagnant grâce à des messages entre fenêtres, sans assouplir le sandbox de l’iframe.
Lancer un tour et lire le gagnant
Ajoutez <button id="spin-from-page" type="button" disabled>Spin</button> à votre page et placez ce script après le code d’intégration. La roue ignore les commandes tant qu’elle n’a pas envoyé ready : le bouton reste donc désactivé jusque-là.
const frame = document.querySelector('iframe[src^="https://choicespin.com/e"]');
const spinButton = document.querySelector("#spin-from-page");
// Every message carries the same channel and version.
function send(action, extra = {}) {
frame.contentWindow.postMessage(
{ channel: "choicespin.embed", version: 1, action, ...extra },
"*"
);
}
window.addEventListener("message", (event) => {
if (event.source !== frame.contentWindow || event.origin !== "null") return;
const data = event.data;
if (data?.channel !== "choicespin.embed" || data?.version !== 1) return;
if (data.event === "ready") spinButton.disabled = false;
if (data.event === "spin-end") console.log("Winner:", data.winner);
});
spinButton.addEventListener("click", () => send("spin"));
Actions que vous pouvez envoyer
spin lance un tour
setEntries remplace les entrées par un tableau entries de 2 à 100 chaînes de caractères
addEntry ajoute une chaîne entry
removeWinner retire le dernier gagnant
reset rétablit les entrées du code d’intégration
Événements que vous recevez
ready, spin-start, spin-end avec winner et index, entries-changed et error. Chacun indique aussi le nombre actuel d’entrées dans count.
Trois règles à connaître
Envoyez les messages avec "*" comme cible, car un iframe isolé (sandbox) n’a pas d’origine que vous pourriez nommer. Le message n’est tout de même transmis qu’à ce seul iframe. Quand un message revient, son origine vaut "null" : ne lui faites donc confiance que si event.source est bien la fenêtre de l’iframe. La roue n’écoute que la page qui l’intègre et répond à une commande mal formée par un événement error. Conservez tels quels les attributs sandbox et referrerpolicy générés : les commandes ordinaires ont besoin de l’origine de la page parente, déduite du référent. Si un rechargement supprime ce référent, le script d’aide pour développeurs facultatif peut rétablir la connexion grâce à une poignée de main validée, émise par la véritable page parente en HTTPS.