2010年5月3日 星期一

「Google小工具」: Gadget & Mapplet (二)

(3). Gadget程式碼架構
Google小工具是由XML,HTML及Javascript組成,而XML中大部分的Tag是用來描述小工具,定義小工具之外部變數及指定所要引用的Gadget API。HTML及Javascript則必需於指定的Tag中編寫。
整個xml程式文件主要 Module 這個tag構成 ,其下又分成三部分主要的tab :ModulePrefs,UserPref 及Content
ModulePrefs:
主要用來定義小工具屬性:
屬性說明
title標題
title_url標題的連結
description文字描述說明
author作者
author_email作者email
screenshotiGoogle小工具說明頁中的劃面截圖
thumbnailiGoogle小工具清單中的小圖


ModulePrefs中另有一些子tag,其中很重要的一個是 Locale,利用此Tag可以達到多國語言版的小工具喔,要如何寫一個多國語言版的小工具呢?我將獨立一篇文章來介紹說明。

UserPref(非必要) :
此部分作用是定義一些變數,可作為個人化的參數傳遞,借以與Gadget溝通。
如下為Google Gadget Editor 的一個參數:Height。用來選擇設定我們編輯畫面的大小。




















這個Tag有很大的用,如可以用來設定Gadget的字型顏色,背景顏色….等等。
而在程式中要如何讀取此參數的內容,如下:


var prefs = new gadgets.Prefs(__MODULE_ID__); //__MODULE_ID__ 為內建特殊變數
var pName = prefs.getString("myname"); //取得myname的內容


Content:
此部分就是我們寫程式最重要的區塊了,但是也可以指定內容為別一個url連結。
屬性說明
type類別: html , url
href在類別為url時,可以指定為外部內容
view此屬性做為OpenSocial Gadget專用,即據有社群功能的Gadget
preferred_heightGadget的預設高度
preferred_widthGadget的預設寬度

沒有留言:

張貼留言