ウィジェット
Turnstileの各インスタンスは、Turnstileウィジェットに属します。これはウィジェットごとに設定されます。すべてのウィジェットには、モード、ラベル、sitekey、およびsecret keyがあります。
Turnstileの3つのモードは、管理モード、非対話モード、およびインビジブルモードです。
ウィジェットが常に表示されるか、対話が必要なときのみ表示されるかを設定するには、表示モードを参照してください。
ウィジェットは、通常、柔軟、またはコンパクトなサイズで実装できます。
| Size | Width | Height |
|---|---|---|
| Normal | 300px | 65px |
| Flexible | 100% (min: 300px) | 65px |
| Compact | 150px | 140px |
柔軟またはコンパクトモードの設定方法の例については、ウィジェットサイズを参照してください。
このモードはCloudflareによって完全に管理されます。さまざまな信号とリスクレベルに基づいて適切なアクションを自動的に選択します。Cloudflareは、訪問者の情報を使用して、対話型のチャレンジを使用する必要があるかどうかを判断します。Turnstileは、訪問者が人間であることを確認するためにさらにチェックが必要な場合にのみ、対話を要求します。Turnstileが対話を表示すると、ユーザーはチェックボックスを選択するように促されます（解読する画像やテキストはありません）。この管理モードは、動作を微調整する必要がないシンプルな設定を望むユーザーに最適です。
Turnstileウィジェットをコンパクトモードで設定できます。これは管理ウィジェットと同様に機能します。
訪問者は、ブラウザのチャレンジが実行されている間、読み込みバーのあるウィジェットを表示します。管理モードとは異なり、訪問者はウィジェットと対話する必要がないか、促されることはありません。このモードは、訪問者の体験を優先し、Turnstileの対話による摩擦を追加したくないユーザーに最適です。
このモードは非対話モードに似ており、訪問者はTurnstileウィジェットと対話することはありません。訪問者はウィジェットや、目に見えないブラウザチャレンジが進行中であることを示すいかなる指示も見ることはありません。インビジブルチャレンジは、完了するのに数秒かかるはずです。
チャレンジ中に不明なエラーが発生した場合、訪問者はこのウィジェット状態に遭遇します。訪問者はリフレッシュしてチャレンジを再試行できます。エラーが続く場合は、ウィジェットのフィードバックを送信を選択してフィードバックフォームを送信できます。
詳細については、フィードバックレポートを参照してください。
チャレンジが長時間解決されない場合、ページまたはウィジェットを再読み込みして再発行する必要があります。
トークンが発行されたが、ユーザーが長時間チャレンジを解決しなかった場合、ウィジェットは期限切れになります。ページまたはウィジェットを再読み込みする必要があります。
古いブラウザやサポートされていないブラウザを使用している訪問者は、このウィジェット状態に遭遇します。サポートされているブラウザに関する詳細については、サポートされているブラウザを参照してください。