要把轉盤放上直播?請閱讀 OBS 轉盤指南

在你的網站嵌入轉盤

輸入選項,選擇瀏覽者使用轉盤的方式,再複製一段程式碼。任何接受 HTML 的 https 頁面都能使用,不需要帳號、外掛,也不用付費。

要從你的伺服器建立轉盤嗎?請使用 ChoiceSpin 開發者 API 來儲存轉盤、建立可以直接轉動的連結,以及控制嵌入轉盤的轉動。

設定你的轉盤

加入選項、選擇操作方式,再檢查預覽。

1 選項
2 到 100 個選項,每個最多 80 個字元 4 / 100
2 瀏覽者操作
3 外觀
背景
轉盤顏色
5 秒
轉盤標題

即時預覽

這就是瀏覽者會用到的轉盤,試轉看看吧。

可互動

轉盤由 ChoiceSpin 提供

4 個選項 · 點選轉動 在獨立頁面開啟轉盤

複製網站程式碼

將這段程式碼貼到 HTML 區塊或嵌入區塊。轉盤會隨頁面調整大小。

你的選項存在程式碼裡,不在我們的伺服器上。任何能看到你網頁原始碼的人都能讀到這些選項,所以請不要放入私人姓名、密碼和帳號資訊。

如何嵌入轉盤

只要三個步驟,轉盤就會出現在你的頁面上。之後隨時都能回來修改。

  1. 01

    加入選項

    在上方輸入 2 到 100 個選項,每行一個。選擇操作方式、顏色和轉動時間。

  2. 02

    轉動預覽

    預覽執行的就是瀏覽者會拿到的同一個轉盤,所以在這裡試轉,就能看到它在你頁面上的表現。

  3. 03

    貼上程式碼

    把這段程式碼複製到頁面上的 HTML 區塊或嵌入區塊,再照常發布頁面。

程式碼要貼在哪裡

大多數架站工具都有放 HTML 或嵌入程式碼的區塊,只是各家的名稱不一樣。如果是自己寫的頁面,請把程式碼貼在 <body> 內你想顯示轉盤的位置。不需要另外加入 script 標籤、樣式表或 API 金鑰。

WordPress

  1. 在區塊編輯器中輸入 /html,選擇「自訂 HTML」區塊。
  2. 貼上程式碼,再更新或發布頁面。

在傳統編輯器中,請貼在「文字」分頁。WordPress 只會保留有權發布未過濾 HTML 的使用者所加入的嵌入程式碼,通常是網站管理員和編輯。在 WordPress.com 上,則需要已開啟主機功能的付費方案。

Google Sites

  1. 依序點選「插入」、「嵌入」,再點「嵌入程式碼」分頁。
  2. 貼上程式碼,點選「下一步」,再點「插入」。
  3. 拖曳方框邊緣,直到整個轉盤都顯示出來,再按「發布」。

Wix

  1. 依序點選「Add Elements」、「Embed Code」、「Embed HTML」。
  2. 點選新元素,選擇「Enter Code」,貼上程式碼後點「Apply」。
  3. 拖曳元素邊緣,直到轉盤完整放進去。

在 Wix Studio 中,依序點選「Add Elements」、「Embed & Social」、「Embed Code」,就能找到同一個元素。

Squarespace

  1. 點選「Add block」,選擇「Code」,再點鉛筆圖示。
  2. 貼上程式碼,設定為 HTML,並讓「Display Source」保持關閉。

Core、Plus 和 Advanced 方案,以及較舊的 Business 和 Commerce 方案都能執行嵌入程式碼,Basic 方案則不行。如果登入時看不到轉盤,請用「Preview in Safe Mode」檢查頁面。

Webflow

  1. 開啟「Add」面板,把「Code Embed」元素拖到頁面上。
  2. 貼上程式碼,再點「Save & Close」。

Code Embed 需要付費的 Workspace 或 Site 方案。

Shopify

  1. 前往「線上商店」中的「網頁」,開啟一個頁面。
  2. 在編輯器工具列點選「顯示 HTML」,貼上程式碼後點「儲存」。

如果想改把轉盤放在佈景主題的區段中,請開啟「編輯佈景主題」,點選「新增區段」,再選擇「自訂 Liquid」。

