getProperty
getProperty
이 폼의 속성(Property) 값을 읽어옵니다.
파라미터
name(string): 읽을 속성 이름 (LucyStudio 디자이너에서 폼에 정의된 Property 이름)
반환: any — 속성의 현재 값. 해당 속성이 없으면 null 반환
주요 속성 목록
| name | 반환 타입 | 설명 |
|---|---|---|
"id" | String | 현재 폼 ID |
"title" | String | 폼 타이틀 |
"orientation" | String | 레이아웃 방향. 반환값: "inherit", "auto", "vertical", "horizontal" 중 하나. 기본값은 "inherit" |
"designWidth" | double? | 디자인 기준 너비 |
"designHeight" | double? | 디자인 기준 높이 |
"backgroundColor" | Color? | 배경색 |
노트
등록되지 않은 속성명을 전달하면 null이 반환되며 에러는 발생하지 않습니다.
Example
// 폼 ID 확인 (재사용 폼에서 어떤 폼인지 식별)
var formId = $form.getProperty("id");
$log.i("현재 폼:", formId);
// 타이틀 확인 후 조건부 변경
var title = $form.getProperty("title");
if (title !== "편집 중") {
$form.setProperty("title", "편집 중");
}
// 디자인 너비로 비율 계산
var dw = $form.getProperty("designWidth");
$log.i("기준 너비:", dw);
관련
$form.setProperty(name, value)— 속성 값 변경