Kawal roda dengan JavaScript
Kod yang disalin berfungsi dengan sendirinya. Jika anda menulis kod halaman sendiri, anda juga boleh memulakan putaran, menukar pilihan dan membaca setiap pemenang melalui mesej tetingkap, tanpa melonggarkan kotak pasir bingkai.
Mulakan putaran dan baca pemenang
Tambah <button id="spin-from-page" type="button" disabled>Spin</button> pada halaman anda, dan letakkan skrip ini selepas kod benam. Roda mengabaikan arahan sehingga ia menghantar ready, jadi butang itu kekal dinyahdayakan sehingga masa 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 boleh anda hantar
spin memulakan putaran
setEntries menggantikan pilihan dengan tatasusunan entries yang mengandungi 2 hingga 100 rentetan
addEntry menambah satu rentetan entry
removeWinner membuang pemenang terkini
reset mengembalikan pilihan daripada kod
Peristiwa yang anda terima
ready, spin-start, spin-end dengan winner dan index, entries-changed dan error. Setiap satu juga melaporkan count pilihan semasa.
Tiga peraturan yang perlu diketahui
Hantar mesej dengan "*" sebagai sasaran, kerana bingkai berkotak pasir tiada asal (origin) yang boleh anda namakan. Mesej itu tetap hanya pergi ke bingkai tersebut. Apabila mesej balasan tiba, asalnya tertulis "null", jadi percayai mesej itu hanya apabila event.source juga merupakan tetingkap bingkai itu. Roda hanya mendengar halaman yang membenamkannya dan menjawab arahan yang rosak dengan peristiwa error. Kekalkan atribut sandbox dan referrerpolicy yang dijana tanpa sebarang perubahan: arahan biasa memerlukan asal halaman induk yang diketahui daripada perujuk (referrer). Jika muat semula membuang perujuk itu, anda boleh menggunakan pembantu pembangun untuk menyambung semula melalui jabat tangan yang disahkan daripada induk HTTPS yang sebenar.