ChenYingChou / maps

Google Maps Application

文件說明連結在此

README.md 編輯說明

---

2010/04/08(1)

1. 將物件中使用到 GMaps 的縮放等級屬性由 "depth" 改為 "zoom", 以符合 GMaps API 介面參數。
2. 上述 Google Docs 中文件說明一併修訂。
3. GMaps 中有關縮放等級(zoom level)的範圍不容易找到明確的大小, 似乎是20個等級。有一說法為 1~18, 加上下極距(0,19)共20等級。但根據 GMap API v2 升級指南 中卻說:

從 GMap 升級到 GMap2 縮放等級順序 GMap2 中的縮放等級索引是從 0 開始，這是最粗略的等級，而不是最佳等級。這樣可以允許任何高解析度，而讓我們可以更輕鬆地引進高解析度的圖片。您可以使用下列公式，在舊和新的縮放等級之間進行轉換： newZoom = 17 - oldZoom

2010/04/08(2)

1. 請注意 AttrTypeMap.js 中的函式 AttrTypeMapFunc 已加上一個必要參數 elem, 是觸發者這個 DOM。在本應用系統中是指的是 Map 這個按鈕, 因此 HTML 中應寫:

    	<button onclick="AttrTypeMapFunc(this)">Map</button>
    若是以 jQuery 來觸發則寫為如下:
    	$('#mapTrigger_{$oAttribute->name}').click(function(){
    		AttrTypeMapFunc(this);
    	});
    而不再是
    	<button onclick="AttrTypeMapFunc.call(this)">Map</button>
    或
    	$('#mapTrigger_{$oAttribute->name}').click(AttrTypeMapFunc);
   

2. 舊有版本的寫法較適合使用 jQuery 寫作, 但若以 DOM onclick 的做法則似乎有點奇怪: onclick="AttrTypeMapFunc.call(this)"。這種寫法是執行 AttrTypeMapFunc 函式時, 把這個 button DOM 設為目前物件(this)。但再思考, 此時將這個 DOM 做為參數較不容易產生混淆, 畢竟 AttrTypeMapFunc 只是一個獨立函式, 要針對這個 DOM做某些動作, 並不須視為某一個物件的方法來執行。

---

2010/04/09

1. AttrTypeMapFunc() 最後一定返回 false, 因此在按鈕事件觸發執行時會阻止原本預設動作(例如送出表單)。
2. AttrTypeMap.php 產生的按鈕事件改為: onclick="return AttrTypeMapFunc(this)"

---

2010/05/08:

1. 模版源碼更新到 2010/05/01, 但應修改如下:

    --- tmpl.nje   2010-05-01 00:05:24.000000000 +0800
    +++ tmpl.js    2010-05-08 23:58:38.000000000 +0800
    @@ -39,12 +39,13 @@
    			if ( typeof tmpl === "string" ) {
    				// Use a pre-defined template, if available
    				fn = jQuery.templates[ tmpl ];
    -				if ( !fn && !htmlExpr.test( tmpl ) ) {
    -					// it is a selector
    -					node = jQuery( tmpl ).get( 0 );
    -				}
    -				else {
    -					fn = jQuery.tmpl( tmpl );
    +				if ( !fn ) {
    +					if ( htmlExpr.test( tmpl ) ) {
    +						fn = jQuery.tmpl( tmpl );
    +					} else {
    +						// it is a selector
    +						node = jQuery( tmpl ).get( 0 );
    +					}
    				}
    			} else if ( tmpl instanceof jQuery ) {
    				node = tmpl.get( 0 );
   

2. 新模版的變數替換由 <%= 物件屬性 %> 改為 ${物件屬性}, 更新 index.html 中的模版。

3. gmaps.js 中先檢查若已載入 jQuery 就不再呼叫載入 Google AJAX jQuery, 同時也不再執行 jQuery.noConflict()。