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에서 하는 것이 정석입니다.