본문으로 건너뛰기

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) — 앱 전역 변수를 초기값으로 초기화