본문으로 건너뛰기

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) — 속성 값 변경