ライブ配信にルーレットを載せたい場合は、OBSルーレットガイドをご覧ください

サイトにルーレットを埋め込む

選択肢を入力し、訪問者の操作方法を選んで、コードをコピーするだけです。HTMLを使えるhttpsページで動作し、アカウントもプラグインも料金も不要です。

サーバーからルーレットを作成する場合は、ChoiceSpin開発者APIでルーレットの保存、回せるリンクの作成、埋め込みルーレットの回転操作ができます。

ルーレットを設定

選択肢と操作方法を設定し、プレビューを確認してください。

1 選択肢
2~100件、各80文字以内 4 / 100
2 訪問者の操作
3 見た目
背景
ルーレットの色
5 秒
ルーレットのタイトル

操作できるプレビュー

訪問者が使うルーレットです。試しに回してみてください。

操作可能

ChoiceSpinのルーレット

選択肢4件 · クリックして回す ルーレットだけのページを開く

サイト用のコードをコピー

HTMLブロックまたは埋め込みブロックに貼り付けてください。ルーレットのサイズはページに合わせて変わります。

選択肢はサーバーではなく、コード内に保存されます。ページのソースを見られる人なら誰でも読めるため、非公開の氏名、パスワード、アカウント情報を含めないでください。

ルーレットを埋め込む手順

3つの手順でページにルーレットを表示できます。後からいつでもここに戻って変更できます。

  1. 01

    選択肢を入力

    上の欄に各行1件ずつ、2~100件の選択肢を入力します。操作方法、色、回転時間を選んでください。

  2. 02

    プレビューを回す

    プレビューは訪問者が使うものと同じルーレットなので、ここで試すとページ上での動作を確認できます。

  3. 03

    コードを貼り付ける

    ページのHTMLブロックや埋め込みブロックにコードをコピーし、通常どおりページを公開します。

コードを貼り付ける場所

多くのサイト作成サービスにはHTMLや埋め込みコード用のブロックがありますが、名前はサービスによって異なります。自分でコードを書くページでは、<body>内のルーレットを表示したい位置に貼り付けてください。scriptタグ、スタイルシート、APIキーを追加する必要はありません。

WordPress

  1. ブロックエディターで/htmlと入力し、「Custom HTML」ブロックを選びます。
  2. コードを貼り付け、ページを更新または公開します。

クラシックエディターでは「Text」タブに貼り付けます。WordPressで埋め込みコードを保持できるのは、フィルターを通さないHTMLの投稿を許可されたユーザーで、通常は管理者と編集者です。WordPress.comでは、ホスティング機能を有効にした有料プランが必要です。

Google Sites

  1. 「Insert」→「Embed」→「Embed code」タブの順に選びます。
  2. コードを貼り付け、「Next」、続いて「Insert」をクリックします。
  3. 枠の端をドラッグしてルーレット全体を表示し、「Publish」を選びます。

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. 「Online Store」→「Pages」と進み、ページを開きます。
  2. エディターのツールバーで「Show HTML」を選び、コードを貼り付けて「Save」をクリックします。

テーマのセクションにルーレットを置く場合は、「Edit theme」を開いて「Add section」をクリックし、「Custom Liquid」を選んでください。

Notion

  1. 上の出力を「直接リンクのURL」に切り替え、リンクをコピーします。
  2. Notionで/embedと入力し、「Embed link」を選んで貼り付けます。

Notionが受け付けるのはリンクだけなので、埋め込みコードを貼り付けても動作しません。

Canvas LMS

  1. リッチコンテンツエディターで「Insert」→「Embed」を選びます。
  2. 「Embed Code」にコードを貼り付け、「Submit」をクリックします。

学校がCanvasのコンテンツセキュリティポリシーを有効にしている場合、管理者がchoicespin.comを許可ドメインに追加する必要があるかもしれません。

Moodle

  1. ページリソースまたはHTMLブロックで、エディターの「Tools」メニューから「Source code」を選びます。
  2. コードを貼り付けて保存します。

フォーラムへの投稿では埋め込みコードが削除されます。「Content cleaning everywhere」が有効なサイトでは、すべての場所で削除されます。

プランの制限で埋め込みコードが削除される場合や、リンクしか使えないツールでは、上の出力を「直接リンクのURL」に切り替えてください。リンクやボタンとして貼り付けると、同じルーレットを専用のページで開けます。

Google SlidesやPowerPointで使う

プレゼンテーションアプリは埋め込みコードを実行しないため、確実なのはリンクを使う方法です。スライドショー中にクリックすると、ブラウザのタブでルーレットが開き、すぐに回せます。

Google Slides

スライド上のテキストを選び、「Insert」→「Link」(Ctrl+K、Macでは⌘+K)で直接リンクのURLを貼り付けます。プレゼンテーション中にリンクをクリックしてルーレットを開き、回したらスライドに戻ってください。

PowerPoint

