튜토리얼 - 네이버 인기검색어
기본정보
위젯의 설정창은 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 속성값이 각각 최소, 최대 선택 가능한 개수로 지정됩니다. | - |
<widget:preferences>
<widget:preference name="theme" type="list" label="기본 주제" comment="기본으로 보여줄 주제를 정해주세요." defaultValue="people">
<widget:option value="movie" label="영화-전체" />
<widget:option value="schedulemovie" label="영화-개봉 예정 영화" />
<widget:option value="runningmovie" label="영화-상영중 영화" />
<widget:option value="people" label="인물-전체" />
<widget:option value="singer" label="인물-국내가수" />
<widget:option value="foreignsinger" label="인물-외국가수" />
<widget:option value="actor" label="배우" />
<widget:option value="talent" label="국내배우" />
<widget:option value="foreignactor" label="외국배우" />
<widget:option value="entertainer" label="인물-TV연예인" />
<widget:option value="broadcaster" label="인물-방송인" />
<widget:option value="comedian" label="인물-개그맨" />
<widget:option value="sportsstar" label="인물-스포츠스타" />
<widget:option value="soccer" label="인물-국내축구인" />
<widget:option value="foreignsoccer" label="인물-해외축구인" />
<widget:option value="drama" label="TV-드라마" />
<widget:option value="broadcast" label="TV-오락프로" />
<widget:option value="game" label="취미-게임" />
<widget:option value="perform" label="취미-공연" />
<widget:option value="book" label="취미-도서" />
<widget:option value="university" label="대학교" />
</widget:preference>
</widget:preferences>