튜토리얼 - 올블로그
기본정보
위젯의 설정창은 preferences 태그를 통해서 표현하며, 이 태그는 http://wzdapi.com/widget/namespace 에 속해 있습니다.
또한 preferences 태그는 다수의 preference 태그를 포함하며 속성목록은 다음과 같습니다.
| 속성 | 설명 | 필수여부 |
|---|---|---|
| type | 설정값 타입으로 text, textarea, hidden, boolean, list, list.image, range, weather.location, date.calendar, color 이 사용 가능합니다. | 필수 |
| name | 설정 값에 접근할 때 사용할 이름을 표시합니다. | 필수 |
| label | 실제 설정창에 표시될 이름을 넣습니다. 단 type이 hidden인 경우는 설정창에 표시되지 않으며 해당 값은 무시됩니다. | - |
| defaultValue | 위젯을 처음 사용할 때 사용될 값을 넣습니다. | - |
| required | 해당 설정값을 반드시 입력 받아야 할 경우 "true" 로 지정합니다. | - |
| writeOnce | 위젯을 퍼간 때만 설정값을 지정할 수 있도록 하기 위해서는 "true"로 지정합니다. | - |
| comment | 설정값에 기타 추가적인 설명이 필요한 경우 입력합니다. | - |
| value | type이 list, list.image인 경우 widget:option 태그의 속성으로 사용되며 해당 값을 지정합니다. | - |
| src | type이 list.image인 경우 widget:option 태그의 속성으로 사용되며 해당 이미지 경로를 지정합니다. | - |
| min | type이 range인 경우 사용되며 최소(시작)값을 지정합니다. | - |
| max | type이 range인 경우 사용되며 최대(마지막)값을 지정합니다. | - |
| step | type이 range인 경우 사용되며 증가값을 지정합니다. | - |
| maxlength | type이 text인 경우 설정값을 입력받는 문자열의 최대값을 지정합니다. | - |
| multiple | type이 list.image인 경우 여러 개의 값을 선택할 수 있으며 min, max 속성값이 각각 최소, 최대 선택 가능한 개수로 지정됩니다. | - |