Kendalikan roda dengan JavaScript
Kode yang disalin dapat bekerja sendiri. Jika menulis kode halaman sendiri, Anda juga dapat memulai putaran, mengubah entri, dan membaca setiap pemenang melalui pesan antarjendela, tanpa melonggarkan sandbox frame.
Mulai putaran dan baca pemenangnya
Tambahkan <button id="spin-from-page" type="button" disabled>Spin</button> ke halaman Anda dan letakkan skrip ini setelah kode sematan. Roda mengabaikan perintah sampai mengirim ready, jadi tombol tetap nonaktif hingga saat itu.
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"));
Tindakan yang dapat dikirim
spin memulai putaran
setEntries mengganti entri dengan array entries berisi 2 hingga 100 string
addEntry menambahkan satu string entry
removeWinner menghapus pemenang terbaru
reset mengembalikan entri dari kode
Peristiwa yang diterima
ready, spin-start, spin-end dengan winner dan index, entries-changed, serta error. Masing-masing juga melaporkan jumlah entri saat ini dalam count.
Tiga aturan yang perlu diketahui
Kirim pesan dengan "*" sebagai target, karena frame yang dibatasi sandbox tidak memiliki origin yang dapat disebutkan. Pesan tetap hanya dikirim ke frame tersebut. Saat pesan kembali, origin-nya terbaca "null", jadi percayai hanya jika event.source juga merupakan jendela frame itu. Roda hanya mendengarkan halaman yang menyematkannya dan menjawab perintah dengan format salah melalui peristiwa error. Biarkan atribut sandbox dan referrerpolicy yang dihasilkan tetap apa adanya: perintah biasa memerlukan origin halaman induk yang diketahui dari referrer. Jika pemuatan ulang menghilangkan referrer tersebut, helper pengembang opsional dapat menghubungkan kembali melalui handshake tervalidasi dari halaman induk HTTPS yang sebenarnya.