前端javascript开发手册

前端JavaScript

【开发参考手册】

2015年1月

1. 文档属性 文档属性 项目/任务名称： 项目/任务编号： 文档名称： 文档编号： 文档版本号： 变更序列号 文档状态： 文档编写完成日期 作 者： 2. 文档变更历史清单 内容 文档版本号 变更日期 修改人 描述 3. 文档变更说明（仅描述本版本的变更内容） 序号 1. 2. 3. 4. 5. 变更内容简述 目录

开发参考手册

第一章 脚本库参考

1.1 appkit.js

功能描述

Kiosk应用支持类。 1.1.1 AppKit.link 方法 link(Object, boolean) 参数 Object:对象 boolean: true|false(暂未使用，保留参数) 描述 设置页面链接。 功能描述

用于界面跳转。

应用案例与实例 //设置页面链接

AppKit.link({link:'/center.c'},true);

//设置页面链接parent.center.location.href=/ center.c

AppKit.link({target:parent.center.location,link:'/center.c'},true); 1.1.2 AppKit.postAjax 方法 参数 描述 连接参数，参数包括， url:设置连接URL。 data: 请求参数数据，可postAjax (url, 为空(‘’)。 data, callback, callback: XMLHTTP请method) 求完成后的回调事件。 method:get/post连接方式，默认为post。 默认请求是异步请求。

发送Ajax请求。 1

开发参考手册

功能描述

用于发送异步请求。

应用案例与实例 //建立XMLHTTP连接，设置URL为savesession.viewaction，连接方式为post， //连接参数为qstr，请求完成后回调函数为oncheckCard。 AppKit.postAjax(\"savesession.viewaction\" ,qstr, oncheckCard); //定义请求完成后的回调函数。 oncheckCard = function(req){

logDebug.trace(\"readcard.jsp 执行方法 oncheckCard\"); var data=eval(req.responseText); if(data.retcode == \"false\") { onSavetrackError(); return; }

onForward(); }

1.1.3 AppKit.startTimer 方法 参数 描述 times:时间间隔。 callback:回调函数。 startTimer repeat:true|false循环标(times, callback, 志，默认为true。若循环repeat) 标志为false时，调用回调函数后关闭计时器。 Ajax计时器。 功能描述

startTimer方法在一段时间times(以秒为单位)后执行某个函数callback。

应用案例与实例 //1s后调用onForward方法。

AppKit.startTimer(1,onForward,false);

1.1.4 AppKit.overtime 方法 overtime(timer, t) 参数 timer:计时器对象。 t:计时器参数。 描述 设置计时器，超时返回设置页面。 功能描述

2

开发参考手册

设置计时器，超时返回设置页面。

应用案例与实例 //设置超时页面链接

timer=AppKit._na(); timer['link']=' ?command=clearpage&fwdpage='+timer['link']; AppKit.overtime(Htm.Timer,timer);

1.1.5 AppKit.toHtml 方法 toHtml (Object) 参数 Object:数据对象。 描述 将输出数据按照Html页面格式显示。 功能描述 将输出数据按照Html页面格式显示。

应用案例与实例 // //将report标签数据设置为Html页面格式，并在第一个OutputBox中显示。 Flash.UpdateOutBox(AppKit.toHtml($('report').value));

1.1.6 AppKit.rtlvalidate 方法 参数 描述 pType:验证类型。 Fields:输入数据。 Args:验证参数。 rtlvalidate(pType,Fields, Time:错误提示页面超Args,Time,Message) 时 时间。 Message:错误提示信息。 调用ValidateClass 中的方法验证 输入数据是否正确，若不正确，则 发送消息给flash 显示错误提示页 面。 应用案例与实例 // //将report标签数据设置为Html页面格式，并在第一个OutputBox中显示。 Flash.UpdateOutBox(AppKit.toHtml($('report').value));

1.1.7 AppKit.windisabled 方法 windisabled(Object) 参数 Object:设置页面高度和宽度的参数对象 描述 隐藏当前窗口。 3

开发参考手册

应用案例与实例 //显示屏蔽层。

AppKit.windisabled();

1.1.7 AppKit.winenabled 方法 winenabled () 参数 (none) 描述 显示窗口。 应用案例与实例 //显示屏蔽层。

AppKit.windisabled();