Notion

  1. 把上方的輸出切換成「直接連結」,再複製連結。
  2. 在 Notion 中輸入 /embed,選擇「Embed link」後貼上。

Notion 只接受連結,所以在那裡貼上嵌入程式碼是沒有作用的。

Canvas LMS

  1. 在 Rich Content Editor 中選擇「Insert」,再選「Embed」。
  2. 把程式碼貼到「Embed Code」,再點「Submit」。

如果你的學校開啟了 Canvas 的內容安全政策,管理員可能需要把 choicespin.com 加入允許的網域。

Moodle

  1. 在「Page」資源或 HTML 區塊中,開啟編輯器的「Tools」選單,選擇「Source code」。
  2. 貼上程式碼並儲存。

討論區貼文會移除嵌入程式碼;開啟了「Content cleaning everywhere」的網站,所有區域也都會移除。

如果你的方案會移除嵌入程式碼,或工具只接受連結,請把上方的輸出切換成「直接連結」。把它貼成連結或按鈕,就會在獨立頁面開啟同一個轉盤。

在 Google 簡報或 PowerPoint 中使用轉盤

簡報軟體不會執行嵌入程式碼,所以最可靠的方式是用連結。放映投影片時點一下,就會在瀏覽器分頁開啟轉盤,馬上就能轉。

Google Slides

選取投影片上的一些文字,依序選擇「插入」、「連結」(Ctrl+K,Mac 為 ⌘+K),再貼上直接連結。在簡報模式中點連結開啟轉盤,轉完後再切回你的投影片。

PowerPoint

選取文字或圖案,按 Ctrl+K(Mac 為 ⌘+K),再貼上直接連結。投影片放映時點一下,就會在瀏覽器開啟轉盤。Microsoft 已在 2024 年十二月停止提供免費的 Web Viewer 增益集。其他公司的付費增益集可以在投影片中顯示網頁,但我們沒有測試過。

調整大小

程式碼會填滿你的內容欄,最寬 760 像素,高度會跟著寬度調整。

讓它窄一點

把第一行的 max-width:760px 改成較小的寬度,例如 480px。轉盤會跟著縮小,並維持置中。

在手機上保持清楚可讀

min-height 的值能避免框架在窄螢幕上變得太矮:一般轉盤是 460 像素,有轉動按鈕時是 560,允許瀏覽者編輯時是 760。請保留這個設定。

會替嵌入內容加上外框的架站工具

在 Wix、Google 協作平台等架站工具中,程式碼會放在一個可以調整大小的方框裡。拖曳方框,直到整個轉盤和來源標示都顯示出來,而且沒有捲軸。

瀏覽者會得到什麼

嵌入內容執行的轉盤和 ChoiceSpin 本身相同,只是放在自己的框架中。

公平的轉動

每次轉動時,每個選項被選中的機率都相同。在新式瀏覽器中,選中項目由 Web Crypto 產生的亂數決定。請參閱轉盤如何選出結果。

鍵盤與螢幕閱讀器

瀏覽者可以把焦點移到轉盤上,按空白鍵或 Enter 鍵轉動。每次停下時,螢幕閱讀器都會報讀結果。

沒有 Cookie,也不追蹤

這個框架位於沙箱中,無法設定 Cookie,也無法在瀏覽器中儲存任何資料。它不會載入廣告,也不會載入分析工具。

輕量的頁面

程式碼會讓瀏覽器等到瀏覽者捲動到轉盤附近時才載入它,所以頁面頂端依然能快速載入。

用 JavaScript 控制轉盤

複製的程式碼可以單獨運作。如果你自己撰寫頁面程式碼,也可以透過視窗訊息開始轉動、變更選項並讀取每次的選中項目,而不必放寬框架的沙箱限制。

開始轉動並讀取選中項目

在你的頁面加入 <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 以包含 2 到 100 個字串的 entries 陣列取代選項
  • addEntry 新增一個 entry 字串
  • removeWinner 移除最近一次的選中項目
  • reset 恢復程式碼中的選項

會收到的事件

ready、spin-start、spin-end(附帶 winner 和 index)、entries-changed 和 error。每個事件也會回報目前的選項數 count。

要知道的三條規則

