clearVar
clearVar
フォーム変数を、LucyStudioで宣言時に指定した初期値に戻します。
パラメータ
localVarName(string): LucyStudioのフォーム設定であらかじめ定義された変数名
戻り値: なし(void)
説明
$form.clearVarは指定したフォーム変数をnullにするのではなく、LucyStudioデザイナーで変数を宣言したときに設定した既定値(初期値)に復元します。内部ではLucyVarMngr.clearVarValue(_mapFormVar, localVarName)を呼び出します。
警告
clearVar後の値はnullではなく、LucyStudioで定義した既定値です。初期化後はgetVarで実際の値を確認してください。
$form・$app・$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)— アプリ全体の変数を初期値に戻す