テキストまたは図形を選び、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も追跡もなし

フレームは権限を制限しているため、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文字列を1つ追加します
  • removeWinnerは直前の当選者を削除します
  • resetはコード内の選択肢に戻します

受信するイベント

ready、spin-start、winnerとindexを伴うspin-end、entries-changed、errorを受信します。いずれも現在の選択肢のcountを通知します。

知っておきたい3つのルール

権限を制限したフレームには指定できるオリジンがないため、送信先に"*"を使ってください。それでも、メッセージが届くのはそのフレームだけです。返ってきたメッセージのオリジンは"null"になるため、event.sourceもそのフレームのウィンドウと一致する場合にだけ信頼してください。ルーレットは埋め込み元のページからだけ受信し、不正な形式の操作にはerrorイベントを返します。生成されたsandboxとreferrerpolicy属性は変更しないでください。通常の操作には、リファラーから取得した親ページのオリジンが必要です。再読み込みでリファラーが失われた場合、任意で使える開発者向けヘルパーが、実際のHTTPS親ページとの検証済みハンドシェイクで再接続できます。

ルーレットが表示されないとき

多くの問題はコードの貼り付け先が原因です。まず次を確認してください。

コードが文字として表示される

通常のテキストブロックに貼り付けられています。削除し、HTML、コード、埋め込み用のブロックに貼り付け直してください。

枠が空のまま

ルーレットはhttpsで配信されるページでのみ読み込まれます。ページのアドレスがhttpで始まる場合や、プランの制限で埋め込みコードが削除される場合は、直接リンクのURLをリンクとして使ってください。

ルーレットが切れている

埋め込みの枠が低すぎます。ルーレット、ボタン、ChoiceSpinへのリンクがすべて見えるまで高さを広げてください。フレームだけで最低460ピクセル、「ルーレットを回す」ボタン付きなら560ピクセル、訪問者が編集できる場合は760ピクセル必要です。リンクの行には、さらに約30ピクセル必要です。

音が鳴らない

「終了音を鳴らす」がオンか確認してください。ブラウザは、訪問者がフレーム内でクリックするかキーを押した後にしか音を許可しません。その前に自分のコードから回転を開始すると、音は鳴りません。

よくある質問

公開ページに追加する前に、よくある疑問にお答えします。

埋め込みルーレットは無料ですか?

はい。料金も登録も不要で、同じコードを何ページにでも使えます。

埋め込んだ後でルーレットを変更するには?

この作成ツールで作ったルーレットは、ここで新しい内容を作り、ページ内の古いコードを置き換えてください。選択肢はコード自体に含まれるため、アカウントや保存済みのコピーを更新する方式ではありません。APIでサーバー上に作成したルーレットには、別途保存された記録があります。

訪問者は私のルーレットを変更できますか?

変更できるのは訪問者自身のコピーだけです。「訪問者による編集を許可」を選ぶと新しい選択肢を入力でき、「当選者を削除」ボタンや「当選者を毎回削除」で当選者を取り除けます。その変更で元のルーレットや他の人のコピーが変わることはなく、再読み込みすると元の選択肢に戻ります。

埋め込みルーレットはCookieを使ったり訪問者を追跡したりしますか?

いいえ。ルーレットは権限を制限したフレーム内で動作し、Cookieの設定もブラウザへの保存もできません。広告や解析も読み込みません。この作成ツールで作ったルーレットの選択肢はコードに含まれるため、ページのソースを見られる人なら誰でも読めます。APIで作成したスナップショットはサーバーに保存され、リンクを持つ人なら誰でも読めます。

埋め込みルーレットには選択肢を何件入れられますか?

各80文字以内で、2~100件です。選択肢はリンクに含まれるため、合計で約3,900文字まで使えますが、日本語などの文字ではそれより少なくなります。より長いリスト、重み付け、結果の保存が必要な場合は、最大2,000件に対応したChoiceSpinの通常版ルーレットを使ってください。

埋め込みルーレットはスマートフォンでも使えますか?

はい。コンテンツ欄の幅に合わせて広がり、高さは460ピクセル未満にならないため、小さな画面でもラベルを読みやすく保てます。タップして回せます。

ChoiceSpinへのリンクを消せますか?

はい。コードをコピーする前に「ChoiceSpinへのリンクを表示」をオフにするか、後からコード内のリンクの行を削除してください。どちらでもルーレットの動作は変わりません。

自分のページの代わりにルーレットのページがGoogleに表示されますか?

いいえ。ルーレットだけのページにはnoindexが設定されているため、検索結果には表示されません。あなたのページが検索に表示されるかどうかは、そのページ自体の内容と設定によります。

選択肢が100件を超える場合は?

通常版ルーレットは最大2,000件に対応し、重み、画像、ルーレットの保存、結果の履歴を使えます。授業での使い方は先生向けガイドで紹介しています。

通常版ルーレットを開く