| Google デスクトップ サイドバーガジェット入門 |
|
|
目次
はじめにGoogle デスクトップ Google ガジェット API には、JavaScript や VBScript などのスクリプト言語でサイドバーの ガジェット (旧プラグイン) を作成するためのオブジェクトやメソッドが含まれています。 このガイドでは、Google デスクトップガジェット作成ツールでこの API を使用してガジェットを作成する方法を説明します。 作成ツールは統合された開発環境で、ドラッグ アンド ドロップ コンポーネントを使用してガジェットのユーザー インターフェースを設計したり、サイドバー以外の場所でガジェットをテストすることができます。 このガイドには、インデックス、クエリ、アクション、またはイベント API などの、Google デスクトップ API のガジェット以外の情報やスクリプトベース以外の情報は記載されていません 。 これらの API の詳細については、リンク先のドキュメントを参照してください。 デスクトップのスクリプトベースのガジェットは、下記のファイルおよびパッケージで構成されます。
作成ツールでは、ファイルの作成後にすべてのファイルがガジェット名.gg ファイルに圧縮されます。.gg は Google Gadget を意味しています。 作成ツールを使用しない場合は、ファイルを圧縮してからファイル名のサフィックスを .gg に変更します。 ガジェットを配布するには、http://desktop.google.co.jp/pluginsubmit?hl=ja またはその他の方法により、この .gg ファイルを送信します。 ユーザーが .gg ファイルベースのガジェットをインストールすると、Google Desktop のインストーラが gadget.gmanifest ファイルの情報を使用して、ファイルを解凍し、インストールおよび登録を行います。 デスクトップ 4.0 より前のバージョンでは .gg ファイルを処理できないため、 バージョン 4.0 より前のデスクトップを使用するユーザーは .gg 形式のガジェットは使用できません。 ただし、以前に作成したプラグインを Google デスクトップ 4.0 用のガジェットに変換することができます。変換するには、必要な .xml ファイルと .gmanifest ファイルを作成し、コードを一部修正します。 Google デスクトップガジェット作成ツールを使用して、スクリプトベースのサイドバーガジェットを開発および配信する手順は下記のとおりです。
ガジェットをテストする前などは特に、作業のたびにファイルを保存するようにしてください。ファイルを保存するには、Cntl-S を押すか、[ファイル]、[保存] の順にクリックします。 作成ツールには、ファイルをプロジェクト、フォルダ、またはサブフォルダに追加する機能はありませんのでご注意ください。 [ファイル]、[プロジェクトの新規作成] の順にクリックすると、最初にファイル ウィンドウに表示されるように、いくつかのファイルが作成されますが、作成ツールを使用してガジェットのフォルダにファイルを追加または削除することはできません。 プロジェクト フォルダからファイルを追加または削除するには、Windows Explorer などの外部のファイル ブラウザ ツールを使用する必要があります。 これは、ガジェットに関連付ける大きいアイコンを含む plugin_large.gif など、ガジェット作成ツールで作成したファイルのコンテンツを上書きする場合も同様です。 スタート ガイド
[プロジェクト設定] ダイアログと gadget.gmanifest ファイル
gadget.gmanifest ファイル必須の gadget.gmanifest ファイル (XML 形式) では、ガジェットを説明するメタデータと、ガジェットの作成前にインストールする必要があるコンポーネントを指定します。 このファイルのコンテンツの多くは、[プロジェクト設定] ダイアログで指定できますが、手動で編集することもできます。 manifest ファイルのコンテンツは <gadget> 要素で構成され、この要素のパラメータ minimumGoogleDesktopVersion では、このガジェットを実行できる最も古い Google デスクトップのバージョンを指定します。 要素には、必須の <about> 要素とオプションの <install> 要素があります。 <about> 要素には、下記のサブ要素を含めることができます。
<id>、<name>、および <description> 要素には必ず値を指定してください。 また、<version>、<author>、<authorEmail>、<authorWebsite>、<copyright>、<aboutText>、<smallIcon>、および <icon> 要素も値を指定することを強くお勧めします。 <authorEmail></authorEmail> などの要素は値を指定しないことも 可能ですが、指定することをお勧めします。
下記に、デジタル時計ガジェットの gadget.gmanifest ファイルの例を示します。 <gadget> 要素内には必須の <about> 要素のほか、オプションの <install> 要素を指定できます。この要素では、フォントなどガジェットの作成前にインストールする必要のあるパッケージ コンポーネントをリストします。 下記に例を示します。
ファイル ウィンドウには、ガジェットの配布に使用する ガジェット名.gg ファイルに圧縮するディレクトリやファイルが表示されます。 トップレベルのディレクトリ名は、[プロジェクト設定] ダイアログで指定した名前となります。 ディレクトリには最初の状態で 2 個のディレクトリと 5 個のファイルが含まれています。
ファイル ウィンドウに表示されるファイルのコンテンツを追加、削除、コピーするには、Windows Explorer などの、作成ツール以外のファイル ブラウザを使用する必要があります。 ファイル ウィンドウはガジェットのフォルダのコンテンツを操作するのではなく、表示するためのものです。 中央の表示エリアには、最初の状態で灰色の四角い画面の中に白色の四角形が表示されています。 白色のエリアはガジェットの現在の外観で、view オブジェクト全体を表しています。view オブジェクトは XML ファイルにあり、ガジェット全体の外観を表します。 ガジェットの UI 要素を定義せずに作成ツールを起動した場合、表示ウィンドウは右のスクリーンショットのように空白で表示されます。 この白色のエリアにコンテンツを追加すると、サイズなどの view オブジェクト全体のプロパティを変更できるようになります。
ウィンドウの中心にある表示ウィンドウ エリアには、最初の状態で上部と下部に 2 つずつ、合計 4 つのタブが表示されています。 ファイル ウィンドウからファイルを開き、main.js タブを上部に追加する方法については、既に説明したとおりです。 ここでは、上部にタブを追加または削除する別の方法について説明します。 作成ツールでは、UI 要素をドラッグ アンド ドロップしたり、メイン ビューまたはオプション ビューでプロパティを設定することができます。 これらの操作を行うと、該当のビューについて記述した XML ファイル (main.xml または options.xml) が自動的に更新されます。 XML 要素を追加または削除、プロパティ値を設定した場合も更新されます。 XML ファイルは手動で編集することもできます。 そのため、まず XML ファイルのフォーマットについて説明し、その後で作成ツールを使用してオブジェクトをドラッグ アンド ドロップしたり、プロパティを設定する方法を説明します。 下記の API リファレンスでは、ガジェットで定義できる要素のプロパティ、メソッド、およびイベントとそのビューを一覧で説明します。この場合のビューとはウィンドウの全体的な外観を意味しています。 XML ビュー ファイルでこれらの要素を使用して、ガジェットの UI コンポーネント、レイアウト、および動作を指定できます。 ガジェットのメイン ビューは、main.xml XML ファイルの <view> 要素で定義されています。この要素は、新しくプロジェクトを作成する際に作成ツールで自動的に定義されます。 ガジェットにオプションのビューがある場合は、別の <view> 要素を定義する options.xml ファイルも含める必要があります。 <view> 定義内は XML 要素で、ビューを構成する UI オブジェクトを定義します。 たとえば、main.xml ファイルには下記のような記述が含まれます。 <view width="200" height="200"> この記述では、ボタンを含む 200×200 ピクセルのビューを定義しています。 また、関連する button オブジェクトのプロパティを設定して、ボタンの通常の状態、マウスを置いた状態、ボタンを押した状態のそれぞれに異なる画像を指定することもできます。 button の onclick イベントを使用して、ユーザーがボタンをクリックしたときに、別の場所で定義された button_clicked() 関数を呼び出すことができます。 XML でプロパティを指定するには、要素に property="value" を追加します。 要素に event="script" を追加すると、XML でイベント スクリプトレットを指定できます。 DHTML では、name プロパティがある場合のみ、作成したスクリプトから要素を操作できます。 下記に例を示します。 <button name="sample_button" ... /> 要素に名前を付けると、スクリプトで要素にアクセスして操作したり、要素に関連付けられているメソッドを呼び出すことができます。 sample_button.property = "新しい値";
sample_button.event = "新しいスクリプト"; 専用の .jsファイル または .vbs ファイルを含む、.gg ファイル パッケージ以外の場所で定義されたスクリプト関数を使用したり (上記のボタン例で使用した button_clicked() 関数など)、<view> 定義内にスクリプト化された関数を含めることができます。 下記に例を示します。
<view width="200" height="200" onopen="view_onopen()">
<script language="jscript"><!--
function view_onopen()
{
foo( "bar()", 1000 );
}
function bar()
{
x = 2 + 2;
}
--></script>
<div background="#FFFFFF" width="200" height="200"/>
</view>
view オブジェクトには、contentArea オブジェクトを 1 つだけ定義できます。 contentArea の詳細については、API リファレンスを参照してください。 ガジェットのイベント処理ガジェットのイベント モデルは DHTML に似ています。 特に view や basicElement、およびこれらの下位のオブジェクトなど、一部のオブジェクトについては、下記の API リファレンスで関連するイベントを説明しています。 これらのオブジェクトのイベントの処理方法を指定するには、オブジェクトの XML 定義でイベントと操作時の動作を定義します。 たとえば、view オブジェクトの onmouseover イベントに対する動作を指定するには、下記のように記述します。 <view onmouseover="do_something_when_mouse_is_over;"/> ここで、do_something_when_mouse_is_over には、alert('mouse over!') などのスクリプトか、view_onmouseover() などのスクリプト ブロックで実行された関数の呼び出しが入ります。 DHTML では、イベントおよびイベントのハンドラに引数は必要ありません。 代わりに、スクリプトでは view.event オブジェクトを使用してイベントに関する情報を取得します。 イベント ファイルは一度に 1 つしか実行されないため、ビューの event オブジェクトには現在実行されているイベントの情報が含まれます。 event.returnValue プロパティを使用して戻り値を設定できます。 DHTML では、この値はイベントのデフォルトの動作を実行するかどうかを判別するブール型となります。 下記に例を示します。 event.returnValue = false; // デフォルトの動作を無効にする
特に、event.returnValue プロパティは下記のいずれかとなります。 下記に例を示します。
コントロールがこの edit オブジェクト内にある場合は、キーを押すたびに edit_onkeypress() 関数が呼び出されます。j キーを押すと、event.returnValue が false に設定されているため、イベントおよびイベントの通常の戻り値がキャンセルされ、j キーを押していないかのように処理されます。その結果、この <edit> 要素では文字 j を入力できなくなります。 現在のガジェットオブジェクト セットには、4.0 以前のバージョンのオブジェクトも含まれています。 特に googleTalk や contentItem など、上記のイベント処理モデルとは異なる処理モデルを持つものがあります。 下記の API リファレンスでは、これらのオブジェクトはイベントではなく、イベント ハンドラに関連付けられています。 4.0 以前のオブジェクトのイベントを処理するには、特定のイベントにハンドラ関数を設定する必要があります。 これらのハンドラ関数は、JavaScript または VBScript のブロック内でのみ設定できます。4.0 のオブジェクトのように XML 定義内で設定することはできません。 イベント ハンドラは書き込み専用のため、関数の割り当てのみが可能です。 特定のハンドラを設定していない場合は、関連するイベントに対してデフォルトの動作が実行されます。 API リファレンスでは、各イベント ハンドラのプロトタイプ シグネチャを記載しています。イベント ハンドラに割り当てる関数は、そのプロトタイプのシグネチャと一致している必要があります。 オプションとメニューのサンプル コードの関連部分で、イベント ハンドラの使用方法を検証します。 ここでは、plugin オブジェクトの onAddCustomMenuItems イベントに AddCustomMenuItems 関数を割り当てています。 割り当てる値は関数名のみで、完全なパラメータ シグネチャを割り当てることはできません。 このイベントは、サイドバーがガジェットのメニューを表示する前に初期化する場合に発生します。 AddCustomMenuItems のプロトタイプは AddCustomMenuItems(menu) であるため、割り当てられた関数も menu オブジェクトの関数を 1 つだけ取ります。 このセクションでは、さまざまなオブジェクトの使用方法とそれぞれの関係について説明します。 gadget は、全体的なガジェットレベルにおいて 2 つの異なる目的で使用されます。 ガジェットの各ウィンドウ全体の外観について view オブジェクトを定義する必要があります。 このオブジェクトは、それぞれ個別の .XML ファイルで定義する必要があります。 作成ツールでは、プロジェクトを作成すると view オブジェクトを設定した main.xml ファイルが自動的に作成されます。 また、options.xml ファイルを作成して、独自の view オブジェクトを設定することもできます。 view オブジェクトのプロパティとメソッドでは、ビュー ウィンドウ全体の動作を定義してアクセスします。 ウィンドウの外観を構成する UI 要素、ウィンドウのサイズ、ユーザーがサイズを変更できるかどうか、スクリプトの実行を管理するタイマー、UI 要素の追加または削除、メッセージまたは確認ボックスの表示などを定義できます。 view オブジェクトのイベントは、このビューが最初に開かれたときや、さまざまなマウス ボタン、キー、サイズ変更、プロパティ値の変更、カーソル アクションなどに基づいて実行されます。 basicElement は、特定のビューの外観を構成するさまざまな UI 要素の親オブジェクトです。 basicElement 自体はインスタンス化されず、下位の UI オブジェクトの共通プロパティやイベントのセットを提供します。 プロパティでは、要素のサイズや位置、要素の名前、鮮明度や透明度、およびその他の一般的な UI 要素のプロパティを指定します。 イベントは、通常 UI オブジェクトに関連付けられるもので、マウスのクリックやホイールのスクロールに関する動作、要素のドラッグまたはドロップ、キーボード フォーカスの移動、キーおよびカーソルの操作などがあります。 定義できる basicElement の下位の要素には下記のものがあります。 他にも elements オブジェクトがあります。これは basicElement オブジェクトとその下位オブジェクトのコンテナの働きをします。 標準のディクショナリまたはマップとして、オプションとその値を保存します。 下記のいずれかの方法で値を設定できます。
通常のディクショナリと同様に、下記の 2 つの方法によりアイテムを追加できます。 defaultValue プロパティにより、キーに関連付けられた実際の値がディクショナリにない場合、キーはデフォルトの値を返します。このため、キーに既存の値があるかどうかを確認する必要がなくなります。 次に例を示します。 ディクショナリは、"color" が要求され、"color" が存在しない 場合は、必ず "red" を返します。 たとえば、下記のような結果が返されます。 4.0 以前の開発モデルで使用した 4 つのオブジェクト googleTalk、friend、ContentItem、および menuは、4.0 開発モデルにも含まれています。 コードで googleTalk または menu イベント ハンドラを使用する場合は、4.0 以前のイベント処理モデルを使用する必要があります。 また、その他の UI 要素とは異なり、これらのオブジェクトは basicElement の下位オブジェクトではありません。 googleTalk および friend オブジェクトを使用して、他のマシンで実行されているガジェットと通信できるガジェットを作成する方法の詳細については、Google デスクトップ サイドバー通信 API ドキュメントをご覧ください。 menu オブジェクトとそのメソッドにより、ユーザーがメニュー アイテムをクリックした時にハンドラ関数を関連付けるなど、ガジェットに複数のアイテムを持つメニューを作成できます。 ContentItem オブジェクトは別のマシンで実行中のガジェット間で渡され、contentArea オブジェクトに含まれる UI 要素を構成します。 DetailsView は UI 機能で、ガジェットでサイドバー外の別のウィンドウまたはガジェットに追加情報を表示することができます。 ガジェットでは、この機能を使用して、詳細ビューから通知やイベントを受け取ることもできます。 framework ネームスペースでは、Windows Scripting Host でサポートされない API を検出できるため、ガジェットの実装に役立ちます。 特に、framework.* オブジェクトは basicElement の下位オブジェクトではないため、ガジェットの XML UI オブジェクト定義には表示されません。 framework は、基本的に .NET と同様のオブジェクトのネームスペースで、システム情報の検索に使用します。システム情報は、XML 定義の UI オブジェクトでイベントに呼び出されるスクリプトで使用します。 framework オブジェクトとそのプロパティおよびメソッドにより、下記の操作が可能になります。 最後に、下記の 2 つの既定のオブジェクトは、Framework ネームスペース内の型にのみ使用できます。 framework オブジェクトの使用例として、ノートパソコンのバッテリー残量を示す簡単なガジェットを作成してみます。 この例では、下記の 2 つの要素を持つ 200×200 ピクセルのビューを定義しました。 ガジェットが読み込まれると、view::onopen イベントが実行され、view_onopen() が呼び出されます。 この関数では間隔を指定しているため、update_battery() は 1 秒ごとに呼び出されます。 update_battery() は、framework ネームスペースの system.power.percentRemaining オブジェクトおよびプロパティを使用して、percent_used 要素の innerText を更新します。 この例では、framework. を system.power.percentRemaining の前に置く必要はありません。必要に応じて判断してください。 ここでは、作成ツールで最初にガジェットの UI を定義する方法を説明します。 下記の 8 つの UI 要素のいずれかの上でマウスをクリックし、白色の表示エリア内のガジェットでこの要素を表示する場所にドラッグします。 マウス ボタンを離すと、UI 要素はガジェットと選択した UI 要素の両方に表示されます。 選択した UI 要素のプロパティとその値は、右にあるプロパティ ウィンドウに表示されます。 表示エリアの UI オブジェクトをクリックすると、選択した状態になります。 UI オブジェクトのすべてのプロパティ、メソッドおよびイベントの説明については、API リファレンスのセクションを参照してください。 下記のオブジェクトは、すべて basicElement オブジェクトから継承されるため、各オブジェクトに指定されていないプロパティやイベントの説明については、basicElement オブジェクトのセクションを確認してください。 8 つの UI 要素は下記のとおりです。 progressbar および object の UI 要素は、作成ツールのドラッグ アンド ドロップ要素として使用することはできませんが、XML コードで定義することができます。 作成ツールでは、ガジェットの XML ファイルを直接編集することはできません。ファイルを編集するには、外部の編集プログラムを使用する必要があります。
表示ウィンドウに 1 個以上の UI 要素がある場合は、下記のいずれかの方法で要素を選択できます。
表示ウィンドウにオブジェクトを先に置いた場合は、要素ウィンドウに view 要素の子として表示され、要素の型は識別子とだけ表示されます。 このため、Button 要素を表示ウィンドウに 2 回ドラッグすると、要素ウィンドウに 2 つのアイテムが表示され、両方とも button に指定されます。 たとえば、要素にButton1 という名前を付けた場合は、要素ウィンドウに button (Button1) と表示されます。 作成ツールで view オブジェクトのプロパティおよびイベントにアクセスするには、要素ウィンドウで view エントリをクリックする方法しかないので注意してください。 プロパティ ウィンドウには、選択されている UI オブジェクトのプロパティと値が表示されます。 この画面でも、オブジェクトのプロパティ値とそのイベントに関連付ける関数を編集できます。 プロパティ値を編集するには、名前または値をクリックします。 入力できる値は、プロパティの種類によって異なります。 必要に応じて、UI オブジェクトの新しいプロパティ値が表示に反映されます。 cursor など、一部のプロパティは指定できる値のセットが定義および制限されています。 作成ツールでは、入力した値がプロパティに指定できる値のセットに含まれているかどうかは確認できません。 ただし、指定できない値を指定してビューを表示しようとすると、エラーが発生します。 また、要素ウィンドウで選択してアクセスできる全体の view オブジェクトには、独自のプロパティとイベントのセットがあります。 たとえば、ビューのサイズを変更する場合、要素ウィンドウで view をクリックし、プロパティ ウィンドウで高さや幅の値を変更します。 イベントの場合は、ガジェットに含めたスクリプト ファイルで定義した関数名を値フィールドに入力します。 たとえば、view オブジェクトの onOpen イベントでは、main.js で定義した view_onOpen() 関数を
値フィールドに入力できます。 このウィンドウには、表示されている XML ファイルのガジェットで使用するスクリプト ファイルが表示されます。 スクリプト ファイルは、ガジェットが完成したときに UI XML や画像ファイルと共に圧縮されます。 デフォルトでは、main.js ファイルのみ含まれますが、他のスクリプト ファイルを追加して、main.js ファイルを削除することもできます。 スクリプト ウィンドウにスクリプト ファイルを追加するには、左にある 3 つのアイコンのうち用紙アイコンをクリックします。 これにより、スクリプト ファイルのみ表示するよう設定されたファイル ブラウザが開き、ガジェットのフォルダが表示されます。 追加するスクリプト ファイルを選択して、[開く] をクリックします。 追加するスクリプト ファイルは、作成済みである必要があります。 File-> コマンドとは異なり、スクリプト ファイルがプロジェクト フォルダにコピーされ、作成ツールのファイル ウィンドウに表示されるようになります。 また、表示ウィンドウでアクティブになっているガジェットの XML ファイルに、<script src="filename" /> 行も追加されます。 たとえば、main.xml がアクティブになっている場合は、<script src="filename"/> 行が main.xml にのみ追加され、options.xml には追加されません。 スクリプト ウィンドウでスクリプト ファイルをクリックして選択すると、下記の操作を行うことができます。
重要な点として、スクリプト ウィンドウにはプロジェクト フォルダに保存されているスクリプト ファイルではなく、表示中のビュー定義 XML ファイルで使用されているスクリプト ファイルが表示されます。 [ファイル]、[新規作成] の順にクリックしてファイルを作成した後に main.xml を見ると、<view> 要素の中に <script src="main.js" /> 行があります。 main.js は、スクリプト ウィンドウとファイル ウィンドウの両方にリストされます。 スクリプト ウィンドウから main.js を削除すると、<script src="main.js" /> が <view> 要素から削除されます。その結果、ガジェットのビューでファイルに定義されている関数を認識できなくなります。 ファイル自体はプロジェクトのフォルダにありますが、削除する場合は外部のファイル ブラウザ プログラムを使用する必要があります。削除しない場合は、他のプロジェクト ファイルと共に .gg ファイルに圧縮されます。 デフォルトでは新しいプロジェクトを作成すると、main.xml に <script src="main.js" /> 行が自動的に作成され、main.js には main.xml で使用する view_onOpen() 関数の定義が作成されます。 代わりの関数の定義を指定したり、main.xml を書き換えることなく、スクリプト ウィンドウから main.js を削除すると、view_onOpen() を使用できなくなるため、エラーが発生します。 作成ツール ウィンドウの上部には、[ファイル]、[編集]、[表示]、[プロジェクト]、および [ヘルプ] の 5 つのプルダウン メニュー付きコマンドがあります。 ここでは、コマンド別に詳細を説明します。 [ファイル] には下記の 7 つのメニュー コマンドがあります。
また、最近使用したプロジェクトは、メニュー セクションの [終了] コマンドの上に表示されます。 最近使用したプロジェクトをクリックすると、作成ツールでこのプロジェクトが開きます。 [編集] には下記の 6 つのメニュー コマンドがあります。
[表示] には下記の 5 つのメニュー コマンドがあります。
[プロジェクト] には下記の 3 つのメニュー コマンドがあります。
[ヘルプ] には下記の 2 つのメニュー コマンドがあります。 サイドバーガジェットは、次の条件を満たしている場合、他のコンピュータで実行されているサイドバーガジェットと通信できます。 Google トークは、サイドバーガジェットの通信メディアとして機能します。 Google トークにログインすると、ガジェットで Google トークのオンラインの友だちリストを取得できるようになります。 オンラインの友だちリストが取得されると、オンラインの友だちのコンピュータ上で実行されている同じガジェットとの間でデータを送受信できます。 友だちがサイドバーをインストールしていない場合は、代わりにテキスト メッセージを送信できます。 スクリプト ベースのガジェットに通信機能を追加する場合は、グローバル変数 googleTalk を使用して、データの送信を行ったり、ガジェットがデータを受信する際にハンドラ関数が呼び出されるよう設定します。 データ送信の最初の手順では、googleTalk の friends プロパティを参照します。このプロパティにより、Google トークのオンラインの友だちから構成される friend オブジェクトの配列が取得されます。 friend オブジェクトには、5 つのプロパティがあります。 スクリプトで Google トークの友だちの配列を取得すると、次のいずれかのメソッドを使用してデータを送信します。 データを受信するには、データを処理する関数を googleTalk の onReceiveTalkData 関数ハンドラに関連付ける必要があります。 関数のシグネチャは、name(friend_object, data_string) となります。 この関数は、ガジェットがデータを受信するときに必ず呼び出されるため、別のガジェットが送信する可能性のあるすべてのメッセージを処理できるように記述する必要があります。 通信 API を使用するスクリプトガジェットでは、eval() を呼び出して、受信データを実行することがないようにする必要があります。 これは、悪意のあるユーザーがガジェットを変更し、友だちのコンピュータ上で実行されるスクリプトを送信するのを防ぐためです。 受信したスクリプトがローカル権限のもとで実行され、ローカルのファイルおよび情報にアクセスする可能性があります。 これを防ぐには、eval() 呼び出しで受信データを評価しないようにします。 ガジェット通信の例としては、SDK に含まれる Tic-Tac-Toe のサンプル コードを参照してください。 ガジェットを作成する際は、次の一般的なルールを考慮してください。
ユーザーは、異なるサイドバーガジェットでも同じように操作できることを期待しています。 次のセクションでは、すべてのサイドバーガジェットで統一する必要のある、共通の表示スタイルと動作について説明します。 ガジェットでは、代わりの動作および情報をできるだけ多く提供する必要があります。 具体的には、次のようにします。 ほとんどのガジェットはマウスで操作するため、特にマウス入力に関する UI はサイドバー全体で統一し、混乱を防ぐ必要があります。 次の主要な3 つのタイル要素の表示スタイルに従って、クリックの種類とそれに対応する動作を統一します。 ガジェットで他の言語のテキストを提供できない場合でも、テキストおよびラベルを複数の言語で表示できるようにする必要があります。 こうすることで、他のユーザーが他の言語テキストを提供できるようになります。 他の言語のユーザー用に、異なる画像、ビュー レイアウト、スクリプトを指定することもできます。 まず、言語について説明します。 複数の言語をサポートするには、ガジェットの UI に表示される各言語版の文字列を、strings.xml という名前のファイルにリストし、このファイルを各言語用の ID が付いたサブディレクトリに置く必要があります。 このファイルには、各言語の文字列の変数割り当てが含まれています。 ガジェットの定義およびコードでは、各言語版の文字列ではなく、変数を使用します。 たとえば、Hello World's English の strings.xml ファイルには次の行を含めます。 Hello World ガジェットのスクリプト コードで、ビューの caption プロパティを次のように "HelloWorld!" タイトルに設定します。 コードでは、strings.xml ファイルから取得される要素名を使用します。 XML では、要素名の先頭に & を付ける必要があります。
英語とフランス語の 2 つのバージョンでガジェットを作成する場合、ファイルは次のディレクトリ階層で配置します。 サイドバーでは、現在のシステムと同じ言語 ID のディレクトリが存在するかどうかを最初に確認します。 存在する場合は、そのディレクトリの strings.xml ファイルが読み込まれます。 同じ言語 ID のディレクトリが存在しない場合で、1033 (アメリカ英語) ディレクトリが存在する場合は、デフォルトでそのディレクトリの strings.xml ファイルが読み込まれます。 同様に、ローカライズ フォルダに画像、マークアップ、スクリプトなどを配置すると、上記のルールに従い、サイドバーによりこれらのファイルが読み込まれます。 たとえば、ガジェットで各言語に応じて異なる画像を必要とする場合は、次のように指定します。 サイドバーでは、最初に some_image.png の読み込みを試みます。システム言語がフランス語の場合は、フランス語のローカライズ ディレクトリ (1036\some_image.png) 内が検索され、次に英語のディレクトリ (1033\some_image.png) 内が検索されます。 メイン ディレクトリではなく、ローカライズ ディレクトリに置くことができるコンテンツは次のとおりです。 ほとんどの場合にデフォルトの動作をし、特定の言語では異なる動作をするガジェットを作成するには、次のようにします。 言語 ID の全リストについては、こちらをご覧ください。 このセクションでは、Google ガジェット API のさまざまなスクリプト関連オブジェクトについて、そのプロパティ、メソッド、および関連付けられたイベントとともに説明します。 多くのオブジェクトでは basicElement からプロパティ、メソッド、およびイベントが継承されます。 また、メソッドで element を返すとの記述がある場合、これはガジェットの XML 定義で定義された要素を指し、basicElement の下に位置します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![[新しいプロジェクト名] ダイアログ](images/designer/newproject.png)
![[プロジェクト設定] ダイアログ](images/designer/projectsettings.png)
![[ファイル] コマンド](images/designer/filecommands.png)
![[編集] コマンド](images/designer/editcommands.png)
![[表示] コマンド](images/designer/viewcommands.png)
![[プロジェクト] コマンド](images/designer/projectcommands.png)
![[ヘルプ] コマンド](images/designer/helpcommands.png)
