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 |
screenshot | iGoogle小工具說明頁中的劃面截圖 |
thumbnail | iGoogle小工具清單中的小圖 |
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_height | Gadget的預設高度 |
preferred_width | Gadget的預設寬度 |
沒有留言:
張貼留言