튜토리얼 - 환율
기본정보
위젯의 설정창은 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="currency" type="list" label="통화명" defaultValue="usd">
<widget:option value="usd" label="미국(USD)" />
<widget:option value="eur" label="유로연합(EUR)" />
<widget:option value="gbp" label="영국(GBP)" />
<widget:option value="hkd" label="홍콩(HKD)" />
<widget:option value="jpy" label="일본(JPY) 100" />
<widget:option value="thb" label="태국(THB)" />
<widget:option value="php" label="필리핀(PHP)" />
<widget:option value="cny" label="중국원화(CNY)" />
<widget:option value="cad" label="캐나다(CAD)" />
<widget:option value="chf" label="스위스(CHF)" />
<widget:option value="aud" label="호주(AUD)" />
<widget:option value="dkk" label="덴마크(DDK)" />
<widget:option value="nzd" label="뉴질랜드(NZD)" />
<widget:option value="nok" label="노르웨이(NOK)" />
<widget:option value="sar" label="사우디(SAR)" />
<widget:option value="kwd" label="쿠웨이트(KWD)" />
<widget:option value="bhd" label="바레인(BHD)" />
<widget:option value="aed" label="아랍에미(AED)" />
<widget:option value="sgd" label="싱가포르(SGD)" />
<widget:option value="inr" label="인도(INR)" />
<widget:option value="myr" label="말레이지아(MYR)" />
<widget:option value="idr" label="인도네시아(IDR)" />
<widget:option value="pkr" label="파키스탄(PKR)" />
<widget:option value="bdt" label="방글라데시(BDT)" />
<widget:option value="egp" label="이집트(EGP)" />
<widget:option value="mxn" label="맥시코(MXN)" />
<widget:option value="brl" label="브라질(BRL)" />
<widget:option value="bnd" label="브르네이(BND)" />
<widget:option value="twd" label="대만(TWD)" />
</widget:preference>
</widget:preferences>