2 - ol3.16ex 155b - Custom Icon 2

「custom-icon.js（2155-ol3ex.js）」は、マップを表示するための JavaScript ファイルです。

「2155-ol3ex.js」

var logoElement = document.createElement('a');

logoElement.href = 'http://www.osgeo.org/';
/** HTMLHyperlinkElementUtils.href
 * The HTMLHyperlinkElementUtils.href property is a 
 * USVString containing the whole URL.
 * HTML HyperlinkElementUtils.hrefプロパティは、URL 全体
 * を含む USVString です。
 * （MDN[https://developer.mozilla.org/en-US/docs/Web/
 * API/HTMLHyperlinkElementUtils/href]）
 */

/** USVString
 * USVString corresponds to the set of all possible 
 * sequences of unicode scalar values. USVString maps 
 * to a String when returned in JavaScript; it's 
 * generally only used for APIs that perform text 
 * processing and need a string of unicode scalar 
 * values to operate on.
 * USVStringは、Unicode スカラー値のすべての可能なシーケン
 * スのセットに対応します。 USVString は、JavaScript で返さ
 * れた Strig グローバルオブジェクトにマッピングします。それ
 * は一般的に、テキスト処理を実行し、動作し続けるようにユニ
 * コードスカラー値の文字列を必要とする API に使われています。
 * （MDN[https://developer.mozilla.org/en-US/docs/Web/
 * API/USVString]）
 */

logoElement.target = '_blank';
/** SVGAElement.target(This is an experimental 
 * technology)
 * The SVGAElement.target read-only property of 
 * SVGAElement returns an SVGAnimatedString object 
 * that specifies the portion of a target window, 
 * frame, pane into which a document is to be opened 
 * when a link is activated.
 * This property is used when there are multiple 
 * possible targets for the ending resource, like 
 * when the parent document is a mlti-frame HTML or 
 * XHTML document.
 * SVGAElement の SVGAElement.target 読み取り専用プロパ
 * ティは、リンクがアクティブになったときに、開かれるためのド
 * キュメントにターゲットウィンドウ、フレーム、ペインを指定す
 * る SVGAnimatedString オブジェクトを返します。
 * 終了リソースのための複数の可能なターゲットが存在するとき、
 * このプロパティは使用され、親ドキュメントが mlti-frame 
 * HTML や XHTML ドキュメントであるとき、同様です。
 * （MDN[https://developer.mozilla.org/en-US/docs/Web/
 * API/SVGAElement/target]）
 */

/** SVGAElement(This is an experimental technology)
 * The SVGAElement interface provides access to the 
 * properties of <a> element, as well as methods to 
 * manipulate them.
 * SVGAElement インターフェイスは、それらを操作するメソッド
 * と同じように、<a> エレメントのプロパティへのアクセスを提
 * 供します。
 * （MDN[https://developer.mozilla.org/en-US/docs/Web/
 * API/SVGAElement]）
 */

var logoImage = document.createElement('img');

logoImage.src = 'http://www.osgeo.org/sites/all/themes/osgeo/logo.png';
/** HTMLImageElement.src
 * HTMLImageElement.src is a DOMString that reflects 
 * the src HTML attribute, containing the full URL of 
 * the image including base URI.
 * HTMLImageElement.src は、ベース URI を含む画像（image） 
 * の URL すべてを含む、src HTML 属性を反映します。
 * （訳注：編集途中のようです。）
 * （MDN[https://developer.mozilla.org/en-US/docs/Web/
 * API/HTMLImageElement]）
 */

logoElement.appendChild(logoImage);
/** Node.appendChild()
 * The Node.appendChild() method adds a node to the 
 * end of the list of children of a specified parent 
 * node. If the given child is a reference to an 
 * existing node in the document, appendChild() moves 
 * it from its current position to the new position 
 *  (there is no requirement to remove the node from 
 * its parent node before appending it to some other 
 * node).
 * Node.appendChild（）メソッドは、指定された親ノードの子リス
 * トの末尾にノードを追加します。与えられた子ノードは、ドキュ
 * メント内の既存のノードへ参照がある場合、appendChild() は、
 * 現在の位置から新しい位置に移動します。（いくつかの他のノー
 * ドに追加する前に、その親ノードからノードを削除する必要があ
 * りません）。
 * （MDN[https://developer.mozilla.org/en-US/docs/Web/
 * API/Node/appendChild]）
 */

var map = new ol.Map({
 layers: [

  new ol.layer.Tile({
  /** ol.layer.Tile 
   * For layer sources that provide pre-rendered, tiled 
   * images in grids that are organized by zoom levels 
   * for specific resolutions. 
   * プリレンダリング（事前描画）を提供するレイヤソースのため
   * の、特定の解像度でのズームレベルによって編成されているグ
   * リッドのタイルイメージ。（ol3 API）
   */

   source: new ol.source.OSM()
   /** source:
    * Source for this layer. Required.（ol3 API）
    */

   /** ol.source.OSM 
    * Layer source for the OpenStreetMap tile server.
    * OpenStreetMap タイルサーバのレイヤソース。（ol3 API）
    */

  })
 ],
 target: 'map',
 view: new ol.View({
  center: [0, 0],
  zoom: 2
 }),

 logo: logoElement
 /** logo
  * The map logo. A logo to be displayed on the map at 
  * all times. If a string is provided, it will be set 
  * as the image source of the logo. If an object is 
  * provided, the src property should be the URL for an 
  * image and the href property should be a URL for 
  * creating a link. If an element is provided, the 
  * element will be used. To disable the map logo, set 
  * the option to false. By default, the OpenLayers 3 
  * logo is shown.
  * マップロゴ。ロゴは常に地図上に表示されます。文字列が提供
  * される場合、それはロゴの画像（image）ソースとして設定され
  * ます。オブジェクトが提供されている場合、src プロパティは、
  * 画像（image）の URL である必要があり、hrefプロパティは、
  * リンクを作成するための URL である必要があります。エレメン
  * トが提供されている場合、エレメントが使用されます。マップ
  * ロゴを無効にするには、オプションを false に設定します。デ
  * フォルトでは、OpenLayers3 ロゴが表示されます。（ol3 API）
  */

});