WordPress
- ブロックエディターで
/htmlと入力し、「Custom HTML」ブロックを選びます。 - コードを貼り付け、ページを更新または公開します。
クラシックエディターでは「Text」タブに貼り付けます。WordPressで埋め込みコードを保持できるのは、フィルターを通さないHTMLの投稿を許可されたユーザーで、通常は管理者と編集者です。WordPress.comでは、ホスティング機能を有効にした有料プランが必要です。
選択肢を入力し、訪問者の操作方法を選んで、コードをコピーするだけです。HTMLを使えるhttpsページで動作し、アカウントもプラグインも料金も不要です。
サーバーからルーレットを作成する場合は、ChoiceSpin開発者APIでルーレットの保存、回せるリンクの作成、埋め込みルーレットの回転操作ができます。
HTMLブロックまたは埋め込みブロックに貼り付けてください。ルーレットのサイズはページに合わせて変わります。
選択肢はサーバーではなく、コード内に保存されます。ページのソースを見られる人なら誰でも読めるため、非公開の氏名、パスワード、アカウント情報を含めないでください。
3つの手順でページにルーレットを表示できます。後からいつでもここに戻って変更できます。
上の欄に各行1件ずつ、2~100件の選択肢を入力します。操作方法、色、回転時間を選んでください。
プレビューは訪問者が使うものと同じルーレットなので、ここで試すとページ上での動作を確認できます。
ページのHTMLブロックや埋め込みブロックにコードをコピーし、通常どおりページを公開します。
多くのサイト作成サービスにはHTMLや埋め込みコード用のブロックがありますが、名前はサービスによって異なります。自分でコードを書くページでは、<body>内のルーレットを表示したい位置に貼り付けてください。scriptタグ、スタイルシート、APIキーを追加する必要はありません。
/htmlと入力し、「Custom HTML」ブロックを選びます。クラシックエディターでは「Text」タブに貼り付けます。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プランが必要です。
テーマのセクションにルーレットを置く場合は、「Edit theme」を開いて「Add section」をクリックし、「Custom Liquid」を選んでください。
/embedと入力し、「Embed link」を選んで貼り付けます。Notionが受け付けるのはリンクだけなので、埋め込みコードを貼り付けても動作しません。
学校がCanvasのコンテンツセキュリティポリシーを有効にしている場合、管理者がchoicespin.comを許可ドメインに追加する必要があるかもしれません。
フォーラムへの投稿では埋め込みコードが削除されます。「Content cleaning everywhere」が有効なサイトでは、すべての場所で削除されます。
プランの制限で埋め込みコードが削除される場合や、リンクしか使えないツールでは、上の出力を「直接リンクのURL」に切り替えてください。リンクやボタンとして貼り付けると、同じルーレットを専用のページで開けます。
プレゼンテーションアプリは埋め込みコードを実行しないため、確実なのはリンクを使う方法です。スライドショー中にクリックすると、ブラウザのタブでルーレットが開き、すぐに回せます。
スライド上のテキストを選び、「Insert」→「Link」(Ctrl+K、Macでは⌘+K)で直接リンクのURLを貼り付けます。プレゼンテーション中にリンクをクリックしてルーレットを開き、回したらスライドに戻ってください。
テキストまたは図形を選び、Ctrl+K(Macでは⌘+K)を押して直接リンクのURLを貼り付けます。スライドショー中にクリックすると、ブラウザでルーレットが開きます。Microsoftの無料Web Viewerアドインは2024年12月に提供を終了しました。他社の有料アドインにはスライド内でウェブページを表示できるものもありますが、こちらでは検証していません。
このコードはコンテンツ欄の幅に合わせ、最大760ピクセルまで広がります。高さも幅に応じて変わります。
最初の行のmax-width:760pxを、480pxなどの小さな幅に変更します。ルーレットも小さくなり、中央に配置されたままになります。
min-heightの値は、狭い画面でフレームが低くなりすぎるのを防ぎます。操作ボタンのないルーレットは460ピクセル、「ルーレットを回す」ボタン付きは560ピクセル、訪問者が編集できる場合は760ピクセルです。この値は残してください。
WixやGoogle Sitesなどでは、コードがサイズ変更できる枠内に配置されます。スクロールバーなしでルーレット全体とChoiceSpinへのリンクが見えるまで、枠をドラッグしてください。
埋め込みルーレットは、独立したフレームの中で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文字列を1つ追加しますremoveWinnerは直前の当選者を削除しますresetはコード内の選択肢に戻しますready、spin-start、winnerとindexを伴うspin-end、entries-changed、errorを受信します。いずれも現在の選択肢のcountを通知します。
権限を制限したフレームには指定できるオリジンがないため、送信先に"*"を使ってください。それでも、メッセージが届くのはそのフレームだけです。返ってきたメッセージのオリジンは"null"になるため、event.sourceもそのフレームのウィンドウと一致する場合にだけ信頼してください。ルーレットは埋め込み元のページからだけ受信し、不正な形式の操作にはerrorイベントを返します。生成されたsandboxとreferrerpolicy属性は変更しないでください。通常の操作には、リファラーから取得した親ページのオリジンが必要です。再読み込みでリファラーが失われた場合、任意で使える開発者向けヘルパーが、実際のHTTPS親ページとの検証済みハンドシェイクで再接続できます。
多くの問題はコードの貼り付け先が原因です。まず次を確認してください。
通常のテキストブロックに貼り付けられています。削除し、HTML、コード、埋め込み用のブロックに貼り付け直してください。
ルーレットはhttpsで配信されるページでのみ読み込まれます。ページのアドレスがhttpで始まる場合や、プランの制限で埋め込みコードが削除される場合は、直接リンクのURLをリンクとして使ってください。
埋め込みの枠が低すぎます。ルーレット、ボタン、ChoiceSpinへのリンクがすべて見えるまで高さを広げてください。フレームだけで最低460ピクセル、「ルーレットを回す」ボタン付きなら560ピクセル、訪問者が編集できる場合は760ピクセル必要です。リンクの行には、さらに約30ピクセル必要です。
「終了音を鳴らす」がオンか確認してください。ブラウザは、訪問者がフレーム内でクリックするかキーを押した後にしか音を許可しません。その前に自分のコードから回転を開始すると、音は鳴りません。
公開ページに追加する前に、よくある疑問にお答えします。
はい。料金も登録も不要で、同じコードを何ページにでも使えます。
この作成ツールで作ったルーレットは、ここで新しい内容を作り、ページ内の古いコードを置き換えてください。選択肢はコード自体に含まれるため、アカウントや保存済みのコピーを更新する方式ではありません。APIでサーバー上に作成したルーレットには、別途保存された記録があります。
変更できるのは訪問者自身のコピーだけです。「訪問者による編集を許可」を選ぶと新しい選択肢を入力でき、「当選者を削除」ボタンや「当選者を毎回削除」で当選者を取り除けます。その変更で元のルーレットや他の人のコピーが変わることはなく、再読み込みすると元の選択肢に戻ります。
いいえ。ルーレットは権限を制限したフレーム内で動作し、Cookieの設定もブラウザへの保存もできません。広告や解析も読み込みません。この作成ツールで作ったルーレットの選択肢はコードに含まれるため、ページのソースを見られる人なら誰でも読めます。APIで作成したスナップショットはサーバーに保存され、リンクを持つ人なら誰でも読めます。
各80文字以内で、2~100件です。選択肢はリンクに含まれるため、合計で約3,900文字まで使えますが、日本語などの文字ではそれより少なくなります。より長いリスト、重み付け、結果の保存が必要な場合は、最大2,000件に対応したChoiceSpinの通常版ルーレットを使ってください。
はい。コンテンツ欄の幅に合わせて広がり、高さは460ピクセル未満にならないため、小さな画面でもラベルを読みやすく保てます。タップして回せます。
はい。コードをコピーする前に「ChoiceSpinへのリンクを表示」をオフにするか、後からコード内のリンクの行を削除してください。どちらでもルーレットの動作は変わりません。
いいえ。ルーレットだけのページにはnoindexが設定されているため、検索結果には表示されません。あなたのページが検索に表示されるかどうかは、そのページ自体の内容と設定によります。
通常版ルーレットは最大2,000件に対応し、重み、画像、ルーレットの保存、結果の履歴を使えます。授業での使い方は先生向けガイドで紹介しています。