#ctx.collectionField

Instance field data table (CollectionField) yang terkait dengan konteks eksekusi RunJS saat ini, untuk mengakses metadata field, tipe, aturan validasi, dan informasi relasi. Hanya ada saat field terikat ke definisi data table; field kustom/virtual mungkin null.

#Skenario Penggunaan

Perhatian: ctx.collectionField hanya tersedia saat field terikat ke definisi data table (Collection); pada skenario seperti JSBlock independen, action event tanpa field binding biasanya undefined, disarankan melakukan pengecekan null sebelum digunakan.

#Definisi Tipe

collectionField: CollectionField | null | undefined;

#Properti Umum

#Method Umum

#Contoh

#Render Cabang Berdasarkan Tipe Field

if (!ctx.collectionField) return null;
const { interface: iface } = ctx.collectionField;
if (['m2o', 'o2m', 'm2m'].includes(iface)) {
  // Field relasi: tampilkan record relasi
  const target = ctx.collectionField.targetCollection;
  // ...
} else if (iface === 'select' || iface === 'radioGroup') {
  const options = ctx.collectionField.enum || [];
  // ...
}

#Memeriksa Apakah Field Relasi dan Mengakses Data Table Target

if (ctx.collectionField?.isAssociationField()) {
  const targetCol = ctx.collectionField.targetCollection;
  const titleField = targetCol?.titleCollectionField?.name;
  // Proses berdasarkan struktur data table target
}

#Mendapatkan Opsi Enum

const options = ctx.collectionField?.enum ?? [];
const labels = options.map((o) => (typeof o === 'object' ? o.label : o));

#Render Bersyarat Berdasarkan Mode Read-only/Display

const { Input } = ctx.libs.antd;
if (ctx.collectionField?.readonly) {
  ctx.render(<span>{ctx.getValue?.() ?? '-'}</span>);
} else {
  ctx.render(<Input onChange={(e) => ctx.setValue?.(e.target.value)} />);
}

#Mendapatkan Field Judul dari Data Table Target Relasi

// Saat menampilkan field relasi, dapat menggunakan titleCollectionField dari data table target untuk mendapatkan nama field judul
const titleField = ctx.collectionField?.targetCollectionTitleField;
const titleKey = titleField?.name ?? 'title';
const assocValue = ctx.getValue?.() ?? ctx.record?.[ctx.collectionField?.name];
const label = assocValue?.[titleKey];

#Hubungan dengan ctx.collection

ctx.collection biasanya merepresentasikan data table yang terikat block saat ini; ctx.collectionField merepresentasikan definisi field saat ini di data table. Pada skenario seperti sub-table, field relasi, keduanya mungkin berbeda.

#Hal yang Perlu Diperhatikan

• Pada skenario seperti JSBlock, JSAction (tanpa field binding), ctx.collectionField biasanya undefined, disarankan menggunakan optional chaining sebelum mengakses.
• JS field kustom yang tidak terikat ke field data table, ctx.collectionField mungkin null.
• targetCollection hanya ada pada field tipe relasi (seperti m2o, o2m, m2m); enum hanya ada pada field dengan opsi seperti select, radioGroup.

#Terkait

• ctx.collection: Data table terkait konteks saat ini
• ctx.model: Model dalam konteks eksekusi saat ini
• ctx.blockModel: Parent block yang menampung JS saat ini
• ctx.getValue(), ctx.setValue(): Membaca/menulis nilai field saat ini