前端javascript開發(fā)手冊

1、前端JavaScript【開發(fā)參考手冊】2015年1月1. 文檔屬性文檔屬性內(nèi)容項目/任務(wù)名稱：項目/任務(wù)編號：文檔名稱：文檔編號：文檔版本號：變更序列號文檔狀態(tài)：文檔編寫完成日期作 者：2. 文檔變更歷史清單文檔版本號變更日期修改人描述3. 文檔變更說明（僅描述本版本的變更內(nèi)容）序號變更內(nèi)容簡述.5.目錄開發(fā)參考手冊第一章 腳本庫參考1.1 appkit.js功能描述 Kiosk應(yīng)用支持類。1.1.1 AppKit.link方法參數(shù)描述link(Object, boolean)Object:對象boolean: true|false(暫未使用，保留參數(shù))設(shè)置頁面鏈接。功能描述

2、用于界面跳轉(zhuǎn)。應(yīng)用案例與實例 /設(shè)置頁面鏈接AppKit.link(link:/center.c,true); /設(shè)置頁面鏈接parent.center.location.href=/ center.cAppKit.link(target:parent.center.location,link:/center.c,true);1.1.2 AppKit.postAjax方法參數(shù)描述postAjax (url, data, callback, method)連接參數(shù)，參數(shù)包括，url:設(shè)置連接URL。data: 請求參數(shù)數(shù)據(jù)，可為空()。callback: XMLHTTP請求完成后的回調(diào)事件。me

3、thod:get/post連接方式，默認(rèn)為post。默認(rèn)請求是異步請求。發(fā)送Ajax請求。功能描述 用于發(fā)送異步請求。應(yīng)用案例與實例 /建立XMLHTTP連接，設(shè)置URL為savesession.viewaction，連接方式為post，/連接參數(shù)為qstr，請求完成后回調(diào)函數(shù)為oncheckCard。AppKit.postAjax(savesession.viewaction ,qstr, oncheckCard); /定義請求完成后的回調(diào)函數(shù)。oncheckCard = function(req)logDebug.trace(readcard.jsp 執(zhí)行方法 oncheckCard);v

4、ar data=eval(req.responseText); if(data.retcode = false) onSavetrackError(); return; onForward();1.1.3 AppKit.startTimer方法參數(shù)描述startTimer (times, callback, repeat)times:時間間隔。callback:回調(diào)函數(shù)。repeat:true|false循環(huán)標(biāo)志，默認(rèn)為true。若循環(huán)標(biāo)志為false時，調(diào)用回調(diào)函數(shù)后關(guān)閉計時器。Ajax計時器。功能描述 startTimer方法在一段時間times(以秒為單位)后執(zhí)行某個函數(shù)callback

5、。應(yīng)用案例與實例 /1s后調(diào)用onForward方法。 AppKit.startTimer(1,onForward,false);1.1.4 AppKit.overtime方法參數(shù)描述overtime(timer, t)timer:計時器對象。t:計時器參數(shù)。設(shè)置計時器，超時返回設(shè)置頁面。功能描述 設(shè)置計時器，超時返回設(shè)置頁面。應(yīng)用案例與實例 /設(shè)置超時頁面鏈接timer=AppKit._na();timerlink=?command=clearpage&fwdpage=+timerlink;AppKit.overtime(Htm.Timer,timer);1.1.5 AppKit.toHtm

