#ctx.getModel()

Mendapatkan instance model (seperti BlockModel, PageModel, ActionModel, dll.) di engine atau view stack saat ini berdasarkan uid model, untuk mengakses model lain di RunJS lintas block, lintas halaman, atau lintas popup.

Jika hanya membutuhkan model atau block tempat konteks eksekusi saat ini berada, lebih utamakan ctx.model atau ctx.blockModel, tidak perlu menggunakan ctx.getModel.

#Skenario Penggunaan

#Definisi Tipe

getModel<T extends FlowModel = FlowModel>(
  uid: string,
  searchInPreviousEngines?: boolean
): T | undefined

#Parameter

#Return Value

• Jika ditemukan akan mengembalikan instance subclass FlowModel yang sesuai (seperti BlockModel, FormBlockModel, ActionModel).
• Jika tidak ditemukan mengembalikan undefined.

#Lingkup Pencarian

• Default (searchInPreviousEngines: false): hanya mencari berdasarkan uid di engine saat ini. Pada popup, multi-level view, setiap view memiliki engine independen, secara default hanya mencari model di view saat ini.
• searchInPreviousEngines: true: mulai dari engine saat ini, mencari ke atas mengikuti rantai previousEngine, segera mengembalikan saat hit. Cocok untuk popup yang ingin mengakses model tertentu pada halaman yang membukanya.

#Contoh

#Mendapatkan Block Lain dan Refresh

const block = ctx.getModel('list-block-uid');
if (block?.resource) {
  await block.resource.refresh();
}

#Mengakses Model di Halaman Dari Dalam Popup

// Dalam popup perlu mengakses block di halaman yang membukanya
const pageBlock = ctx.getModel('page-block-uid', true);
if (pageBlock) {
  pageBlock.rerender?.();
}

#Membaca/Menulis Lintas Model dan Memicu Rerender

const target = ctx.getModel('other-block-uid');
if (target) {
  target.setProps({ loading: true });
  target.rerender?.();
}

#Pengecekan Aman

const model = ctx.getModel(someUid);
if (!model) {
  ctx.message.warning('Model target tidak ada');
  return;
}

#Terkait

• ctx.model: Model dalam konteks eksekusi saat ini
• ctx.blockModel: Model parent block tempat JS saat ini berada, biasanya dapat diakses tanpa getModel