Steruj kołem za pomocą JavaScriptu
Skopiowany kod działa samodzielnie. Jeśli piszesz własny kod strony, możesz też uruchamiać losowanie, zmieniać opcje i odczytywać każdego zwycięzcę za pomocą komunikatów między oknami, bez osłabiania izolacji ramki.
Uruchom losowanie i odczytaj zwycięzcę
Dodaj <button id="spin-from-page" type="button" disabled>Spin</button> do swojej strony i umieść ten skrypt po kodzie do osadzenia. Koło ignoruje polecenia, dopóki nie wyśle ready, więc do tego czasu przycisk pozostaje wyłączony.
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"));
Akcje, które możesz wysłać
spin uruchamia losowanie
setEntries zastępuje opcje tablicą entries zawierającą od 2 do 100 ciągów znaków
addEntry dodaje jeden ciąg znaków entry
removeWinner usuwa ostatniego zwycięzcę
reset przywraca opcje z kodu
Zdarzenia, które otrzymujesz
ready, spin-start, spin-end z polami winner i index, entries-changed oraz error. Każde z nich podaje też aktualną liczbę opcji w polu count.
Trzy zasady, które warto znać
Wysyłaj komunikaty z "*" jako celem, bo izolowana ramka nie ma pochodzenia (origin), które dałoby się podać. Komunikat i tak trafia tylko do tej jednej ramki. Gdy przychodzi odpowiedź, jej pochodzenie ma wartość "null", więc ufaj jej tylko wtedy, gdy event.source jest też oknem tej ramki. Koło nasłuchuje tylko strony, która je osadza, a na nieprawidłowe polecenie odpowiada zdarzeniem error. Zachowaj wygenerowane atrybuty sandbox i referrerpolicy bez zmian: zwykłe polecenia wymagają pochodzenia strony nadrzędnej, odczytanego z referrera. Jeśli po odświeżeniu referrera zabraknie, opcjonalny skrypt pomocniczy dla programistów może ponownie nawiązać połączenie przez zweryfikowany handshake z rzeczywistej strony nadrzędnej HTTPS.