1.1.8 AppKit.playsound 方法 参数 描述 播放声音。 playsound(Object) Object:声音文件地址。 应用案例与实例 // 播放声音。

AppKit.playsound('/sound/enteycard.wav');

1.1.9 AppKit.countDown 方法 参数 描述 倒计时器。 tick: countDown(tick,timeoutCallBack,classes) timeoutCallBack: classes: 应用案例与实例 // 创建倒计时器，屏幕右上角倒计时显示timeout.interval秒后执行onTimeOut //方法。

AppKit.countDown(timeout.interval, onTimeOut);

1.1.10 AppKit.createCell 方法

参数 描述 4

开发参考手册

createCell(rownum, rownum:表格行数。 colnum) colnum:表格列数。 创建一个表格。 应用案例与实例 // 创建表格。

AppKit.createCell(Number(formParam[\"rownum\"])+1,formParam[\"colnum\"])

1.1.11 AppKit.clearCountDown 方法 参数 描述 清除倒计时器。 clearCountDown() (none) 应用案例与实例 //清除倒计时。

AppKit.clearCountDown();

1.1.12 AppKit.isEmptyVal 方法 参数 描述 判断变量是否为空，若变量为空，返回true，否则返回false。 isEmptyVal (var) var:变量 应用案例与实例 /判断变量是否为空。

if(AppKit.isEmptyVal(formParam[\"forward\"])){ alert(\"foward配置为空\"); return; }

1.1.13 AppKit.obj 方法 obj(name) 参数 name:表示id。 描述 document.getElementById() 方法的一个便利的简写，获取页面对象。 1.1.14 AppKit.val 方法

参数 描述 5

开发参考手册

val (name,value) name:表示id。 value:默认值。 获取页面对象的值。 1.1.15 AppKit.focus 方法 focus(name) 参数 描述 name:表示页面对象id。 对页面对象设置焦点。 1.1.16 AppKit.show 方法 show (name) 参数 描述 name:表示页面对象id。 显示页面对象。 1.1.17 AppKit.hide 方法 hide (name) 参数 描述 name:表示页面对象id。 隐藏页面对象。 1.1.18 AppKit.isvalue 方法 isvalue (var) 参数 var:变量。 描述 判断变量是否是一个值，是则返回true。 1.1.19 AppKit.isarray 方法 isarray (var) 1.1.20 AppKit.getarraysize 方法 参数 描述 返回数组的长度，如果var不是数组，则返回-1。 参数 var:变量。 描述 判断变量是否为一个数组，是则返回true。 getarraysize(var) var:数组。

6

开发参考手册

1.1.21 AppKit.getarray 方法 getarray (object) 参数 object:对象。 描述 将object对象转化为数组。 1.1.22 AppKit.tostring

方法 参数 描述 tostring(object) object:对象。 获取字符串，可传入json，array等。 应用案例与实例 //弹出字符串“{\"interval\":\"30\”。 var timeout = AppKit.tojson(formParam[\"timeout\"]); alert(AppKit.tostring(timeout));

1.1.23 AppKit.tojson

方法 参数 描述 str:Json格式的字符串。 将json字符串转化成json对象。 tojson (str) 应用案例与实例 //将json字符串 “{\"interval\":\"30\” 转化成json对象timeout。 var timeout = AppKit.tojson(formParam[\"timeout\"]);

1.1.24 AppKit.isnull 方法 isnull (str) 参数 str:字符串。 描述 判断字符串str是否为空，为空返回true。 1.1.25 AppKit.isnum 方法 isnum (str) 参数 str:字符串。 描述 判断字符串str是否为数字，为数字返回true。 应用案例与实例 //判断是否为数字。

7

开发参考手册

var str = \"12356a\";

AppKit.isnum(str);//false

1.1.26 AppKit.isint 方法 isint (str) 参数 str:字符串。 描述 判断是否为整型，是则返回true。 1.1.27 AppKit.isdec

方法 参数 描述 str:字符串。 isdec (str) 判断是否为浮点型，是则返回true。 应用案例与实例 //判断是否为数字。 var str = \"12356a\";

AppKit.isnum(str);//false

1.1.28 AppKit.lpad

参数 描述 str:待填充字符串。 lpad(str,len,pad) len:填充长度。 左填充，返回填充后的字符串。 pad:填充字符。 应用案例与实例 //左填充。

var str = \"12356a\";

var str1 = AppKit.lpad(str,10,0); alert(str1);//“000012356a”

1.1.29 AppKit.rpad

参数 str:待填充字符串。 rpad(str,len,pad) len:填充长度。 pad:填充字符。

方法 方法 描述 右填充，返回填充后的字符串。 8

开发参考手册

应用案例与实例 //右填充。

var str = \"12356a\";

var str1 = AppKit.rpad(str,10,0); alert(str1);//“12356a0000”

1.1.30 AppKit.trim 方法 trim(text) 参数 text:字符串。 描述 消除字符串首部和尾部的空格，返回处理后的字符串。 应用案例与实例 //消除空格。

var str = \" 1235 6a \"; var str1 = AppKit. trim (str); alert(str1);//“1235 6a”

1.1.31 AppKit.tobeanstring 方法 tobeanstring(bean,json) 参数 bean:对象。 json:json对象。 描述 将json对象转换成带bean名称的字符串，在savesession时，经常要使用直接保存到对应bean属性 应用案例与实例 //将cardinfo转换成CardInfoBean对象的字符串。。 var cardinfo = {}; //存储处理后的磁条卡信息 cardinfo.track1 = \"1234\"; cardinfo.track2 = \"67\"

var qstr = AppKit.tobeanstring(\"CardInfoBean\

alert(qstr);//“CardInfoBean.track1=1234& CardInfoBean.track2=67”

1.2 ajax.js

通过参考Prototype框架重写的轻量级Ajax框架，包括建立ajax异步连接的

Ajax.Request类、Dom文档操作的Ajax.Dom类以及节点对象事件管理类等等。

9

开发参考手册

1.2.1 常用函数 1.2.1.1 $()函数

功能描述

$() 方法是在DOM中使用过于频繁的 document.getElementById() 方法的一个便利的简写，就像这个DOM方法一样，这个方法返回参数传入的id的那个元素。

比起DOM中的方法，这个更胜一筹。你可以传入多个id作为参数然后 $() 返回一个带有所有要求的元素的一个 Array 对象。

另外一个好处是，这个函数能传入用string表示的对象ID，也可以传入对象本身，这样，在建立其它能传两种类型的参数的函数时非常有用。

应用案例与实例

10

开发参考手册

1.2.1.2 $A()函数

功能描述

$A()函数能把它接收到的单个的参数转换成一个Array对象。

这个方法，结合被本类库扩展了的Array类，能方便的把任何的可枚举列表转换成或拷贝到一个Array对象。一个推荐的用法就是把DOM Node Lists转换成一个普通的Array对象，从而更有效率的进行遍历，请看下面的例子。

应用案例与实例

Buchanan, Steven Callahan, Laura Davolio, Nancy

1.2.1.3 Try.these()函数

功能描述

Try.these() 方法使得实现当你想调用不同的方法直到其中的一个成功正常的这种需求变得非常容易， 他把一系列的方法作为参数并且按顺序的一个一个的执行这些方法直到其中的一个成功执行，返回成功执行的那个方法的返回值。

在下面的例子中， xmlNode.text在一些浏览器中好用，但是xmlNode.text Content在另一些浏览器中正常工作。使用Try.these()方法我们可以得到正常工作的那个方法的返回值。

应用案例与实例

11

开发参考手册

1.2.2 对Object的扩展 方法 extend(destination, source) toJSON() toQueryString() 参数 destination:任何对象 source:任何对象 (none) (none) 描述 提供一种通过拷贝所有源对象属性和函数到目标函数实现继承的方法。 将对象转换为JSON对象。 将对象转换为URL的查询字符串(query string)返回。 1.2.3 对Function扩展 方法 bind(object) 参数 object:拥有方法的对象 描述 返回function的实例，这个实例和源function的结构一样，但是它已被绑定给了参数中提供的object，就是说，function中的this指针指向参数object。 1.2.4 对 Array的扩展 方法 each(func, object) 参数 func:函数 object: 调用函数的对象 描述 each是一个集合迭代函数，依次将数组中的数据传递给函数并执行。 1.2.5 对String的扩展 方法 stripTags() escapeHTML() unescapeHTML() 参数 (none) (none) (none) 描述 返回一个把所有的HTML或XML标记都移除的字符串。 返回一个把所有的HTML标记合适的转义掉的字符串。 escapeHTML()的反转。 1.2.6 DOM扩展 方法 getElementsByClassName(className) 参数 className: 元素的类名 描述 返回文档的元素中所有Class属性为指定值的Element数组。

12

开发参考手册

1.2.7 Event扩展 方法 element(event) 参数 event:一个事件对象 描述 返回事件源对象。 observe(element,name, observer,useCapture) evement:对象or id。 name:事件类型(像‘click’，‘load’，等等) observer:事件处理函数。 为对象的某一个事件useCapture:是否在获取到事件处增加一个处理函数。 理。 ture - 在事件获取时处理 false - 在排序事件后处理 element:对象or id name:事件名称(象‘click’，‘load’，等等) observer:事件处理函数。 和上面的函数相反。 useCapture:是否在获取到事件处理。 ture - 在事件获取时处理 false - 在排序事件后处理 stopObserving(element, name,observer,useCapture) 1.2.8 在Ajax.js中定义的对象和类 1.2.8.1 Class类

功能描述

在这个程序包中Class 对象在声明其他的类时候被用到。用这个对象声明类使得新类支持initialize() 方法，他起构造方法的作用。 方法列表 方法 参数 描述 create(*) (任何对象) 定义新类的构造方法。 应用案例与实例

//declaring the class

var MySampleClass = Class.create();

//defining the rest of the class implmentation MySampleClass.prototype = {

initialize: function(message) {

this.message = message; },

showMessage: function(ajaxResponse) {

alert(this.message);

13

开发参考手册

}

};

//now, let's instantiate and use one object

var myTalker = new MySampleClass('hi there.'); myTalker.showMessage(); //displays alert

1.2.8.2 Ajax.Request类

功能描述

建立Ajax连接。 属性列表 属性 类型 默认值 描述 保存连接参数，参数包括： method - get/post连接方式 parameters - 请求参数数据 postBody - post请求的数据文本 asynchronous - 指定此请求是否为异步方式 requestHeaders - http请求头参数 onSuccess - 设置XMLHTTP请求成功后的回调事件。 onFailure -设置XMLHTTP请求失败后的回调事件。 oncomplate -设置XMLHTTP请求完成后的回调事件。 XMLHTTP请求对象。 _args Object undefined _req Object undefined 方法列表 方法 initialize(arg,url) respondprocess() 参数 arg:连接参数 url:URL地址 (none) 描述 保存连接参数到_args属性中，调用内部方法create创建XMLHTTP对象，再调用connect方法进行连接。 数据接收完毕后的处理函数，调用回调函数。 应用案例与实例

//建立XMLHTTP连接，设置连接URL为/asynlogin.action，连接方式为get， //连接参数为空，请求完成后回调函数为onLogin，指定此请求是异步方式。 request=new Ajax.Request(\"/asynlogin.action\{method:'get', parameters:'',

onComplete:onLogin, asynchronous:true});

//定义请求完成后的回调函数。

function onLogin(req){

var ret=eval(req.responseText); if(!ret.retcode) {

window.disableoverfwd={

target:parent.location,link:'/loginerror.o'};

14

开发参考手册

} }

device.execute('Card','disable');

1.2.8.3 Ajax.Timer类

功能描述

Ajax计时器类，用于在一段时间后执行某函数。 方法列表 方法 参数 描述 initialize(callback, time,loop) start() onTimer() callback:回调函数 对象创建时调用，用于设置计时器参数，包time:时间间隔 括时间间隔，循环标志和回调函数，默认循loop:循环标志 环标志为ture。 (none) (none) 启动计时器，计时结束后调用内部方法onTimer，并重新计时。 调用回调函数，若循环标志为false，则关闭计时器。 应用案例与实例

//3s后执行function()函数。 (new Ajax.Timer(

function(){

device.execute('Card','enable'); },3,false)).start();

1.2.8.4 Ajax.Dom类

功能描述

DOM文档操作类。 方法列表 方法 参数 描述 toggle() hide() show() (none) (none) (none) parentElement:元素标签的父节点 name:元素类型名称 text:标签文本 properties:标签参数对象 name:元素名 name:元素名 元素显示开关。 隐藏元素。 显示元素。 append(parentElement,name,text, properties) 往指定节点中添加一个子节点。 remove(name) getHeight(name) 移除指定元素。 获取元素高度，以像素为单位。

15

开发参考手册

hasClassName(name,class) addClassName(name,class) removeClassName(name,class) name:元素名 class:类名 name:元素名 class:类名 name:元素名 class:类名 class:类名 element:元素名 style:样式属性 property:属性值 name：元素名 style：样式属性 判断元素的class属性是否为指定名称。 往元素中添加class属性，属性值为传入的类名。 移除元素的class属性值。 返回文档的Elements中所有Class属性为指定值的Element数组。 设置元素样式。 getElementsByClassName(class) setStyle (element,style, property) getStyle (name,style) 获取元素属性。 1.2.8.5 Ajax.Env类

功能描述

查看浏览器类型。 方法列表 方法 参数 描述 Env(type) type：浏览器类型，取值ie/ns 判断浏览器是否是IE浏览器或者Netscape浏览器。 1.2.8.6 Ajax.Event类

功能描述

Ajax元素事件处理类，继承Events中的所有方法。 1.2.8.7 Ajax.ElementEventManager类

功能描述 元素对象事件管理类。 方法列表 方法 参数 描述 createElementEvent(id, parentElement,name) bindEventListener(id, property)

id:标签id属性值。 parentElement:元素标签的父节点。 name:元素类型名称 id:事件所有者。 property:产生事件16

在指定元素节点下创建一个元素。如果没有给出parentElemet那么将默认为document.body，没有给出name则默认为div。 为对象的指定属性的property change事件添加一个事件处理函开发参考手册

的属性。 notifyListeners(property) property:产生事件的属性值 id:事件所有者。 listener:事件处理函数。 id:事件所有者。 数。 检测到事件，执行事件处理函数中的事件处理函数。 添加一个事件处理函数到事件列表中。 删除事件列表中的指定事件所有者的事件处理函数。 addListener(id,listener) removeListener(id)

1.3 base.js

功能描述

BASE编码和解码。 1.3.1 方法列表 方法 Base.encode(input) 参数 input:待转换成BASE编码的字符串。 input:待解码的字描述 将数据input编码成BASE编码，并返回编码后的结果。 和上面的函数相反。 Base.decode(input) 符串。 应用案例与实例 //BASE编码和解码

var endata = Base.encode(\"Test\"); alert(endata);// VGVzdA==

var dedata = Base.decode(\"VGVzdA==\"); alert(dedata);// Test

1.4 common.js

功能描述

获取国际化资源和设备错误处理方法。 1.4.1 获取国际化资源 方法

参数 17

描述 开发参考手册

btnName、labelName、Locale.getButton (btnName) messageName:对应Locale.getLabel (labelName) message.properties中nameLocale.getMessage(messageName) 值。 Locale.getDevName(devName) devName:message.properties中对应的设备名。 从message.properties中的国际化资源中获取对应的value。 从message.properties中的国际化资源中获取sys.dev. devName对应的value。。 应用案例与实例

//设置当前的语言为chinese

alert(\"message:\"+Locale.getMessage(\"sys.common.confirm\"));//“确定” alert(\"labal:\"+Locale.getLabel(\"sys.common.confirm\"));//“确定” alert(\"button:\"+Locale.getButton(\"sys.common.confirm\"));//“确定” alert(\"devname:\"+Locale.getDevName(\"magcard\"));//“读卡器”

1.4.2 获取系统参数 方法 Sys.ErrorHandlerPage Sys.getSysParam (paraName) Sys.getAppHeight() Sys.getAppWidth() Sys.getTplViewBase() Sys.getSoundPath() Sys.getAppBgColor() Sys.getAppTimeOut() Sys.getServiceInfo() Sys.getDevInfo() Sys.getDevStatInfo() Sys.getReceiptStatus() 参数 paraName:系统参数名。 描述 常量，页面出错js错误异常的统一处理界面配置（error.jsp）。 获取系统参数。 获取Tpl.AppHeight配置值。 获取Tpl.AppWidth配置值。 获取Tpl.View.Base配置值。 返回当前应用路径+在rtlconf.properties中获取到的Tpl.SoundPath配置值。 获取Tpl.AppBgColor配置值。 获取Tpl.AppTimeOut配置值。 返回系统对象信息。 获取在devconfig.xml中配置的设备对象信息。 获取设备状态信息。 获取凭条打印机状态。 功能描述

获取系统参数。

应用案例与实例 alert(\"Sys.getAppHeight=\"+Sys.getAppHeight());//Sys.getAppHeight=1024 alert(\"Sys.getAppWidth=\"+Sys.getAppWidth());//Sys.getAppWidth=1280

alert(\"Sys.getTplViewBase=\"+Sys.getTplViewBase());//Sys.getTplViewBase=/rtl/

18

开发参考手册

// Sys.getSoundPath=http://localhost:8080/app/local/chinese/sound/ alert(\"Sys.getSoundPath=\"+Sys.getSoundPath()); // Sys.getAppBgColor=#0446a7

alert(\"Sys.getAppBgColor=\"+Sys.getAppBgColor());

alert(\"Sys.getAppTimeOut=\"+Sys.getAppTimeOut());//Sys.getAppTimeOut=150 // Sys.getServiceInfo={\"defaultLanguage\":\"chinese\alert(\"Sys.getServiceInfo=\"+AppKit.tostring(Sys.getServiceInfo()));

1.4.3 设备错误处理 方法 参数 描述 DevErrorHandler.onDeviceError (srcpage,devname,args,errorCallback) srcpage:出错的JSP界面。 devname:出错的设处理设备异常，在c盘log备名称。 文件夹下记录deverror的args:错误描述信息。 日志。 errorCallback:出错后的回调函数。 srcpage:出错的JSP界面。 devname:出错的设备名称。 处理设备超时，记录日志。 args:错误描述信息。 timeoutCallback:设备调用超时后的回调函数。 srcpage:出错的JSP界面。 devname:出错的设处理设备接受错误消息，备名称。 记录日志。 args:错误描述信息。 callback:回调函数。 DevErrorHandler.onTimeout (srcpage,devname,args,timeoutCallback) DevErrorHandler.onErrorInfoReceive (srcpage,devname,args,callback) srcpage: 出错的JSP界面。 retmethod:返回错误DevErrorHandler.createErrorLog 类型。 记录错误日志。 (srcpage,retmethod,devname,args,message) devname:设备名称。 args:返回错误参数。 message:错误信息 功能描述

设备错误处理。

19

开发参考手册

应用案例与实例 //设备事件监听。 case \"DeviceError\": DevErrorHandler.onDeviceError(\"tablet.jsp\ break; case \"Timeout\": DevErrorHandler.onTimeout(\"tablet.jsp\ break;

case \"ErrorInfoReceived\": DevErrorHandler.onErrorInfoReceive(\"tablet.jsp\ break;

1.5 Sys.js

功能描述

获取系统参数。 1.5.1 获取系统参数 方法 Sys.ErrorHandlerPage Sys.getSysParam (paraName) Sys.getAppHeight() Sys.getAppWidth() Sys.getTplViewBase() Sys.getSoundPath() Sys.getAppBgColor() Sys.getAppTimeOut() Sys.getServiceInfo() Sys.getDevInfo() Sys.getDevStatInfo() Sys.getReceiptStatus() 参数 paraName:系统参数名。 描述 常量，页面出错js错误异常的统一处理界面配置（error.jsp）。 获取系统参数。 获取Tpl.AppHeight配置值。 获取Tpl.AppWidth配置值。 获取Tpl.View.Base配置值。 返回当前应用路径+在rtlconf.properties中获取到的Tpl.SoundPath配置值。 获取Tpl.AppBgColor配置值。 获取Tpl.AppTimeOut配置值。 返回系统对象信息。 获取在devconfig.xml中配置的设备对象信息。 获取设备状态信息。 获取凭条打印机状态。 应用案例与实例 alert(\"Sys.getAppHeight=\"+Sys.getAppHeight());//Sys.getAppHeight=1024 alert(\"Sys.getAppWidth=\"+Sys.getAppWidth());//Sys.getAppWidth=1280

20

开发参考手册

alert(\"Sys.getTplViewBase=\"+Sys.getTplViewBase());//Sys.getTplViewBase=/rtl/ // Sys.getSoundPath=http://localhost:8080/app/local/chinese/sound/ alert(\"Sys.getSoundPath=\"+Sys.getSoundPath()); // Sys.getAppBgColor=#0446a7

alert(\"Sys.getAppBgColor=\"+Sys.getAppBgColor());

alert(\"Sys.getAppTimeOut=\"+Sys.getAppTimeOut());//Sys.getAppTimeOut=150 // Sys.getServiceInfo={\"defaultLanguage\":\"chinese\alert(\"Sys.getServiceInfo=\"+AppKit.tostring(Sys.getServiceInfo()));

1.6 debug.js

功能描述

用于记录JSP中的日志信息。当日志等级设置为0以上，需要将IE浏览器中ActiveX脚本控件选项设为启用。 1.6.1 常用方法 方法 参数 描述 根据日志等级创建调试窗口。 level=0：调试窗口不显示，日志文件不记录； level=1：调试窗口显示，日志文件不记录； level=2：调试窗口不显示，日志文件记录； level=3：调试窗口显示，日志文件记录。 当日志等级为2,3时，记录日志文件，日志文件存放路径为filepath，日志文件名为log-yyyy-MM-dd.txt。 记录设备错误相关的日志文件，当日志等级为2,3时，记录日志文件，日志文件存放路径为filepath，日志文件名为deverror -yyyy-MM-dd.txt。 Init(level) level:日志等级，可设置为0、1、2、3。 trace(msg) msg:日志信息。 tracedeverror (msg) msg:日志信息。 应用案例与实例

//记录日志文件

logDebug.trace(\"main.jsp 进入_$('pinpad').onEvent中,cmd:\"+cmd+\

21

开发参考手册

1.7 devcommon.js

功能描述

设备相关常用操作。 1.7.1 常用方法 方法 argstostring(param) errcommonprocess (devname,cmd,args) 参数 描述 param:可为String和将json，array等类型的Object类型的参数。 devname:设备名称。 cmd:设备错误类型。 args:设备错误信息。 param转换为相应的字符串。 常用设备错误（DeviceError、Timeout、ErrorInfoReceived）操作。

1.8 devicekits.js

功能描述

devicekits.js中devicekits.build()方法用于加载所有设备相关的js，路径为\"/core/script/devjs/\"。同样，flashkits.js中flashkits.build()和globalkits中的globalkits.build()方法用来加载相关的js。

1.9 error.js

功能描述

错误映射。 1.9.1 常用方法 方法 init () 参数 描述 初始化，加载常规错误映射和设备类的错误映射。 返回设备错误码所对应的json类型的错误信息。 如果errorcode大于-100，返回常规错误码所对应的json类型的错误信息。 devname:设备名称。 findErrorJson (devname,errorcode) errorcode:错误码。

22

开发参考手册

1.10 msgbox.js

功能描述

消息提示框相关接口。 1.10.1 常用方法 方法 参数 msg: 提示信息。 hintcfg: 倒计时等待时间。 focusIndex: 提示消息返回后输入框的光标位置。 msg: 提示信息。 x:提示框x轴起始位置。 y:提示框y轴起始位置。 scale: 大小百分比。 msg: 提示信息。 x:提示框x轴起始位置。 y:提示框y轴起始位置。 scale: 大小百分比。 msg: 提示信息。 hintcfg: 倒计时等待时间。 msg: 提示信息。 描述 显示消息提示框，有返回按钮，可倒计时返回，也可点击返回按钮返回。 show(msg,hintcfg,focusIndex) confirm (msg,x,y,scale) 显示确认提示框,有确认,有退出。 openDialog (msg,x,y,scale) 打开消息提示框，无按钮，需要使用closeDialog才能关闭。 closeDialog(msg,hintcfg) setDlgMsg (msg) CreateFlash() 关闭消息提示框。 设置提示信息。 创建一个MessageBox的Flash。 应用案例与实例

//消息提示框

1.11 slide.js

功能描述

幻灯与屏保播放相关接口。

23

开发参考手册

1.10.1 常用方法 方法 setId(o) 参数 o:Id数组对象 x,y,w,h: (x,y)为幻灯片左上角坐标，(w,h)为幻灯片右下角坐标。 o:flash资源的根路径 data:幻灯片数据对象 boolean:ture/false boolean:ture/false (none) o:保存时间参数的对象 (none) (none) (none) 描述 设置幻灯片的Id对象参数： image、flash、player。 setRect(x,y,w,h,inx) 设置幻灯片在屏幕的位置。 _setFlashBase(base) setDatas(data) setWinMask(boolean) setLoop(boolean) enableKeyoverBack() setTimeout(o) overBack() view() show() 设置幻灯片文件根路径。 设置幻灯片显示数据。 设置鼠标点击页面返回。 是否循环显示。 允许按键返回。 设置超时返回。 返回函数接口。 设置flash页面标签。 显示幻灯片。 应用案例与实例

//in head

slideshows=[]

<% for(int i=1;i<=num;i++) { int k=i-1; %>

slideshows[<%= k %>]=<%= form.getParameter(name+i).getValue() %>; <% } %>

Slide.setId({image:'ssimg',flash:'ssflh',player:'ssmpl'}); Slide.setRect(0,0,'609','490');

Slide._setFlashBase(''); Slide.setDatas(slideshows); Slide.setWinMask(true); Slide.setLoop(true); Slide.view(); Slide.show();

1.12 ValidateClass.js

功能描述

验证输入数据是否有效，若需要添加新的验证类型，需在doValidate方法中添加新的case语句来设置新的验证类型，另外在getDefaultHint方法中添加新的case语句来设置验证类型的默认提示信息，然后在配置文件中设置该验证类型即可。

24

开发参考手册

1.12.1 常用方法 方法 getDefaultHint (pType, Args) doValidate (pType,Fields, Args) 参数 pType: 验证类型。Args:验证参数。 pType：验证类型。 Fields：输入数据。 Args：验证参数。 描述 验证错误后调用，用于获取该类验证的默认错误提示信息。 验证输入数据是否有效。 验证类型详细描述 描述 pType MINAMT 错误提示 设置输入最小金额为Args，若输此金额不能小于Args！请您重新输入值小于最小Args则返回错误入!。 页面。 设置密码长度为Args，若输入的密码必须为Args位！请您重新输入!。 密码长度不等于Args则返回错误页面。 设置输入长度不小于Args，若输输入项长度不能小于Args位,请重入长度小于Args则返回错误页输!。 面。 设置输入长度不大于Args，若输输入项长度不能大于Args位,请重入长度大于Args则返回错误页输!。 面。 验证输入日期格式是否正确。 您输入了无效日期,请重输! PWDLEN MINLENGTH或 MINL MAXLENGTH或MAXL ISDATE或IDT RANGEDATE或 验证输入日期在Args设置的日'此日期不在于'+Args[0]+'~'+Args[1] RDT 期范围内。 +' 位范围,请重输! ' NOTNULL或 NON RANGELENGTH或RAGL ISEMAIL或 IEML 验证输入非空。 设置输入项长度范围。 验证输入是否是E-Mail格式。 本输入项不能为空,请重输! '本输入项长度不属于 '+Args[0]+'~'+ Args[1]+' 位范围,请重输! ' 无效 E-Mail 地址格式,请重输! 应用案例与实例

1.13 flex.js

功能描述

flash相关接口。

25

开发参考手册

1.12.1 常用方法 方法 参数 描述 默认消息回调。 command=loaded，args=true，flash加载成功，args=false，flash加载失败。 command=MessageBoxHide，消息框隐藏。 command= GetFocusID，获取对应输入组件的ID。 command= GetAllVariable，获取所有inputbox和outputbox的值。 禁止页面 (false：禁止输入，true：允许输入。 配置参数传入接口、消息传入接口、当前焦点数据修改接口 模拟键盘按键，触发按钮事件。 exeFSCommand(command,args) command:指令。 args:参数。 FlexEnable (args) invokeAScript (args) simulationKeys(args) SetFocusID (args) args:true|false。 args:键盘按钮的ASCII码值。 args:对应输入组件设置输入焦点。 的ID，1、2、3…… 获取焦点并返回，当焦点在输GetFocusID(args) args:数组方式，且内每个元素为json对象，可任意组合，或则单个元素。 入组件上，返回对应的焦点ID和值用|分割，如1|123456。 UpdataVariable(args) 更新输入和输出组件参数（值）。 应用案例与实例

26