본문으로 건너뛰기

onStart

onStart

폼(페이지)이 처음 열릴 때 호출됩니다.

파라미터

  • linkArg (dynamic): 다른 페이지에서 이 페이지로 이동하면서 전달한 인자값. 전달된 값이 없으면 비어 있습니다.

반환: 반환값 없음 — 콜백 함수이므로 리턴값을 사용하지 않습니다.

설명

페이지가 로드되어 스크립트가 처음 실행될 때 호출됩니다.
페이지에 필요한 초기 데이터를 요청하거나, 전달받은 인자값을 화면에 반영하는 초기화 작업에 주로 사용합니다.
레이아웃에 배치한 위젯은 스튜디오에서 지정한 이름(레이어 ID)으로 스크립트 어디서나 바로 참조할 수 있습니다.
위젯에서 이벤트가 발생했을 때 실행할 함수는 위젯이름.onXxx = (인자) => { ... } 형태로 등록합니다. 이 등록 작업은 반드시 onStart 안에서 해야 합니다.

Example

function onStart(linkArg) {
$log.i("page started, linkArg=" + linkArg);

// 위젯 이벤트 핸들러는 onStart에서 등록합니다
btnRefresh.onTap = () => {
$vm.requestData("mainList");
};

icoBack.onTap = () => {
$act.navigatorPop();
};

if (linkArg) {
$vm.setDSValue("uiState.selectedId", linkArg);
}
}

관련 및 주의사항

  • 페이지가 다시 활성화될 때(예: 뒤로가기로 돌아옴)는 onStart가 다시 호출되지 않고 onActivate/onActive가 대신 호출됩니다. onStart는 페이지가 완전히 새로 로드될 때 딱 한 번만 호출됩니다.
  • 위젯 이벤트 핸들러 등록은 onStart에서 하는 것이 정석입니다.