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

Workshop にウィジェットを埋め込む

Workshop にウィジェットを埋め込むには、まず Workshop にカスタムウィジェットコンポーネントを追加します。

カスタムウィジェットレンダラーを選択します。

新しいウィジェットの設定タブで、選択を見つけ、使用するウィジェットセットとバージョンを選択します。

新しいウィジェットをウィジェットセットとバージョンのセレクターに表示するには、少なくとも1回は公開する必要があります。新しいウィジェットの初回リリース後は、開発モードを使用して、ウィジェットのコード、パラメーター、イベントに対する未公開の変更を Workshop 内で直接プレビューできます。

パラメーターとイベントを設定する

ウィジェットが使用するパラメーターを Workshop 変数にバインドすると、Workshop の状態との間でデータを受け渡しできます。利用可能なパラメーターのデータ型については、パラメーターとイベントを参照してください。

イベントを使用すると、ウィジェットがパラメーター値を更新できるようになります。また、これらのイベントを Workshop イベントにバインドすると、ウィジェットがイベントを発火したときに、Workshop イベントもトリガーされます。

ウィジェットのパラメーターとイベントは、ウィジェットの設定パネルで Workshop の変数とイベントにバインドできます。

イベントとパラメーターの設定。

制限事項

デフォルトでは、カスタムウィジェットはページから削除され、その後再び表示されると再読み込みされます。ナビゲーションをまたいでローカル状態を保持するには、ウィジェットの表示最適化を設定して、ウィジェットのマウント状態を保持します。また、ウィジェットに渡す Workshop 変数にカスタムウィジェットのデータを保存することもできます。

トラブルシューティング

ブラウザーのパフォーマンスの問題、クラッシュ、予期しない動作への対処については、トラブルシューティングを参照してください。