WordPress
- 在区块编辑器中输入
/html,选择 Custom HTML 区块。 - 粘贴代码,然后更新或发布页面。
在经典编辑器中,请粘贴到 Text 标签页。WordPress 只保留有权发布未过滤 HTML 的用户所添加的嵌入代码,通常是 Administrator 和 Editor 角色。在 WordPress.com 上,需要开启了托管功能的付费套餐。
输入选项,选择访客如何使用转盘,然后复制一段代码。任何接受 HTML 的 https 页面都能用,无需账号、插件,也不收费。
要从你的服务器创建转盘?可以使用 ChoiceSpin 开发者 API 保存转盘、生成可直接转动的链接,并控制嵌入转盘的转动。
将此代码粘贴到 HTML 区块或嵌入区块中。转盘会随页面调整大小。
你的选项保存在代码里,而不是我们的服务器上。任何能查看你页面源代码的人都能看到它们,所以不要放入私人姓名、密码或账号信息。
只需三步,转盘就会出现在你的页面上。之后随时可以回来修改。
在上方输入 2 到 100 个选项,每行一个。再选择访客操作、颜色和转动时长。
预览运行的就是访客将会用到的同一个转盘,所以在这里试转一次,就能看到它在你页面上的表现。
把这段代码粘贴到页面里的 HTML 区块或嵌入区块中,然后照常发布页面。
大多数建站工具都有放 HTML 或嵌入代码的区块,只是叫法各不相同。如果页面是你自己写的,就把代码粘贴到 <body> 里转盘该出现的位置。不需要另外添加 script 标签、样式表或 API 密钥。
/html,选择 Custom HTML 区块。在经典编辑器中,请粘贴到 Text 标签页。WordPress 只保留有权发布未过滤 HTML 的用户所添加的嵌入代码,通常是 Administrator 和 Editor 角色。在 WordPress.com 上,需要开启了托管功能的付费套餐。
在 Wix Studio 中,同样的元素在 Add Elements 下:依次选择 Embed & Social、Embed Code。
Core、Plus 和 Advanced 套餐以及旧版 Business 和 Commerce 套餐都能运行嵌入代码,Basic 套餐不行。如果登录状态下看不到转盘,请用 Preview in Safe Mode 检查页面。
Code Embed 需要付费的 Workspace 或 Site 套餐。
如果想把转盘放进主题分区,请打开 Edit theme,点击 Add section,然后选择 Custom Liquid。
/embed,选择 Embed link,然后粘贴链接。Notion 只接受链接,所以在 Notion 中粘贴嵌入代码不起作用。
如果你的学校开启了 Canvas 的内容安全策略,管理员可能需要把 choicespin.com 加入允许的域名列表。
论坛帖子会移除嵌入代码;在开启了 Content cleaning everywhere 的站点上,所有区域都会移除嵌入代码。
如果你的套餐会删除嵌入代码,或者某个工具只接受链接,就把上方的输出切换到“直接链接”。把它作为链接或按钮粘贴后,会在单独的页面中打开同一个转盘。
演示文稿软件不会运行嵌入代码,所以最可靠的方法是用链接。放映时点一下,就会在浏览器标签页中打开转盘,随时可以转动。
在幻灯片上选中一些文字,选择 Insert,再选择 Link(Ctrl+K,Mac 上为 ⌘+K),然后粘贴直接链接。在演示模式下点击链接打开转盘,转完后再切回幻灯片。
选中文字或形状,按 Ctrl+K(Mac 上为 ⌘+K),粘贴直接链接。放映时点击它,就会在浏览器中打开转盘。Microsoft 已于 2024 年 12 月停用其免费的 Web Viewer 加载项。其他公司的付费加载项可以在幻灯片中显示网页,但我们没有测试过。
代码会占满你的内容栏,最宽 760 像素,高度随宽度变化。
把第一行里的 max-width:760px 改成更小的宽度,例如 480px。转盘会随之缩小,并保持居中。
min-height 这个值能防止框架在窄屏上变得太矮:普通转盘为 460 像素,带“转动”按钮时为 560,允许访客编辑时为 760。请保留它。
在 Wix、Google Sites 等建站工具中,代码会放在一个可调整大小的框里。拖动这个框,直到整个转盘和署名链接都完整显示、没有滚动条为止。
嵌入的转盘与 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)。消息仍然只会发给那一个框架。收到回传的消息时,它的源显示为 "null",所以只有当 event.source 同时也是该框架的 window 时才信任它。转盘只监听嵌入它的页面,收到格式错误的命令时会回复一个 error 事件。生成的 sandbox 和 referrerpolicy 属性请保持原样:普通命令需要用到从 referrer 获知的父页面源。如果重新加载导致 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 个选项,并提供权重、图片、已保存的转盘和结果历史记录。老师们可以在教师指南中找到课堂用法。