ルーティング

Workshopのルーティングは、モジュールの特定の状態やビューをURLに書き込むことを可能にし、リンク共有を通じてこれらのビューを他のユーザーと簡単に共有できるようにします。

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

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

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

ページのルーティング

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

変数のルーティング

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

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

• In URL when used by visible widget or layout: 以下の場合にのみ、URLに変数の値が含まれます：
  • 値が変数のデフォルト値ではない
  • 変数が現在のビューに表示されるウィジェットまたはレイアウトで使用されている
• Always in URL: 値が変数のデフォルト値でない限り、URLには常に変数の値が含まれます。
• Never in URL: ルーティングのトグルが無効になっている場合、URLには変数の値が含まれません。

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

制限

URLでサポートされていない変数のタイプ

以下の変数タイプはURLで使用できません：

• オブジェクトセットフィルター変数
• オブジェクトセット変数はRIDによって指定された単一のオブジェクトに限定されます

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

埋め込まれたモジュールからのルーティング設定の継承なし

Workshopモジュールの埋め込みは、埋め込まれたモジュールのルーティング設定を引き継ぎません。埋め込まれたモジュールの変数値をルーティングで使用するには、子モジュールのmodule interfaceに目的の変数を追加し、親モジュールから埋め込みモジュールの設定でルーティング変数を渡します。

モバイル互換性

ルーティングは現在、Workshop mobileと互換性がありません。