XML 가이드

이 문서는 위젯/가젯 스펙상의 XML을 위한 참조자료입니다.

• 1. ModulePrefs 요소와 속성들

  XML파일안의 <ModulePrefs> 영역은 가젯의 특성(제목, 만든이, 지정된 사이즈 등)을 지정합니다.

  <Module> <ModulePrefs title="Widget bank" title_url="http://blog.daum.net/widgetbank" height="200" author="Widgetbank" /> <Content ...> ... content ... </Content> </Module>

  위젯/가젯을 사용하는 사용자는 이 속성들을 변경할 수 없습니다.

• 1.1 /ModulePrefs

  다음은 <ModulePrefs>의 속성입니다.

  • title : 위젯/가젯의 제목
  • title_url : 위젯/가젯과 관련된 웹페이지 주소, 제작자의 블로그나 홈페이지 링크를 하기도 함
  • description : 위젯/가젯에 대한 간단한 설명
  • author : 위젯/가젯 제작자의 이름이나 별명
  • author_email : 위젯/가젯 제작자의 e-mail 주소

• 1.2 /ModulePrefs/Require

  사용자 인터페이스 같은 위젯/가젯에서 제공하는 기능을 사용하기 위한 요소를 정의합니다.

  <ModulePrefsb title="Setprefs New" height="100"> <Require feature="setprefs" /> </ModulePrefs>

• 2. 사용자 설정

  간혹 위젯/가젯은 사용자별로 특화된 정보를 제공하기 위해 사용자 설정이 필요하기도 합니다.
  <UserPref> 영역에 사용자가 입력하여야 할 정보에 대한 데이터 타입과 데이터 이름을 정의합니다.

  • name : 데이터의 이름, 위젯/가젯 구현시 javascript에서 이 이름을 기준으로 데이터를 가져옴
  • display_name : 일반 사용자에게 보여지는 이름, 프로그램에서 사용하는 이름이 아닌 사용자에게 더욱 친숙한 이름
  • datatype : 데이터 형태로 String, book, enum, hidden, list 형태가 있고, 지정하지 않으면 string이 기본으로 된다.
  • required : 사용자가 설정해야 하는 값이 필수적이면 true로 셋팅한다.
  • defult_value : 사용자가 값을 설정하지 않았을 경우 기본적으로 셋팅되는 값

  사용자 설정값은 위젯/가젯코드에서 다음과 같이 접근할 수 있다.

  <script type="text/javascript"> var prefs = new gadgets.Prefs(); var someStringPref = prefs.getString("StringPrefName"); var someIntPref = prefs.getInt("IntPrefName"); var someBoolPref = prefs.getBool("BoolPrefName"); </script>

• 2.1 Enum 데이터형

  사용자 설정중에 데이터형의 값이 enum인 것이 있다. 이 형태는 선택형으로써 사용자가 하나 이상의 값중 선택할 수가 있다.
  enum형은 선택목록으로 표시해 줄 <EnumValue> 하위 요소가 필요한데 이 요소를 구성하는 속성은 다음과 같다.

  • value : 위젯/가젯 구현상에서 적용되는 값
  • display_value : 사용자가 값을 선택할 때 보여지는 값

  다음 예제는 위젯/가젯에 출력할 데이터 수를 출력할 때 출력할 줄수를 선택하기 위한 enum 설정의 예이다.

  <UserPref name="line" display_name="출력수" datatype="enum" default_value="4"> <EnumValue value="3" display_value="3줄"/> <EnumValue value="4" display_value="4줄"/> <EnumValue value="5" display_value="5줄"/> </UserPref>

• 3. content 영역

  content 영역은 실제로 위젯/가젯이 구현되는 영역으로 javascript나 html, style로 이루어져 있다.

Google 가젯 API