สั่งหมุนและอ่านผลที่สุ่มได้
เพิ่ม <button id="spin-from-page" type="button" disabled>Spin</button> ลงในหน้าของคุณ แล้ววางสคริปต์นี้ไว้หลังโค้ดฝัง วงล้อจะไม่สนใจคำสั่งใด ๆ จนกว่าจะส่ง ready ปุ่มจึงถูกปิดใช้งานไว้จนถึงตอนนั้น
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"));
คำสั่งที่คุณส่งได้
spin เริ่มการหมุน
setEntries แทนที่ตัวเลือกด้วยอาร์เรย์ entries ที่มีสตริง 2 ถึง 100 รายการ
addEntry เพิ่มสตริง entry หนึ่งรายการ
removeWinner ลบผลที่สุ่มได้ล่าสุด
reset คืนค่าตัวเลือกตามที่อยู่ในโค้ด
อีเวนต์ที่คุณจะได้รับ
ready, spin-start, spin-end พร้อม winner และ index, entries-changed และ error ทุกอีเวนต์รายงานจำนวนตัวเลือกปัจจุบันใน count ด้วย
กฎสามข้อที่ควรรู้
ส่งข้อความโดยใช้ "*" เป็นเป้าหมาย เพราะเฟรมแบบแซนด์บ็อกซ์ไม่มี origin ที่คุณจะระบุได้ ข้อความก็ยังส่งถึงเฉพาะเฟรมนั้นเฟรมเดียว เมื่อมีข้อความตอบกลับมา origin ของข้อความจะเป็น "null" จึงควรเชื่อถือข้อความนั้นเฉพาะเมื่อ event.source เป็น window ของเฟรมนั้นด้วย วงล้อรับฟังเฉพาะหน้าที่ฝังวงล้อไว้ และตอบคำสั่งที่รูปแบบไม่ถูกต้องด้วยอีเวนต์ error ให้คงแอตทริบิวต์ sandbox และ referrerpolicy ที่สร้างไว้ตามเดิม เพราะคำสั่งทั่วไปต้องใช้ origin ของหน้าแม่ที่ได้จาก referrer หากการโหลดใหม่ทำให้ referrer นั้นหายไป ตัวช่วยสำหรับนักพัฒนาซึ่งเป็นตัวเลือกเสริมจะเชื่อมต่อใหม่ผ่าน handshake ที่ผ่านการตรวจสอบจากหน้าแม่ HTTPS ตัวจริงได้