#ctx.collectionField

Instance field collection (CollectionField) liên kết với ngữ cảnh thực thi RunJS hiện tại, dùng để truy cập metadata, kiểu, quy tắc validate và thông tin quan hệ của field. Chỉ tồn tại khi field được liên kết với định nghĩa collection; field tùy chỉnh/ảo có thể là null.

#Kịch bản áp dụng

Lưu ý: ctx.collectionField chỉ khả dụng khi field được liên kết với định nghĩa collection (Collection); trong JSBlock độc lập, sự kiện action không có liên kết field, v.v., thường là undefined, khuyến nghị kiểm tra null trước khi sử dụng.

#Định nghĩa kiểu

collectionField: CollectionField | null | undefined;

#Thuộc tính thường dùng

#Phương thức thường dùng

#Ví dụ

#Render phân nhánh theo kiểu field

if (!ctx.collectionField) return null;
const { interface: iface } = ctx.collectionField;
if (['m2o', 'o2m', 'm2m'].includes(iface)) {
  // Field quan hệ: hiển thị bản ghi liên quan
  const target = ctx.collectionField.targetCollection;
  // ...
} else if (iface === 'select' || iface === 'radioGroup') {
  const options = ctx.collectionField.enum || [];
  // ...
}

#Kiểm tra có phải field quan hệ và truy cập collection đích

if (ctx.collectionField?.isAssociationField()) {
  const targetCol = ctx.collectionField.targetCollection;
  const titleField = targetCol?.titleCollectionField?.name;
  // Xử lý theo cấu trúc collection đích
}

#Lấy tùy chọn enum

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

#Render có điều kiện theo chế độ chỉ đọc/chỉ hiển thị

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)} />);
}

#Lấy field tiêu đề của collection đích quan hệ

// Khi hiển thị field quan hệ, có thể dùng titleCollectionField của collection đích để lấy tên field tiêu đề
const titleField = ctx.collectionField?.targetCollectionTitleField;
const titleKey = titleField?.name ?? 'title';
const assocValue = ctx.getValue?.() ?? ctx.record?.[ctx.collectionField?.name];
const label = assocValue?.[titleKey];

#Quan hệ với ctx.collection

ctx.collection thường biểu thị collection được liên kết với block hiện tại; ctx.collectionField biểu thị định nghĩa field hiện tại trong collection. Trong các kịch bản như sub-table, field quan hệ, hai cái này có thể khác nhau.

#Lưu ý

• Trong các kịch bản như JSBlock, JSAction (không có liên kết field), ctx.collectionField thường là undefined, khuyến nghị sử dụng optional chaining khi truy cập.
• JS field tùy chỉnh nếu chưa được liên kết với field collection, ctx.collectionField có thể là null.
• targetCollection chỉ tồn tại với field kiểu quan hệ (như m2o, o2m, m2m); enum chỉ tồn tại với field có tùy chọn như select, radioGroup.

#Liên quan

• ctx.collection: Collection được liên kết với ngữ cảnh hiện tại
• ctx.model: Model nơi ngữ cảnh thực thi hiện tại đang nằm
• ctx.blockModel: Block cha chứa JS hiện tại
• ctx.getValue(), ctx.setValue(): Đọc/ghi giá trị field hiện tại