傳送訊息時請以 "*" 作為目標,因為沙箱框架沒有可以指名的 origin。訊息仍然只會送到那一個框架。收到回傳的訊息時,它的 origin 會是 "null",所以只有在 event.source 也是該框架的視窗時才能信任它。轉盤只監聽嵌入它的頁面,收到格式錯誤的指令時會回應 error 事件。請保留產生的 sandbox 和 referrerpolicy 屬性,不要修改:一般指令需要從 referrer 得知父頁面的 origin。如果重新載入讓 referrer 消失了,可以使用選用的開發者輔助工具,從實際的 HTTPS 父頁面透過經驗證的交握重新連線。

如果轉盤沒有出現

大部分問題都出在程式碼貼的位置。請先檢查以下幾點。

程式碼直接以文字顯示

它被貼進一般的文字區塊了。請刪掉,改貼到 HTML、程式碼或嵌入區塊。

只看到空白方框

轉盤只會在透過 https 提供的頁面上載入。如果你的頁面網址以 http 開頭,或你的方案會移除嵌入程式碼,請改用「直接連結」,以一般連結的形式放在頁面上。

轉盤被切掉了

嵌入方框太矮了。把它拉高,直到轉盤、按鈕和來源標示全部顯示出來。光是框架就至少需要 460 像素,有轉動按鈕時需要 560,允許瀏覽者編輯時需要 760。來源標示還會再多約 30 像素。

沒有聲音

請確認已勾選「播放結束音效」。瀏覽器只會在瀏覽者於框架內點擊或按鍵之後才允許播放聲音,所以在那之前由你自己的程式碼啟動的轉動不會有聲音。

常見問題

把轉盤加到公開頁面之前,先看看這些簡短解答。

嵌入的轉盤免費嗎?

是的,完全免費,也不必註冊,同一段程式碼想放在幾個頁面都可以。

嵌入之後要怎麼修改轉盤?

如果是用這個產生器做的轉盤,請在這裡做出新版本,再替換頁面上的舊程式碼。它的選項就存在程式碼裡,所以沒有帳號或已儲存的副本需要更新。透過 API 在伺服器上建立的轉盤,則另有各自儲存的紀錄。

瀏覽者可以修改我的轉盤嗎?

只能改他們自己的那一份。開啟「允許瀏覽者編輯」時,他們可以輸入新選項,而「移除選中項目」按鈕或「移除每個選中項目」會把選中的項目拿掉。他們的修改不會影響你的原始轉盤或其他人的副本,重新載入後就會恢復你的選項。

嵌入的轉盤會使用 Cookie 或追蹤瀏覽者嗎?

不會。轉盤在沙箱框架中執行,無法設定 Cookie,也無法在瀏覽器儲存任何資料,而且不會載入廣告或分析工具。用產生器做出的轉盤,選項是程式碼的一部分,所以任何查看你網頁原始碼的人都能看到。透過 API 建立的快照會存放在伺服器上,任何持有連結的人都能讀取。

嵌入的轉盤最多可以有幾個選項?

2 到 100 個選項,每個最多 80 個字元。由於選項會放在連結裡一起傳送,全部加起來大約可用 3,900 個字元;中文、日文這類文字能放的更少。如果需要更長的清單、權重或保存結果,請使用完整版 ChoiceSpin 轉盤,最多可放 2,000 個選項。

嵌入的轉盤可以在手機上使用嗎?

可以。它會填滿內容欄的寬度,高度永遠不會低於 460 像素,所以在小螢幕上標籤依然清楚可讀。瀏覽者點一下就能轉動。

可以拿掉 ChoiceSpin 來源標示嗎?

可以。複製程式碼前取消勾選「顯示 ChoiceSpin 來源標示」,或之後從程式碼中刪掉來源標示那一行。兩種做法轉盤的運作都一樣。

Google 會顯示轉盤頁面,而不是我的頁面嗎?

不會。只有轉盤的那個頁面標有 noindex,所以不會出現在搜尋結果中。你的頁面本身在搜尋中的能見度,取決於它自己的內容和設定。

需要超過 100 個選項嗎?

完整版轉盤最多可放 2,000 個選項,還有權重、圖片、儲存轉盤和結果紀錄。老師可以在教師指南找到課堂點子。

開啟完整版轉盤