Google Gadget API part7

技術的なこと

User Preference Substitution Variables:



続いて，変換される変数(モロ直訳)です．<ModulePrefs> タグや<UserPref>タグの中で，__UP_userpref__ ってな具合に利用されます．んで，userprefっていう部分が，ユーザプリファレンスの中で出てくる名前と一致するんですね．んで，プリファレンスのなかで設定された値が，gadgetの読み込まれるときに変換されるわけです．





<Module>
<ModulePrefs title="Build Monitor"
             title_url="http://www.example.com/build/status.php?__UP_projects__"/>
<UserPref name="projects" display_name="project(s)"/>
<Content ... />
</Module>



上の例だと，title_url の中にある，__UP_projects__ は，UserPrefのprojectsで設定された値に変換されるわけですね．次に，この変数を利用するときのガイドラインです．




  • <ModulePrefs>のtitle属性では，__UP_name__はHTML用のエスケープ処理が必要．

  • <ModulePrefs>のtitle_url属性では，URL用のエスケープ処理が必要．

  • <Conten>タグに含まれるHTMLでは，__UP_name__ はHTML用のエスケープ処理が必要．

  • <Conten>タグに含まれるJavascritpでは，_IG_Prefs() functionを利用して値をゲット．


ってな感じです．