#ctx.getModel()

모델 uid를 기반으로 현재 엔진 또는 뷰 스택에서 모델 인스턴스(예: BlockModel, PageModel, ActionModel 등)를 가져옵니다. RunJS에서 블록, 페이지 또는 팝업 간에 다른 모델에 액세스할 때 사용합니다.

현재 실행 컨텍스트가 위치한 모델이나 블록만 필요한 경우, ctx.getModel 대신 ctx.model 또는 ctx.blockModel을 우선적으로 사용하십시오.

#적용 시나리오

#타입 정의

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

#매개변수

#반환값

• 모델을 찾으면 해당 FlowModel 하위 클래스 인스턴스(예: BlockModel, FormBlockModel, ActionModel)를 반환합니다.
• 찾지 못한 경우 undefined를 반환합니다.

#검색 범위

• 기본값 (searchInPreviousEngines: false): 현재 엔진 내에서만 uid로 검색합니다. 팝업이나 다단계 뷰에서 각 뷰는 독립된 엔진을 가지며, 기본적으로 현재 뷰 내의 모델만 검색합니다.
• searchInPreviousEngines: true: 현재 엔진부터 시작하여 previousEngine 체인을 따라 위로 검색하며, 일치하는 항목을 발견하면 즉시 반환합니다. 현재 팝업을 연 페이지의 모델에 액세스할 때 유용합니다.

#예제

#다른 블록 가져오기 및 새로고침

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

#팝업에서 페이지의 모델 액세스

// 팝업 내에서 팝업을 연 페이지의 블록에 액세스해야 하는 경우
const pageBlock = ctx.getModel('page-block-uid', true);
if (pageBlock) {
  pageBlock.rerender?.();
}

#교차 모델 읽기/쓰기 및 리렌더링 트리거

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

#안전성 검사

const model = ctx.getModel(someUid);
if (!model) {
  ctx.message.warning('대상 모델이 존재하지 않습니다');
  return;
}

#관련 정보

• ctx.model: 현재 실행 컨텍스트가 위치한 모델
• ctx.blockModel: 현재 JS가 위치한 부모 블록 모델로, 일반적으로 getModel 없이도 액세스 가능합니다.