Hello Viewer サンプル

『開発者用ガイド』のサンプルとともにインストールされた Hello Viewer サンプルでは、Web レイアウトのさまざま箇所から Viewer API を使用する単純な例を示します。

サンプルのツール バーにはカスタムの[スクリプトを起動]コマンドが含まれています。このコマンドは mapFrame の ZoomToView() 関数を呼び出します。これはメイン フレームのコンテキストで実行されるため、この関数は次を使用して実行できます。

mapFrame.ZoomToView()

タスクペインには、ZoomToView() を呼び出すその他の 2 種類の方法を示すページがロードされます。そのうちの 1 つの方法では、カスタム ページを非表示の scriptFrame にロードします。そのページは GET パラメータを読み込んで JavaScript 関数の呼び出しに渡します。これは scriptFrame のコンテキストで実行されるため、ZoomToView() は次のものを使用して実行できます。

parent.mapFrame.ZoomToView()

もう 1 つの方法では、リンクがクリックされたときに、JavaScript onclick イベントを使用して ZoomToView() を直接呼び出します。これはtaskPaneFrame のコンテキストで実行されるため、ZoomToView() は次のものを使用して実行できます。

parent.parent.mapFrame.ZoomToView()

『開発者用ガイド』のサンプルでは、ビューアで JavaScript を使用するためのより高度な方法も使用しています。index.php ファイルには、次の 2 つの問題を解決する外部 JavaScript ファイルが含まれています。

• マップの最初のロード時に、マップの初期化が完了する前にタスク ペインが表示されます。このため、タスク ペイン内のリンクがまだ使用できないマップに依存している場合、このリンクをユーザがクリックすると問題が発生します。
• ビューアが初めてページをタスク ペインにロードする場合、ビューアは SESSION と WEBLAYOUT を GET のパラメータとして渡します。マップ名は、Web レイアウトのロードが完了するまで不明です。ユーザが[ホーム]ボタンをクリックすると、ビューアはホーム ページをタスク ペインに再ロードしますが、SESSION と MAPNAME を GET のパラメータとして代わりに渡します。状況によっては、最初のロード時にホーム ページにマップ名を渡しておくと便利な場合があります。

この問題に対処するため、Hello Viewer サンプルでは pageLoadFunctions.js をロードします。このスクリプトは、タスクペイン内のページのwindow.onload イベントに関数を割り当てます。この関数は以下の処理を実行します。

• メイン フレームの OnMapLoaded() 関数を置換する。この関数は、マップの初期化の完了後に呼び出されます。新しいバージョンでは、いくつかの初期化処理を実行してから(次を参照)、元の OnMapLoaded() を呼び出します。
• タスク ペイン ページのコンテンツを保存し、コンテンツを「Loading...」という文字に置換する。
• マップの初期化が完了した後に、新しいバージョンの OnMapLoaded() を呼び出す。この時点でマップ名は判明しており、mapFrame.GetMapName() 関数から取得できます。新しいバージョンの OnMapLoaded() は、タスク ペインのページの内容を復元してから、すべての <a> 要素を検索し、「MAPNAME=unknown」を href 属性内の正しいマップ名に置き換えます。

index.php および pageLoadFuctions.js を表示するリンクは、Hello Viewer サンプルを参照してください。