Çarkı JavaScript ile yönet
Kopyaladığın kod tek başına çalışır. Sayfanın kodunu kendin yazıyorsan, çerçevenin sandbox korumasını gevşetmeden pencere mesajlarıyla çeviriş başlatabilir, seçenekleri değiştirebilir ve her kazananı okuyabilirsin.
Bir çeviriş başlat ve kazananı oku
Sayfana <button id="spin-from-page" type="button" disabled>Spin</button> ekle ve bu betiği yerleştirme kodundan sonra koy. Çark ready mesajını gönderene kadar komutları yok sayar, bu yüzden düğme o zamana kadar devre dışı kalır.
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"));
Gönderebileceğin eylemler
spin bir çeviriş başlatır
setEntries, seçenekleri 2 ile 100 arası metin içeren bir entries dizisiyle değiştirir
addEntry, tek bir entry metni ekler
removeWinner son kazananı kaldırır
reset, koddaki seçenekleri geri getirir
Aldığın olaylar
ready, spin-start, winner ve index içeren spin-end, entries-changed ve error. Her biri ayrıca güncel seçenek sayısını (count) bildirir.
Bilmen gereken üç kural
Mesajları hedef olarak "*" ile gönder, çünkü sandbox içindeki bir çerçevenin belirtebileceğin bir origin değeri yoktur. Mesaj yine de yalnızca o çerçeveye gider. Geri gelen bir mesajın origin değeri "null" olur; bu yüzden ona yalnızca event.source değeri de çerçevenin penceresiyse güven. Çark yalnızca kendisini yerleştiren sayfayı dinler ve hatalı biçimlendirilmiş bir komuta error olayıyla yanıt verir. Oluşturulan sandbox ve referrerpolicy özniteliklerini olduğu gibi bırak: sıradan komutlar, referrer bilgisinden öğrenilen üst sayfa origin değerine ihtiyaç duyar. Bir yenileme bu referrer bilgisini silerse isteğe bağlı geliştirici yardımcısı, gerçek HTTPS üst sayfasından gelen doğrulanmış bir el sıkışmayla yeniden bağlanabilir.