#ctx.openView()

プログラムによって指定されたビュー（ドロワー、ポップアップ、埋め込みページなど）を開きます。FlowModelContext から提供され、JSBlock、テーブルセル、イベントフローなどのシナリオで、設定済みの ChildPage または PopupAction ビューを開くために使用されます。

#適用シナリオ

注意：ctx.openView は FlowModel コンテキストが存在する RunJS 環境で利用可能です。uid に対応するモデルが存在しない場合、PopupActionModel が自動的に作成され、永続化されます。

#シグネチャ

openView(uid: string, options?: OpenViewOptions): Promise<void>

#パラメータ説明

#uid

ビューモデルの一意識別子。存在しない場合は自動的に作成・保存されます。同じポップアップを複数回開く際に設定を再利用できるよう、${ctx.model.uid}-detail のような安定した UID を使用することをお勧めします。

#options の主なフィールド

#例文

#基本的な使い方：ドロワーを開く

const popupUid = `${ctx.model.uid}-detail`;
await ctx.openView(popupUid, {
  mode: 'drawer',
  size: 'medium',
  title: ctx.t('詳細'),
});

#現在の行のコンテキストを渡す

const primaryKey = ctx.collection?.primaryKey || 'id';
await ctx.openView(`${ctx.model.uid}-1`, {
  mode: 'dialog',
  title: ctx.t('行の詳細'),
  params: {
    filterByTk: ctx.record?.[primaryKey],
    record: ctx.record,
  },
});

#runAction を介して開く

モデルに openView アクション（関連フィールドやクリック可能なフィールドなど）が設定されている場合、以下のように呼び出すことができます：

await ctx.runAction('openView', {
  navigation: false,
  mode: 'dialog',
  collectionName: 'users',
  filterByTk: ctx.record?.id,
});

#カスタムコンテキストの注入

await ctx.openView(`${ctx.model.uid}-edit`, {
  mode: 'drawer',
  filterByTk: ctx.record?.id,
  defineProperties: {
    onSaved: {
      get: () => () => ctx.resource?.refresh?.(),
      cache: false,
    },
  },
});

#ctx.viewer、ctx.view との関係

ctx.openView は FlowPage (ChildPageModel) を開き、内部で完全なフローページをレンダリングします。一方、ctx.viewer は任意の React コンテンツを開きます。

#注意事項

• uid は複数のブロック間での衝突を避けるため、ctx.model.uid と関連付ける（例：${ctx.model.uid}-xxx）ことをお勧めします。
• defineProperties または defineMethods を渡すと、リフレッシュ後のコンテキスト消失を防ぐため、navigation は強制的に false に設定されます。
• ポップアップ内の ctx.view は現在のビューインスタンスを指し、ctx.view.inputArgs で開始時に渡されたパラメータを読み取ることができます。

#関連情報

• ctx.view：現在開いているビューインスタンス
• ctx.model：現在のモデル。安定した popupUid を構築するために使用されます。