ابدأ تدويرا واقرأ الفائز
أضف <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.
ثلاث قواعد ينبغي معرفتها
أرسل الرسائل مع "*" كوجهة، لأن الإطار المعزول ليس له أصل يمكنك تسميته. تظل الرسالة موجهة إلى ذلك الإطار وحده. عندما تعود رسالة، تظهر قيمة أصلها على أنها "null"، لذلك لا تثق بها إلا إذا كان event.source أيضا هو نافذة الإطار. لا تستمع العجلة إلا إلى الصفحة التي تتضمنها، وترد على الأمر غير السليم بحدث error. أبق خاصيتي sandbox وreferrerpolicy المنشأتين كما هما: تحتاج الأوامر المعتادة إلى أصل الصفحة الأم الذي يستخلص من المحيل. إذا أزالت إعادة التحميل ذلك المحيل، فيمكن أن تعيد أداة المطور المساعدة الاختيارية الاتصال عبر مصافحة صادرة من الصفحة الأم الفعلية التي تعمل عبر HTTPS، بعد التحقق من صحة هذه المصافحة.