Wix Blocks:Wix Blocks アプリのダッシュボードページを作成・管理する
読了時間:6分
Wix Blocks はすべての Wix Studio ユーザー様にリリースされました。Wix Blocks にアクセスするには、Wix Studio に参加してください。
Wix Blocks では、作成したアプリにダッシュボードページを追加することができます。追加したダッシュボードページでは、サイト制作者がアプリのデータや設定を管理することができます。以下は、Wix ポートフォリオアプリのダッシュボードページの一例です。
サイト制作者が Wix Blocks アプリをサイトにインストールすると、サイトダッシュボードにアプリの名前が付いたダッシュボードページが表示されます。
ダッシュボードページを作成する
「アプリの構造」メニュー の「アプリのダッシュボード」 から、Wix Blocks アプリにダッシュボードページを追加します。
ダッシュボードページには以下が含まれます:
- レイアウトツール、ボタン、テキスト入力欄などの要素を追加できるキャンバス。Wix Blocks には、ダッシュボードで一般的に使用されるユーザーインターフェース(UI)のテンプレートが用意されています。もちろん、このテンプレートはカスタマイズ可能で、Wix Blocks でウィジェットをデザインするのと同じように、ダッシュボードページをデザインすることができます。
- ダッシュボードにコードを追加するためのコードセクション。
重要:
現在、Wix Blocks アプリのダッシュボードページは、1つのみ作成することができます。
ダッシュボードページでマルチステートボックスを使用する
アクションボタンにダッシュボードページを割り当てる
ダッシュボードページを開くには、ウィジェット内にあるいずれかの要素のメインアクションのボタンを使用するのが最も一般的な方法です。これを行うには:
- 「設定」タブに移動します。
- 設定したいウィジェットまたは要素をクリックします。
- 「アクションバーを編集」をクリックします。
- 左側にあるメインアクションのボタンにマウスオーバーします。
- 「アクションボタンの設定」をクリックします。
- 「ダッシュボード」を選択します。
- ダッシュボードページを選択します。
カスタムパネルからダッシュボードページを開く
Wix Blocks パネルビルダーでカスタムパネルを作成すると、そのパネルからダッシュボードページを開くことができるようになります。(パネルについての詳細はこちら)これを行うには:
まず、ダッシュボードの URL を取得します。
- 「アプリのダッシュボード」メニュー に移動します。
- ダッシュボードページの名前にマウスオーバーし、「その他のアクション」アイコン をクリックします。
- 「リンクをコピー」をクリックします。
次に、パネルコードでこの URL を使用します。
- 「パネル」タブに移動します。
- 「マイパネル」メニューからパネルを選択します。
- パネルのコードセクションに移動します(コードセクションが表示されない場合は「最大化」アイコン をクリックします)。
- wix-editor モジュールをインポートします:
1import wixEditor from 'wix-editor';
- パネルからダッシュボードページを開くことができるよう、以下を参考にして openDashboardPanel() 関数のパラメータに、先ほどコピーしたダッシュボードの URL をペーストします。
1wixEditor.openDashboardPanel('app/771680a8-ad76-4a3c-8bfc-4e2873de96c9');
ダッシュボードページにコードを追加する
ダッシュボードページのコードセクションを使用して、ダッシュボードページにコードを追加します。コードには以下を含めることができます:
- ウィジェットと類似したビジネスロジック(ウィジェットコードについての詳細はこちら)(英語)
- アプリのコレクションに保存されているデータの操作(Wix Blocks のコレクションについての詳細はこちら)
- ダッシュボードページ固有のアクション(wix-dashboard 関数についての詳細はこちら)(英語)
ダッシュボードページにコードを追加する方法:
- 「アプリのダッシュボード」メニュー からダッシュボードを開きます。
- ダッシュボードのコードセクションに移動します(コードセクションが表示されない場合は「最大化」アイコン をクリックします)。
ダッシュボードページと Wix デベロッパーセンター
Wix Blocks で作成されたダッシュボードページは、Wix デベロッパーセンターの My Apps の「コンポーネント」ページにも表示されます。(英語)これは、Blocks Dashboard という名前のコンポーネントとして表示されます。
重要:
Wix デベロッパーセンターからは、Wix Blocks アプリのダッシュボードページを編集しないようにしてください。
Wix デベロッパーセンターからも Wix Blocks アプリのダッシュボードページを作成することはできますが、その場合 Wix Blocks で作成するものとは異なり、ページが iFrame の URL で構成されます。(英語)そのため、この記事で紹介したすべての機能を利用することはできなくなるためご注意ください。なお、Wix デベロッパーセンターでは、これは Dashboard という名前のコンポーネントとして表示されます。
アプリをサイトにインストールすると、サイトダッシュボードに両方の種類のページが表示されます。