WordPress
- 在區塊編輯器中輸入
/html,選擇「自訂 HTML」區塊。 - 貼上程式碼,再更新或發布頁面。
在傳統編輯器中,請貼在「文字」分頁。WordPress 只會保留有權發布未過濾 HTML 的使用者所加入的嵌入程式碼,通常是網站管理員和編輯。在 WordPress.com 上,則需要已開啟主機功能的付費方案。
輸入選項,選擇瀏覽者使用轉盤的方式,再複製一段程式碼。任何接受 HTML 的 https 頁面都能使用,不需要帳號、外掛,也不用付費。
要從你的伺服器建立轉盤嗎?請使用 ChoiceSpin 開發者 API 來儲存轉盤、建立可以直接轉動的連結,以及控制嵌入轉盤的轉動。
將這段程式碼貼到 HTML 區塊或嵌入區塊。轉盤會隨頁面調整大小。
你的選項存在程式碼裡,不在我們的伺服器上。任何能看到你網頁原始碼的人都能讀到這些選項,所以請不要放入私人姓名、密碼和帳號資訊。
只要三個步驟,轉盤就會出現在你的頁面上。之後隨時都能回來修改。
在上方輸入 2 到 100 個選項,每行一個。選擇操作方式、顏色和轉動時間。
預覽執行的就是瀏覽者會拿到的同一個轉盤,所以在這裡試轉,就能看到它在你頁面上的表現。
把這段程式碼複製到頁面上的 HTML 區塊或嵌入區塊,再照常發布頁面。
大多數架站工具都有放 HTML 或嵌入程式碼的區塊,只是各家的名稱不一樣。如果是自己寫的頁面,請把程式碼貼在 <body> 內你想顯示轉盤的位置。不需要另外加入 script 標籤、樣式表或 API 金鑰。
/html,選擇「自訂 HTML」區塊。在傳統編輯器中,請貼在「文字」分頁。WordPress 只會保留有權發布未過濾 HTML 的使用者所加入的嵌入程式碼,通常是網站管理員和編輯。在 WordPress.com 上,則需要已開啟主機功能的付費方案。
在 Wix Studio 中,依序點選「Add Elements」、「Embed & Social」、「Embed Code」,就能找到同一個元素。
Core、Plus 和 Advanced 方案,以及較舊的 Business 和 Commerce 方案都能執行嵌入程式碼,Basic 方案則不行。如果登入時看不到轉盤,請用「Preview in Safe Mode」檢查頁面。
Code Embed 需要付費的 Workspace 或 Site 方案。
如果想改把轉盤放在佈景主題的區段中,請開啟「編輯佈景主題」,點選「新增區段」,再選擇「自訂 Liquid」。
/embed,選擇「Embed link」後貼上。Notion 只接受連結,所以在那裡貼上嵌入程式碼是沒有作用的。
如果你的學校開啟了 Canvas 的內容安全政策,管理員可能需要把 choicespin.com 加入允許的網域。
討論區貼文會移除嵌入程式碼;開啟了「Content cleaning everywhere」的網站,所有區域也都會移除。
如果你的方案會移除嵌入程式碼,或工具只接受連結,請把上方的輸出切換成「直接連結」。把它貼成連結或按鈕,就會在獨立頁面開啟同一個轉盤。
簡報軟體不會執行嵌入程式碼,所以最可靠的方式是用連結。放映投影片時點一下,就會在瀏覽器分頁開啟轉盤,馬上就能轉。
選取投影片上的一些文字,依序選擇「插入」、「連結」(Ctrl+K,Mac 為 ⌘+K),再貼上直接連結。在簡報模式中點連結開啟轉盤,轉完後再切回你的投影片。
選取文字或圖案,按 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,也無法在瀏覽器中儲存任何資料。它不會載入廣告,也不會載入分析工具。
程式碼會讓瀏覽器等到瀏覽者捲動到轉盤附近時才載入它,所以頁面頂端依然能快速載入。
複製的程式碼可以單獨運作。如果你自己撰寫頁面程式碼,也可以透過視窗訊息開始轉動、變更選項並讀取每次的選中項目,而不必放寬框架的沙箱限制。
在你的頁面加入 <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,也無法在瀏覽器儲存任何資料,而且不會載入廣告或分析工具。用產生器做出的轉盤,選項是程式碼的一部分,所以任何查看你網頁原始碼的人都能看到。透過 API 建立的快照會存放在伺服器上,任何持有連結的人都能讀取。
2 到 100 個選項,每個最多 80 個字元。由於選項會放在連結裡一起傳送,全部加起來大約可用 3,900 個字元;中文、日文這類文字能放的更少。如果需要更長的清單、權重或保存結果,請使用完整版 ChoiceSpin 轉盤,最多可放 2,000 個選項。
可以。它會填滿內容欄的寬度,高度永遠不會低於 460 像素,所以在小螢幕上標籤依然清楚可讀。瀏覽者點一下就能轉動。
可以。複製程式碼前取消勾選「顯示 ChoiceSpin 來源標示」,或之後從程式碼中刪掉來源標示那一行。兩種做法轉盤的運作都一樣。
不會。只有轉盤的那個頁面標有 noindex,所以不會出現在搜尋結果中。你的頁面本身在搜尋中的能見度,取決於它自己的內容和設定。
完整版轉盤最多可放 2,000 個選項,還有權重、圖片、儲存轉盤和結果紀錄。老師可以在教師指南找到課堂點子。