#ctx.model

현재 RunJS 실행 컨텍스트가 위치한 FlowModel 인스턴스로, JSBlock, JSField, JSAction 등의 시나리오에서 기본 엔트리 포인트 역할을 합니다. 구체적인 타입은 컨텍스트에 따라 BlockModel, ActionModel, JSEditableFieldModel 등의 하위 클래스로 달라질 수 있습니다.

#적용 시나리오

팁: 만약 현재 JS를 포함하는 부모 블록(예: 폼/테이블 블록)에 접근해야 한다면 ctx.blockModel을 사용하고, 다른 모델에 접근해야 한다면 ctx.getModel(uid)를 사용하세요.

#타입 정의

model: FlowModel;

FlowModel은 기본 클래스이며, 실제 런타임 시에는 다양한 하위 클래스(BlockModel, FormBlockModel, TableBlockModel, JSEditableFieldModel, ActionModel 등)의 인스턴스가 됩니다. 사용 가능한 속성과 메서드는 타입에 따라 다릅니다.

#주요 속성

#주요 메서드

#ctx.blockModel, ctx.getModel과의 관계

JSField에서 ctx.model은 필드 모델이며, ctx.blockModel은 해당 필드를 포함하는 폼/테이블 블록입니다.

#예시

#블록/액션 상태 업데이트

ctx.model.setProps({ loading: true });
await doSomething();
ctx.model.setProps({ loading: false });

#모델 이벤트 디스패치

// 이벤트를 디스패치하여, 해당 모델에 설정된 해당 이벤트 이름의 워크플로우를 트리거합니다.
await ctx.model.dispatchEvent('remove');
// payload와 함께 전달하면 워크플로우 핸들러의 ctx.inputArgs로 전달됩니다.
await ctx.model.dispatchEvent('customEvent', { id: 123 });

#UID를 사용한 팝업 바인딩 또는 교차 모델 접근

const myUid = ctx.model.uid;
// 팝업 설정에서 openerUid: myUid를 전달하여 연관시킬 수 있습니다.
const other = ctx.getModel('other-block-uid');
if (other) other.rerender?.();

#관련 문서

• ctx.blockModel: 현재 JS가 포함된 부모 블록 모델
• ctx.getModel(): UID로 다른 모델 가져오기