clearVar
clearVar
폼 변수를 LucyStudio에서 선언 시 지정한 초기값으로 초기화합니다.
파라미터
localVarName(string): LucyStudio 폼 설정에서 사전 정의된 변수명
반환: 없음 (void)
설명
$form.clearVar는 지정된 폼 변수를 null로 초기화하는 것이 아니라, LucyStudio 디자이너에서 변수 선언 시 설정한 기본값(초기값)으로 복원합니다. 내부적으로 LucyVarMngr.clearVarValue(_mapFormVar, localVarName)를 호출합니다.
경고
clearVar 후의 값은 null이 아닌 LucyStudio에서 정의한 기본값입니다. 초기화 후 getVar로 실제 값을 확인하세요.
$form vs $app vs $page 비교
| 구분 | $form.clearVar | $app.clearVar | $page.clearVar |
|---|---|---|---|
| 스코프 | 현재 폼 인스턴스 | 앱 전역 공유 | ❌ 미지원 |
| 초기화 기준 | LucyStudio 폼에서 선언한 기본값 | LucyStudio 앱에서 선언한 기본값 | — |
| 생명주기 | 폼이 닫히면 소멸 | 앱 실행 중 유지 | — |
Example
// 카운트 변수를 LucyStudio에서 선언한 초기값으로 복원
$form.clearVar("count");
var restored = $form.getVar("count");
$log.i("초기화 후 카운트:", restored); // LucyStudio에서 선언한 기본값 출력
// 여러 변수 초기화
$form.clearVar("userName");
$form.clearVar("selectedItem");
관련
$form.setVar(localVarName, data)— 폼 변수 설정$form.getVar(localVarName)— 폼 변수 읽기$app.clearVar(appVarName)— 앱 전역 변수를 초기값으로 초기화