モーダル内のBlock Kit ​

モーダルを使用すると、ユーザーから構造化された方法で情報を収集する、リッチでインタラクティブかつ動的なビューを作成できます。 これは、Open/update or push modal viewアクションを使用して行います。 Block Kitモーダルの例

モーダルビューはブロックを使用して構築されます。 モーダルビューには、タイトル、ビュー（ブロックで構成）、および送信/閉じるボタンがあります。 入力ブロックと呼ばれるモーダル専用ブロックも使用できます。 これには次のものがあります。

• 単一行入力
• 複数行入力
• 選択メニュー入力
• 日付ピッカー入力
• チェックボックス入力

インタラクティブコンポーネントと入力ブロックの比較 ​

入力ブロックは、他のブロックのインタラクティブコンポーネントとは異なる動作をします。

ボタン、メニュー、およびその他のインタラクティブコンポーネントは、クリックされたときにコマンドを呼び出します。 これに対し、入力ブロックはビューが送信されたときにのみコマンドを呼び出します。 たとえば、モーダルでは、ユーザーは承認または却下を選択できます。 ユーザーがSubmitボタンをクリックしてモーダルを送信した後にのみ、値が確定します。

_ユーザーの選択は、_送信__をクリックした後にのみ確定します

ビューに入力ブロックが含まれる場合、送信ボタンと閉じるボタンを定義することが必須です。 入力ブロックが含まれない場合、送信ボタンと閉じるボタンを含める必要はありません。

モーダルスタック ​

モーダルは、ビュースタック内に最大3つのビューを同時に保持できます。 ユーザーに表示されるのは最上位のビューのみで、これはアクティブビューと呼ばれます。 ビュースタックは、ユーザーがアクティブビューを送信または閉じた後に以前のビューへ戻れるようにするため便利です。

各モーダルは最大3つのビューをスタックできます

モーダルを開くと、ルートビューで開きます。 モーダルを更新すると、指定した既存のビュー（そのビューIDを使用）が置き換えられます。一方、モーダルビューをプッシュすると、ビュースタックの最上位に新しいビューが適用されます。

各ビューには関連付けられたビューIDがあります。 既存のビューを更新するには、このビューIDが必要です。

ビュー間での情報の受け渡し ​

ユーザーがインタラクティブコンポーネントを操作するかモーダルを送信すると、ボットコマンドがダウンストリームレシピをトリガーします。 このダウンストリームレシピは、モーダルビューを更新またはプッシュできます。 ダウンストリームレシピ内のモーダルアクションに必要なコンテキストを確実に提供するには、ユーザーIDや商談IDなどのパラメーターを渡します。

モーダルでは、これらの値はコマンド入力値と呼ばれます。 これにより、レシピのある部分から別の部分へ特定のデータを渡せます。 たとえば、ユーザーがモーダルでアカウントを選択し、account_idをコマンド入力値として定義した場合、それを後続のアクションに渡して、そのアカウントに関する情報を更新または取得できます。 これにより、ユーザー入力に基づく動的なピックリストの生成など、動的でインタラクティブなワークフローが可能になります。

これらのパラメーターを渡すには、ダウンストリームレシピのNew commandトリガーで定義する必要があります。 パラメーター名とデータ型が、アップストリーム側の対応するものと一致していることを確認することが重要です。 たとえば、モーダルのビュー（アップストリームレシピでレンダリング）でopportunity_idを単一行入力として使用する場合、ダウンストリームレシピのNew commandでもopportunity_idを文字列パラメーターとして指定する必要があります。

JSONを使用してパラメーターを渡すことができます。たとえば、{"opportunity_id": "OPP1234567"}または{"OpportunityId": "OPP1234567"}です。 コマンド入力値では、JSON配列およびオブジェクトをパラメーターとして渡すこともサポートされています。

たとえば、ユーザーIDの配列を渡すことができます。

{
  "user_ids": ["USER123", "USER456", "USER789"]
}

商談を説明するキー値ペアを含むオブジェクトを渡すこともできます。

{
  "opportunity": {
    "id": "OPP1234567",
    "name": "New business opportunity",
    "amount": 50000,
    "status": "Open"
  }
}

モーダルの操作 ​

次のコンポーネントを使用してモーダルを開くことができます。

• ボタン
• メニュー
• オーバーフロー
• 選択メニュー
• 日付ピッカー
• ラジオボタン
• ショートカット
• メッセージアクション
• スラッシュコマンド
• モーダルビューの送信

前述のコンポーネントはボットコマンドを呼び出し、トリガーIDを生成します。これはNew commandトリガーによって取得されます。 トリガーIDは、すべての種類のモーダルで必須です。 モーダルビューを開く、更新する、プッシュする操作には、すべてこのトリガーIDが必要です。

New commandトリガーのデータツリーには、モーダル関連のコンテキストを保存するModalsオブジェクトが含まれており、これによりモーダルアクションを実行できます。

Open/update or push modal viewアクション ​

このアクションを使用すると、ユーザーから構造化された方法で情報を収集する、リッチでインタラクティブかつ動的なモーダルを作成できます。 モーダルはブロックを使用して構築されます。

Open/update or push modal viewアクション

Modal action typeをopen、update、またはpushに設定することで、新しいモーダルビューを開く、既存のビューを更新する、または既存のビューの上に新しいビューをプッシュできます。

すべてのモーダルアクションタイプで、トリガーIDが必要です。 Slackは、ユーザーが次のコンポーネントを操作したときにトリガーIDを生成します。

• ボタン
• メニュー
• オーバーフロー
• 選択メニュー
• 日付ピッカー
• ラジオボタン
• ショートカット
• メッセージアクション
• スラッシュコマンド
• モーダルビューの送信

モーダルビューを開くには、New commandトリガーの出力からトリガーIDStep 1データピルをマッピングします。 モーダルビューを開くためのトリガーID（New commandトリガー内にあります）

モーダルビューの更新にもトリガーIDが必要ですが、更新するビューのビューIDも指定する必要があります。 このビューIDは、New commandトリガーのデータツリーのModals配下にもあります。 モーダルビューを更新するためのトリガーIDとView ID（どちらもNew commandトリガー内にあります）

モーダルビューを（既存のビューの上に）プッシュするには、トリガーIDが必要です。 ただし、このトリガーIDは既存のビューから生成されている必要があります。 モーダルビューをプッシュするためのトリガーID（New commandトリガー内にあります）

モーダルビューを更新するタイミング ​

通常、ボットコマンドはビューIDを使用して、それらが存在するアクティブビューを更新します。 アクティブビューでの変更

これに対し、モーダル送信では通常、ルートビュー（ルートビューID）または前のビュー（前のビューID）を更新します。 これらのビューは、New commandトリガーのデータツリー内のModalsにあります。

New commandトリガー内にあるRoot View IDとPrevious View ID

モーダルビューをプッシュするタイミング ​

通常、ボットコマンドはビューIDを使用して、それらが存在するアクティブビューの上にビューをプッシュします。 ビューIDは、New commandトリガーのデータツリー内のModalsにあります。

アクティブビューでの変更

New commandトリガー内にあるRoot View IDとPrevious View ID

Open/update or push modal viewアクション入力 ​

次の表では、このアクションを使用する場合の設定について説明します。