#ctx.openView()

Membuka view tertentu (drawer, popup, halaman embedded, dll.) secara programmatic. Disediakan oleh FlowModelContext, untuk membuka view ChildPage atau PopupAction yang sudah dikonfigurasi pada skenario seperti JSBlock, sel tabel, event flow, dll.

#Skenario Penggunaan

Perhatian: ctx.openView perlu tersedia pada environment RunJS yang memiliki konteks FlowModel; jika model yang sesuai dengan uid tidak ada, akan otomatis membuat PopupActionModel dan mempersistensikannya.

#Signature

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

#Penjelasan Parameter

#uid

Identifier unik dari model view. Jika tidak ada akan otomatis dibuat dan disimpan. Disarankan menggunakan UID yang stabil, seperti ${ctx.model.uid}-detail, agar konfigurasi dapat digunakan kembali saat membuka popup yang sama beberapa kali.

#Field Umum options

#Contoh

#Penggunaan Dasar: Membuka Drawer

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

#Meneruskan Konteks Baris Saat Ini

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

#Membuka melalui runAction

Saat model dikonfigurasi dengan action openView (seperti field relasi, field yang dapat diklik), dapat memanggil:

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

#Menyuntikkan Konteks Kustom

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

#Hubungan dengan ctx.viewer, ctx.view

ctx.openView membuka FlowPage (ChildPageModel), internal akan merender flow page lengkap; ctx.viewer membuka konten React sembarang.

#Hal yang Perlu Diperhatikan

• uid disarankan terkait dengan ctx.model.uid (seperti ${ctx.model.uid}-xxx), untuk menghindari konflik antar block
• Saat meneruskan defineProperties / defineMethods, navigation akan dipaksa menjadi false, untuk mencegah konteks hilang setelah refresh
• ctx.view dalam popup menunjuk ke instance view saat ini, ctx.view.inputArgs dapat membaca parameter yang diteruskan saat dibuka

#Terkait

• ctx.view: Instance view yang sedang terbuka
• ctx.model: Model saat ini, untuk membangun popupUid yang stabil