#ctx.blockModel

현재 JS 필드 / JS 블록이 위치한 부모 블록 모델(BlockModel 인스턴스)입니다. JSField, JSItem, JSColumn 등의 시나리오에서 ctx.blockModel은 현재 JS 로직을 포함하고 있는 폼 블록이나 테이블 블록을 가리킵니다. 독립적인 JSBlock에서는 null이거나 ctx.model과 동일할 수 있습니다.

#적용 시나리오

주의: ctx.blockModel은 부모 블록이 존재하는 RunJS 컨텍스트에서만 사용할 수 있습니다. 부모 폼/테이블이 없는 독립적인 JSBlock에서는 null일 수 있으므로, 사용 전에 null 체크를 권장합니다.

#타입 정의

blockModel: BlockModel | FormBlockModel | TableBlockModel | CollectionBlockModel | DataBlockModel | null;

구체적인 타입은 부모 블록의 타입에 따라 달라집니다. 폼 블록은 주로 FormBlockModel, EditFormModel이며, 테이블 블록은 주로 TableBlockModel입니다.

#주요 속성

#ctx.model, ctx.form과의 관계

JSField에서 ctx.model은 필드 모델이며, ctx.blockModel은 해당 필드를 포함하는 폼 또는 테이블 블록입니다. ctx.form은 일반적으로 ctx.blockModel.form과 같습니다.

#예시

#테이블: 선택된 행 가져오기 및 처리

const rows = ctx.blockModel?.resource?.getSelectedRows?.() || [];
if (rows.length === 0) {
  ctx.message.warning('데이터를 먼저 선택해 주세요');
  return;
}

#폼 시나리오: 유효성 검사 및 새로고침

if (ctx.blockModel?.form) {
  await ctx.blockModel.form.validateFields();
  await ctx.blockModel.resource?.refresh?.();
}

#폼 변경 감지

ctx.blockModel?.emitter?.on?.('formValuesChange', (payload) => {
  // 최신 폼 값에 따라 연동 또는 다시 렌더링 수행
});

#블록 다시 렌더링 트리거

ctx.blockModel?.rerender?.();

#주의사항

• 부모 폼이나 테이블 블록이 없는 독립적인 JSBlock에서는 ctx.blockModel이 null일 수 있습니다. 속성에 접근하기 전에 옵셔널 체이닝을 사용하는 것이 좋습니다: ctx.blockModel?.resource?.refresh?.().
• JSField / JSItem / JSColumn에서 ctx.blockModel은 현재 필드를 포함하는 폼 또는 테이블 블록을 가리킵니다. JSBlock에서는 실제 계층 구조에 따라 자기 자신 또는 상위 블록일 수 있습니다.
• resource는 데이터 블록에만 존재하며, form은 폼 블록에만 존재합니다. 테이블 블록에는 일반적으로 form이 없습니다.

#관련 정보

• ctx.model: 현재 실행 컨텍스트의 모델
• ctx.form: 폼 인스턴스, 폼 블록에서 주로 사용
• ctx.resource: 리소스 인스턴스 (ctx.blockModel?.resource와 동일하며, 존재할 경우 직접 사용 가능)
• ctx.getModel(): UID로 다른 블록 모델 가져오기