回調函數是讓外掛變得通用的關鍵。以下從最基礎的觀念談起,再套用到 jQuery 外掛的擴充上。
<script language="javascript" type="text/javascript"> function doSomething(callback) { // … // Call the callback callback('stuff', 'goes', 'here'); // 給callback賦值,callback是個函數變量 } function foo1(a, b, c) { // I'm the callback alert(a + " " + b + " " + c); } doSomething(foo1); // foo1函數將使用callback函數中的數據 stuff goes here var foo2 = function(a,b,c) { // I'm the callback alert(a + " " + b + " " + c); } doSomething(foo2); // foo2函數將使用callback函數中的數據 stuff goes here doSomething(function(a,b,c){ alert(a + " " + b + " " + c); // function函數將使用callback函數中的數據 stuff goes here }); </script>
傳入的參數必須是函式才能發揮回調作用,因此實務上通常會先做一次型別檢查,避免對方傳了字串或數字時直接丟出錯誤:
<script language="javascript" type="text/javascript"> function doSomething(callback) { // … // Call the callback if(typeof callback === 'function'){ callback('stuff', 'goes', 'here'); // 給callback賦值,callback是個函數變量 }else{ alert('jb51.net'); } } function foo1(a, b, c) { // I'm the callback alert(a + " " + b + " " + c); } doSomething(foo1); // foo1函數將使用callback函數中的數據 stuff goes here var foo2 = function(a,b,c) { // I'm the callback alert(a + " " + b + " " + c); } doSomething(foo2); // foo2函數將使用callback函數中的數據 stuff goes here doSomething(function(a,b,c){ alert(a + " " + b + " " + c); // function函數將使用callback函數中的數據 stuff goes here }); var foo3 = 'a'; doSomething(foo3); </script>
foo3 是字串,於是走到 else 分支,彈出提示視窗。
原始定義:
$.fn.citySelect=function(settings)
多收一個參數作為回調:
$.fn.citySelect=function(settings, changeHandle) // 添加回調函數changeHandle
在選項變動時把處理好的資料交回去:
//選項變動賦值事件 var selectChange = function (areaType) { if(typeof changeHandle === 'function'){ // 判斷callback是否是函數 var prov_id = prov_obj.get(0).selectedIndex; var city_id = city_obj.get(0).selectedIndex; var dist_id = dist_obj.get(0).selectedIndex; if(!settings.required){ prov_id--; city_id--; dist_id--; }; if(dist_id<0){ var data = { prov: city_json.citylist[prov_id].p, city: city_json.citylist[prov_id].c[city_id].n, dist: null }; }else{ var data = { prov: city_json.citylist[prov_id].p, city: city_json.citylist[prov_id].c[city_id].n, dist: city_json.citylist[prov_id].c[city_id].a[dist_id].s }; } changeHandle(data, areaType); // 返回兩個處理好的數據 } };
三個層級的 change 事件各自觸發,並帶上事件類型:
// 選擇省份時發生事件 prov_obj.bind("change",function(){ cityStart(); selectChange('prov'); // 返回數據 }); // 選擇市級時發生事件 city_obj.bind("change",function(){ distStart(); selectChange('city'); // 返回數據 }); // 選擇區級時發生事件 dist_obj.bind("change",function(){ selectChange('dist'); // 返回數據 });
呼叫端因此能拿到省縣市資料與觸發來源:
$("#s_city").citySelect({ prov: "江蘇省", city: "宿遷市", dist: "宿城區", nodata: "none" }, function(data, type) { selectAgent(data.city, data.dist); });
有了這份資料,就能接著去查對應的服務商清單:
function selectAgent(city,district){ $.ajax({ type:"POST", url:"{sh::U('Index/ajax',array('todo'=>'getagent'))}", data:"city="+city+"&district="+district, success:function(json){ json = JSON.parse(json); opt_str = "<option value=''>-請選擇-</option>" if(json.status == 1){ $.each(json.data,function(index,con){ opt_str += "<option value="+con.id+">"+con.name+" 電話:"+con.tel+"</option>" }) } $('#agent_id').html(opt_str); } }); }
外掛改造至此完成。這個模式的可貴之處在於:外掛本身只負責產生資料,至於資料要用來做什麼,完全交由呼叫端決定,兩邊因此得以各自獨立演進。