6、l方法參數(shù)描述toHtml (Object)Object:數(shù)據(jù)對象。將輸出數(shù)據(jù)按照Html頁面格式顯示。功能描述 將輸出數(shù)據(jù)按照Html頁面格式顯示。應(yīng)用案例與實例 / /將report標(biāo)簽數(shù)據(jù)設(shè)置為Html頁面格式，并在第一個OutputBox中顯示。Flash.UpdateOutBox(AppKit.toHtml($(report).value);1.1.6 AppKit.rtlvalidate方法參數(shù)描述rtlvalidate(pType,Fields,Args,Time,Message)pType:驗證類型。Fields:輸入數(shù)據(jù)。Args:驗證參數(shù)。Time:錯誤提示頁面超時時間。M

7、essage:錯誤提示信息。調(diào)用ValidateClass 中的方法驗證輸入數(shù)據(jù)是否正確，若不正確，則發(fā)送消息給flash 顯示錯誤提示頁面。應(yīng)用案例與實例 / /將report標(biāo)簽數(shù)據(jù)設(shè)置為Html頁面格式，并在第一個OutputBox中顯示。Flash.UpdateOutBox(AppKit.toHtml($(report).value);1.1.7 AppKit.windisabled方法參數(shù)描述windisabled(Object)Object:設(shè)置頁面高度和寬度的參數(shù)對象隱藏當(dāng)前窗口。應(yīng)用案例與實例 /顯示屏蔽層。AppKit.windisabled();1.1.7 AppKit.w

8、inenabled方法參數(shù)描述winenabled ()(none)顯示窗口。應(yīng)用案例與實例 /顯示屏蔽層。AppKit.windisabled();1.1.8 AppKit.playsound方法參數(shù)描述playsound(Object)Object:聲音文件地址。播放聲音。應(yīng)用案例與實例 / 播放聲音。AppKit.playsound(/sound/enteycard.wav);1.1.9 AppKit.countDown方法參數(shù)描述countDown(tick,timeoutCallBack,classes)tick:timeoutCallBack:classes:倒計時器。應(yīng)用案例與實

9、例 / 創(chuàng)建倒計時器，屏幕右上角倒計時顯示erval秒后執(zhí)行onTimeOut/方法。AppKit.countDown(erval, onTimeOut);1.1.10 AppKit.createCell方法參數(shù)描述createCell(rownum,colnum)rownum:表格行數(shù)。colnum:表格列數(shù)。創(chuàng)建一個表格。應(yīng)用案例與實例 / 創(chuàng)建表格。AppKit.createCell(Number(formParamrownum)+1,formParamcolnum)1.1.11 AppKit.clearCountDown方法參數(shù)描述clear

10、CountDown()(none)清除倒計時器。應(yīng)用案例與實例 /清除倒計時。AppKit.clearCountDown();1.1.12 AppKit.isEmptyVal方法參數(shù)描述isEmptyVal (var)var:變量判斷變量是否為空，若變量為空，返回true，否則返回false。應(yīng)用案例與實例 /判斷變量是否為空。if(AppKit.isEmptyVal(formParamforward) alert(foward配置為空);return;1.1.13 AppKit.obj方法參數(shù)描述obj(name)name:表示id。document.getElementById() 方法的

11、一個便利的簡寫，獲取頁面對象。1.1.14 AppKit.val方法參數(shù)描述val (name,value)name:表示id。value:默認(rèn)值。獲取頁面對象的值。1.1.15 AppKit.focus方法參數(shù)描述focus(name)name:表示頁面對象id。對頁面對象設(shè)置焦點。1.1.16 AppKit.show方法參數(shù)描述show (name)name:表示頁面對象id。顯示頁面對象。1.1.17 AppKit.hide方法參數(shù)描述hide (name)name:表示頁面對象id。隱藏頁面對象。1.1.18 AppKit.isvalue方法參數(shù)描述isvalue (var)var:變

12、量。判斷變量是否是一個值，是則返回true。1.1.19 AppKit.isarray方法參數(shù)描述isarray (var)var:變量。判斷變量是否為一個數(shù)組，是則返回true。1.1.20 AppKit.getarraysize方法參數(shù)描述getarraysize(var)var:數(shù)組。返回數(shù)組的長度，如果var不是數(shù)組，則返回-1。1.1.21 AppKit.getarray方法參數(shù)描述getarray (object)object:對象。將object對象轉(zhuǎn)化為數(shù)組。1.1.22 AppKit.tostring方法參數(shù)描述tostring(object)object:對象。獲取字符串，

13、可傳入json，array等。應(yīng)用案例與實例 /彈出字符串“interval:30,link:/center.c”。var timeout = AppKit.tojson(formParamtimeout);alert(AppKit.tostring(timeout);1.1.23 AppKit.tojson方法參數(shù)描述tojson (str)str:Json格式的字符串。將json字符串轉(zhuǎn)化成json對象。應(yīng)用案例與實例 /將json字符串 “interval:30,link:/center.c” 轉(zhuǎn)化成json對象timeout。var timeout = AppKit.tojson(fo

14、rmParamtimeout);1.1.24 AppKit.isnull方法參數(shù)描述isnull (str)str:字符串。判斷字符串str是否為空，為空返回true。1.1.25 AppKit.isnum方法參數(shù)描述isnum (str)str:字符串。判斷字符串str是否為數(shù)字，為數(shù)字返回true。應(yīng)用案例與實例 /判斷是否為數(shù)字。var str = 12356a;AppKit.isnum(str);/false1.1.26 AppKit.isint方法參數(shù)描述isint (str)str:字符串。判斷是否為整型，是則返回true。1.1.27 AppKit.isdec方法參數(shù)描述isde

15、c (str)str:字符串。判斷是否為浮點型，是則返回true。應(yīng)用案例與實例 /判斷是否為數(shù)字。var str = 12356a;AppKit.isnum(str);/false1.1.28 AppKit.lpad方法參數(shù)描述lpad(str,len,pad)str:待填充字符串。len:填充長度。pad:填充字符。左填充，返回填充后的字符串。應(yīng)用案例與實例 /左填充。var str = 12356a;var str1 = AppKit.lpad(str,10,0);alert(str1);/“000012356a”1.1.29 AppKit.rpad方法參數(shù)描述rpad(str,len,

16、pad)str:待填充字符串。len:填充長度。pad:填充字符。右填充，返回填充后的字符串。應(yīng)用案例與實例 /右填充。var str = 12356a;var str1 = AppKit.rpad(str,10,0);alert(str1);/“12356a0000”1.1.30 AppKit.trim方法參數(shù)描述trim(text)text:字符串。消除字符串首部和尾部的空格，返回處理后的字符串。應(yīng)用案例與實例 /消除空格。var str = 1235 6a ;var str1 = AppKit. trim (str);alert(str1);/“1235 6a”1.1.31 AppKit

17、.tobeanstring方法參數(shù)描述tobeanstring(bean,json)bean:對象。json:json對象。將json對象轉(zhuǎn)換成帶bean名稱的字符串，在savesession時，經(jīng)常要使用直接保存到對應(yīng)bean屬性應(yīng)用案例與實例 /將cardinfo轉(zhuǎn)換成CardInfoBean對象的字符串。var cardinfo = ; /存儲處理后的磁條卡信息cardinfo.track1 = 1234;cardinfo.track2 = 6789var qstr = AppKit.tobeanstring(CardInfoBean,cardinfo);alert(qstr);/“Ca

18、rdInfoBean.track1=1234& CardInfoBean.track2=6789”1.2 ajax.js 通過參考Prototype框架重寫的輕量級Ajax框架，包括建立ajax異步連接的Ajax.Request類、Dom文檔操作的Ajax.Dom類以及節(jié)點對象事件管理類等等。1.2.1 常用函數(shù) $()函數(shù)功能描述 $() 方法是在DOM中使用過于頻繁的 document.getElementById() 方法的一個便利的簡寫，就像這個DOM方法一樣，這個方法返回參數(shù)傳入的id的那個元素。比起DOM中的方法，這個更勝一籌。你可以傳入多個id作為參數(shù)然后 $()

19、返回一個帶有所有要求的元素的一個 Array 對象。另外一個好處是，這個函數(shù)能傳入用string表示的對象ID，也可以傳入對象本身，這樣，在建立其它能傳兩種類型的參數(shù)的函數(shù)時非常有用。應(yīng)用案例與實例 Test Page function test1()var d = $(myDiv);alert(d.innerHTML);function test2()var divs = $(myDiv,myOtherDiv);for(i=0; idivs.length; i+)alert(divsi.innerHTML);This is a paragraphThis is another paragra

20、ph $A()函數(shù)功能描述 $A()函數(shù)能把它接收到的單個的參數(shù)轉(zhuǎn)換成一個Array對象。這個方法，結(jié)合被本類庫擴展了的Array類，能方便的把任何的可枚舉列表轉(zhuǎn)換成或拷貝到一個Array對象。一個推薦的用法就是把DOM Node Lists轉(zhuǎn)換成一個普通的Array對象，從而更有效率的進(jìn)行遍歷，請看下面的例子。應(yīng)用案例與實例 function showOptions() var someNodeList = $(lstEmployees).getElementsByTagName(option); var nodes = $A(someNodeList); nodes.each

21、(function(node) alert(node.nodeName + : + node.innerHTML); ); Buchanan, Steven Callahan, Laura Davolio, Nancy Try.these()函數(shù)功能描述 Try.these() 方法使得實現(xiàn)當(dāng)你想調(diào)用不同的方法直到其中的一個成功正常的這種需求變得非常容易， 他把一系列的方法作為參數(shù)并且按順序的一個一個的執(zhí)行這些方法直到其中的一個成功執(zhí)行，返回成功執(zhí)行的那個方法的返回值。在下面的例子中， xmlNode.text在一些瀏覽器中好用，但是xmlNode.text Content在另

22、一些瀏覽器中正常工作。使用Try.these()方法我們可以得到正常工作的那個方法的返回值。應(yīng)用案例與實例 function getXmlNodeValue(xmlNode)return Try.these(function() return xmlNode.text;, function() return xmlNode.textContent;); 1.2.2 對Object的擴展方法參數(shù)描述extend(destination,source)destination:任何對象source:任何對象提供一種通過拷貝所有源對象屬性和函數(shù)到目標(biāo)函數(shù)實現(xiàn)繼承的方法。toJSON()(none)將對

23、象轉(zhuǎn)換為JSON對象。toQueryString()(none)將對象轉(zhuǎn)換為URL的查詢字符串(query string)返回。1.2.3 對Function擴展方法參數(shù)描述bind(object)object:擁有方法的對象返回function的實例，這個實例和源function的結(jié)構(gòu)一樣，但是它已被綁定給了參數(shù)中提供的object，就是說，function中的this指針指向參數(shù)object。1.2.4 對 Array的擴展方法參數(shù)描述each(func,object)func:函數(shù)object: 調(diào)用函數(shù)的對象each是一個集合迭代函數(shù)，依次將數(shù)組中的數(shù)據(jù)傳遞給函數(shù)并執(zhí)行。1.2.5 對

24、String的擴展方法參數(shù)描述stripTags()(none)返回一個把所有的HTML或XML標(biāo)記都移除的字符串。escapeHTML()(none)返回一個把所有的HTML標(biāo)記合適的轉(zhuǎn)義掉的字符串。unescapeHTML()(none)escapeHTML()的反轉(zhuǎn)。1.2.6 DOM擴展方法參數(shù)描述getElementsByClassName(className)className:元素的類名返回文檔的元素中所有Class屬性為指定值的Element數(shù)組。1.2.7 Event擴展方法參數(shù)描述element(event)event:一個事件對象返回事件源對象。observe(eleme

25、nt,name,observer,useCapture)evement:對象or :事件類型(像click，load，等等)observer:事件處理函數(shù)。useCapture:是否在獲取到事件處理。ture - 在事件獲取時處理false - 在排序事件后處理為對象的某一個事件增加一個處理函數(shù)。stopObserving(element,name,observer,useCapture)element:對象or idname:事件名稱(象click，load，等等)observer:事件處理函數(shù)。useCapture:是否在獲取到事件處理。ture - 在事件獲取時處理fals

26、e - 在排序事件后處理和上面的函數(shù)相反。1.2.8 在Ajax.js中定義的對象和類 Class類功能描述 在這個程序包中Class 對象在聲明其他的類時候被用到。用這個對象聲明類使得新類支持initialize() 方法，他起構(gòu)造方法的作用。方法列表方法參數(shù)描述create(*)(任何對象)定義新類的構(gòu)造方法。應(yīng)用案例與實例 /declaring the class var MySampleClass = Class.create(); /defining the rest of the class implmentation MySampleCtotype

27、= initialize: function(message) this.message = message; ,showMessage: function(ajaxResponse) alert(this.message); ;/now, lets instantiate and use one object var myTalker = new MySampleClass(hi there.); myTalker.showMessage(); /displays alert Ajax.Request類功能描述 建立Ajax連接。屬性列表屬性類型默認(rèn)值描述_argsObject

28、undefined保存連接參數(shù)，參數(shù)包括：method - get/post連接方式parameters - 請求參數(shù)數(shù)據(jù)postBody - post請求的數(shù)據(jù)文本asynchronous - 指定此請求是否為異步方式requestHeaders - http請求頭參數(shù)onSuccess - 設(shè)置XMLHTTP請求成功后的回調(diào)事件。onFailure -設(shè)置XMLHTTP請求失敗后的回調(diào)事件。oncomplate -設(shè)置XMLHTTP請求完成后的回調(diào)事件。_reqObjectundefinedXMLHTTP請求對象。方法列表方法參數(shù)描述initialize(arg,url)arg:連接參數(shù)u

29、rl:URL地址保存連接參數(shù)到_args屬性中，調(diào)用內(nèi)部方法create創(chuàng)建XMLHTTP對象，再調(diào)用connect方法進(jìn)行連接。respondprocess()(none)數(shù)據(jù)接收完畢后的處理函數(shù)，調(diào)用回調(diào)函數(shù)。應(yīng)用案例與實例 /建立XMLHTTP連接，設(shè)置連接URL為/asynlogin.action，連接方式為get，/連接參數(shù)為空，請求完成后回調(diào)函數(shù)為onLogin，指定此請求是異步方式。request=new Ajax.Request(/asynlogin.action,method:get,parameters:,onComplete:onLogin,asynchronous:tr

30、ue); /定義請求完成后的回調(diào)函數(shù)。function onLogin(req)var ret=eval(req.responseText); if(!ret.retcode) window.disableoverfwd=target:parent.location,link:/loginerror.o; device.execute(Card,disable); Ajax.Timer類功能描述 Ajax計時器類，用于在一段時間后執(zhí)行某函數(shù)。方法列表方法參數(shù)描述initialize(callback,time,loop)callback:回調(diào)函數(shù) time:時間間隔 loop:循

31、環(huán)標(biāo)志對象創(chuàng)建時調(diào)用，用于設(shè)置計時器參數(shù)，包括時間間隔，循環(huán)標(biāo)志和回調(diào)函數(shù)，默認(rèn)循環(huán)標(biāo)志為ture。start()(none)啟動計時器，計時結(jié)束后調(diào)用內(nèi)部方法onTimer，并重新計時。onTimer()(none)調(diào)用回調(diào)函數(shù)，若循環(huán)標(biāo)志為false，則關(guān)閉計時器。應(yīng)用案例與實例 /3s后執(zhí)行function()函數(shù)。(new Ajax.Timer(function() device.execute(Card,enable);,3,false).start(); Ajax.Dom類功能描述 DOM文檔操作類。方法列表方法參數(shù)描述toggle()(none)元素顯示開關(guān)。hid

32、e()(none)隱藏元素。show()(none)顯示元素。append(parentElement,name,text,properties)parentElement:元素標(biāo)簽的父節(jié)點name:元素類型名稱text:標(biāo)簽文本properties:標(biāo)簽參數(shù)對象往指定節(jié)點中添加一個子節(jié)點。remove(name)name:元素名移除指定元素。getHeight(name)name:元素名獲取元素高度，以像素為單位。hasClassName(name,class)name:元素名class:類名判斷元素的class屬性是否為指定名稱。addClassName(name,class)name:元

33、素名class:類名往元素中添加class屬性，屬性值為傳入的類名。removeClassName(name,class)name:元素名class:類名移除元素的class屬性值。getElementsByClassName(class)class:類名返回文檔的Elements中所有Class屬性為指定值的Element數(shù)組。setStyle (element,style,property)element:元素名style:樣式屬性property:屬性值設(shè)置元素樣式。getStyle (name,style)name：元素名style：樣式屬性獲取元素屬性。 Ajax.En

34、v類功能描述 查看瀏覽器類型。方法列表方法參數(shù)描述Env(type)type：瀏覽器類型，取值ie/ns判斷瀏覽器是否是IE瀏覽器或者Netscape瀏覽器。 Ajax.Event類功能描述 Ajax元素事件處理類，繼承Events中的所有方法。 Ajax.ElementEventManager類功能描述 元素對象事件管理類。方法列表方法參數(shù)描述createElementEvent(id, parentElement,name)id:標(biāo)簽id屬性值。parentElement:元素標(biāo)簽的父節(jié)點。name:元素類型名稱在指定元素節(jié)點下創(chuàng)建一個元素。如果沒有給出pare

35、ntElemet那么將默認(rèn)為document.body，沒有給出name則默認(rèn)為div。bindEventListener(id,property)id:事件所有者。property:產(chǎn)生事件的屬性。為對象的指定屬性的property change事件添加一個事件處理函數(shù)。notifyListeners(property)property:產(chǎn)生事件的屬性值檢測到事件，執(zhí)行事件處理函數(shù)中的事件處理函數(shù)。addListener(id,listener)id:事件所有者。listener:事件處理函數(shù)。添加一個事件處理函數(shù)到事件列表中。removeListener(id)id:事件所有者。刪除事件列

36、表中的指定事件所有者的事件處理函數(shù)。1.3 base64.js功能描述 BASE64編碼和解碼。1.3.1 方法列表方法參數(shù)描述Base64.encode(input)input:待轉(zhuǎn)換成BASE64編碼的字符串。將數(shù)據(jù)input編碼成BASE64編碼，并返回編碼后的結(jié)果。Base64.decode(input)input:待解碼的字符串。和上面的函數(shù)相反。應(yīng)用案例與實例 /BASE64編碼和解碼var endata = Base64.encode(Test);alert(endata);/ VGVzdA=var dedata = Base64.decode(VGVzdA=);alert(de

37、data);/ Test1.4 common.js功能描述 獲取國際化資源和設(shè)備錯誤處理方法。1.4.1 獲取國際化資源方法參數(shù)描述Locale.getButton (btnName)Locale.getLabel (labelName)Locale.getMessage(messageName)btnName、labelName、messageName:對應(yīng)perties中name值。從perties中的國際化資源中獲取對應(yīng)的value。Locale.getDevName(devName)devName:perties中對應(yīng)的

38、設(shè)備名。從perties中的國際化資源中獲取sys.dev. devName對應(yīng)的value。應(yīng)用案例與實例 /設(shè)置當(dāng)前的語言為chinesealert(message:+Locale.getMessage(mon.confirm);/“確定”alert(labal:+Locale.getLabel(mon.confirm);/“確定”alert(button:+Locale.getButton(mon.confirm);/“確定”alert(devname:+Locale.getDevName(magcard);/“讀卡器”1.4.2 獲取系統(tǒng)參數(shù)方法參數(shù)描述Sys.E

39、rrorHandlerPage常量，頁面出錯js錯誤異常的統(tǒng)一處理界面配置（error.jsp）。Sys.getSysParam (paraName)paraName:系統(tǒng)參數(shù)名。獲取系統(tǒng)參數(shù)。Sys.getAppHeight()獲取Tpl.AppHeight配置值。Sys.getAppWidth()獲取Tpl.AppWidth配置值。Sys.getTplViewBase()獲取Tpl.View.Base配置值。Sys.getSoundPath()返回當(dāng)前應(yīng)用路徑+在perties中獲取到的Tpl.SoundPath配置值。Sys.getAppBgColor()獲取Tpl

40、.AppBgColor配置值。Sys.getAppTimeOut()獲取Tpl.AppTimeOut配置值。Sys.getServiceInfo()返回系統(tǒng)對象信息。Sys.getDevInfo()獲取在devconfig.xml中配置的設(shè)備對象信息。Sys.getDevStatInfo()獲取設(shè)備狀態(tài)信息。Sys.getReceiptStatus()獲取憑條打印機狀態(tài)。功能描述 獲取系統(tǒng)參數(shù)。應(yīng)用案例與實例 alert(Sys.getAppHeight=+Sys.getAppHeight();/Sys.getAppHeight=1024alert(Sys.getAppWidth=+Sys.g

41、etAppWidth();/Sys.getAppWidth=1280alert(Sys.getTplViewBase=+Sys.getTplViewBase();/Sys.getTplViewBase=/rtl/ Sys.getSoundPath=http:/localhost:8080/app/local/chinese/sound/alert(Sys.getSoundPath=+Sys.getSoundPath();/ Sys.getAppBgColor=#0446a7alert(Sys.getAppBgColor=+Sys.getAppBgColor();alert(Sys.getAppTimeOut=+Sys.getAppTimeOut();/Sys.getAppTimeOut=150/ Sys.getServiceInfo=defaultLanguage:chinese,curLanguage:chinesealert(Sys.getServi