注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

ルーティング

Workshop のルーティングでは、モジュールの特定の状態や表示を URL に書き込めるため、リンクの共有を通じて、これらの表示をほかのユーザーと簡単に共有できます。

URL ルーティングが設定された Workshop モジュール。

ルーティングを有効にする

Workshop モジュールのルーティングを有効にするには、左側の設定パネルのページセクションに移動し、ルーティングを有効化オプションをオンにします。

ページセクションには、ルーティングで使用されるページの概要が表示されます。また、以下に示すように、使用中の変数を示す追加のパネルも表示されます。

ルーティングを有効にすると、現在のページの ID が URL に書き込まれます。ページIDが定義されていないページでは、ページIDは URL に書き込まれず、ページの読み込み時にモジュールのデフォルトページに戻ります。

モジュールで変数に基づくページ選択も使用している場合は、ページ選択変数にデフォルト値を設定しないでください。変数のデフォルト値は URL 内のページIDよりも優先されるため、デフォルト以外のページへのリンクを開くと、そのページが一瞬表示された後、デフォルトページにリダイレクトされます。

ルーティングを使用して、モジュールインターフェースで使用するように設定された変数の値を保存し、共有することもできます。ルーティングを有効にすると、ルーティングの URL 更新動作が設定された変数の現在の値が、URL のクエリパラメーターとして直接書き込まれます。

モジュールインターフェースの変数を URL に含めるには、次のいずれかの設定オプションを使用します。

表示中のウィジェットまたはレイアウトで使用されている場合にURLに含める： 次の条件を満たす場合にのみ、変数の値が URL に含まれます。
- 値が変数のデフォルト値ではない
- 現在の表示に含まれるウィジェットまたはレイアウトで、その変数が使用されている。
常に URL に含める： 値が変数のデフォルト値でない場合、変数の値が常に URL に含まれます。
URL に含めない： ルーティングの切り替えが無効になっている場合、変数の値は URL に含まれません。

クエリパラメーターのキーがモジュールインターフェース変数の外部IDと一致する場合、設定された URL への包含動作にかかわらず、クエリパラメーターの値が変数の初期値として使用されます。

次の変数タイプは URL で使用できません。

ただし、ほかのルーティング変数を使用して、上記の変数タイプを間接的に定義することはできます。たとえば、ルーティングで使用する文字列変数を作成し、この文字列変数を使用してオブジェクトセットフィルター変数のデフォルト値を定義できます。

Workshop モジュールを埋め込んでも、埋め込みモジュールのルーティング設定は引き継がれません。埋め込みモジュールの変数値をルーティングで使用するには、必要な変数を子モジュールのモジュールインターフェースに追加し、埋め込みモジュールの設定で親モジュールからルーティング変数を渡します。