完整版TRSWCM65二次开发023接口API文档.docx
- 文档编号:24326438
- 上传时间:2023-05-26
- 格式:DOCX
- 页数:27
- 大小:26.94KB
完整版TRSWCM65二次开发023接口API文档.docx
《完整版TRSWCM65二次开发023接口API文档.docx》由会员分享,可在线阅读,更多相关《完整版TRSWCM65二次开发023接口API文档.docx(27页珍藏版)》请在冰豆网上搜索。
完整版TRSWCM65二次开发023接口API文档
修订记录
序号
变更日期
变更人员
动作
变更内容详情描述
版本
1.
2010-04-25
汪逸文
新建
新建本文档
1.0
2.
2011-01-12
陈昌
修改
1添加了修改记录页,以后本文档有修改时请填写修改信息。
3
汪逸文
修改
继续添加常用接口和示例
1基本类、常用基本方法
1.1常用方法
该节的方法需要依赖的JS引入情况如下:
1.1.1判断数据类型的方法
1.1.1.1判断数据是否是数组Ext.isArray(o)和Array.isArray(o)
✓方法说明:
通过这个方法,可以判断当前参数o的数据类型是否是数组,返回true或false;
✓参数说明:
参数o是要判断的数据;
✓使用示例:
例如要判断rels是否是数组;
varrels=[];
Array.isArray(rels);
1.1.1.2判断数据是否是布尔型数据Ext.isBoolean(o)
✓方法说明:
判断数据的类型是否是布尔型,返回true或false;
✓参数说明:
参数o是要判断的数据;
✓使用示例:
例如要判断o是否是布尔型数据;
varo=true;
Ext.isBoolean(o);
1.1.1.3判断数据类型是否是函数Ext.isFunction(o)
✓方法说明:
判断数据的类型是否是函数,返回true或false;
✓参数说明:
参数o是要判断的数据;
✓使用示例:
例如要判断参数o是否是函数;
varo=function(){};
Ext.isFunction(o);
1.1.1.4判断数据类型是否是字符串Ext.isString(o)
✓方法说明:
判断数据的类型是否是字符串型,返回true或false;
✓参数说明:
参数o是要判断的数据;
✓使用示例:
例如要判断定义的o是否是字符串类型;
varo='aaa';
Ext.isString(o);
1.1.1.5判断数据类型是否是数字Ext.isNumber(o)
✓方法说明:
判断数据的类型是否是number型,返回true或false;
✓参数说明:
参数o是要判断的数据;
✓使用示例:
例如要判断参数o是否是数字类型;
varo=3;
Ext.isNumber(o);
1.1.1.6判断数据类型是否是为空Ext.isEmpty(o,notAllowBlank)
✓方法说明:
判断数据的类型是否是空类型,包括null、undefined、以及notAllowBlank参数不传或者传false,空串也返回true,返回true或false;
✓参数说明:
参数o是要判断的数据,参数notAllowBlank是是否允许空串也为空;
✓使用示例:
例如要o是否为空;
varo='';
Ext.isEmpty(o);
1.1.1.7判断数据是否是基本数据类型(数字、字符串、布尔型)Ext.isSimpType(o)
✓方法说明:
判断数据的类型是否是基本数据类型,包括数字类型、字符串类型、布尔型,返回true或false;
✓参数说明:
参数o是要判断的数据;
✓使用示例:
例如要判断o是否是基本数据类型;
varo=true;
Ext.isSimpType(o);
1.1.1.8判断数据是否是object的方法Ext.isObject(o)
✓方法说明:
判断数据的类型是否是object型,返回true或false;
✓参数说明:
参数o是要判断的数据;
✓使用示例:
例如要判断数据o是否是一个object类型;
varo=newObject();
Ext.isObject(o);
1.1.1.9判断数据是否是dom元素的方法Ext.isDom(o)
✓方法说明:
判断数据的类型是否是dom元素类型,返回true或false;
✓参数说明:
参数o是要判断的数据;
✓使用示例:
例如要判断o是否是dom元素;
//te是一个元素的id
varo=$('te');
Ext.isDom(o);
1.1.2字符串String的扩展方法
1.1.2.1判断字符串是否以某串字符结束endsWith(sEnd)
✓方法说明:
判断字符串是否是以某指定的字符串sEnd结束,返回true或false;
✓参数说明:
参数sEnd是字符串;
✓使用示例:
例如要判断字符串s是否是以'efg'结束;
//判断字符串s是否是以'efg'结束
vars='abcdefg';
alert(s.endsWith('efg'));
1.1.2.2判断字符串是否以某串字符开始startsWith(sStart)
✓方法说明:
判断字符串是否是以某指定的字符串sStart开始,返回true或false;
✓参数说明:
参数sStart是字符串;
✓使用示例:
例如要判断字符串s是否是以'abc'开始;
//判断字符串s是否是以'abc'开始
vars='abcdefg';
alert(s.startsWith('abc'));
1.1.2.3去除字符串两头的空格trim()
✓方法说明:
去除字符串两头的空格,返回新的字符串;
✓参数说明:
无;
✓使用示例:
例如要将字符串s中两头的空格去掉;
//将字符串s中两头的空格去掉
vars='aaaa';
alert(s.trim());
1.1.2.4获取字符串的字符长度byteLength()
✓方法说明:
获取字符串的字符长度,一个汉字占2个字符;
✓参数说明:
无;
✓使用示例:
例如要获取字符串s的字符长度,一个汉字占2个字符;
//获取字符串的字符长度,一个汉字占2个字符
vars='汉字';
alert(s.byteLength());
1.1.2.5字符串比较,忽略大小写equalsI(sc)
✓方法说明:
忽略大小写比较2个字符串是否相等,返回true或者false;
✓参数说明:
参数sc是源字符串;
✓使用示例:
例如要比较2个字符串是否相等,忽略大小写;
//比较2个字符串是否相等,忽略大小写
vars='AAA';
alert(s.equalsI('aaa'));
1.1.2.6将链接参数串转成json对象parseQuery()
✓方法说明:
将链接参数串转化成json对象,返回一个json对象;
✓参数说明:
无;
✓使用示例:
例如要将链接的参数串s转化成json对象;
//将链接的参数串s转化成json对象
vars='?
aaa=1&bbb=2&ccc=3';
varqueryA=s.parseQuery();
alert(queryA['aaa']);
1.1.3Array数组扩展方法
1.1.3.1获取数组的最后一个元素last()
✓方法说明:
获取数组中的最后的一个元素,并返回;
✓参数说明:
无;
✓使用示例:
例如要取数组a中的最后一个元素;
//取数组a中的最后一个元素
vara=[3,4,5,6];
alert(a.last());
1.1.3.2获取数组中某个元素的索引位indexOf(o)
✓方法说明:
获取元素o在数组中的位置,返回整数,没有找到元素o,返回-1;
✓参数说明:
参数o是要在数组中查找的元素;
✓使用示例:
例如要获取元素4在数组a中的位置;
//获取元素4在数组a中的位置
vara=[3,4,5,6];
alert(a.indexOf(4));
1.1.3.3移除数组中的指定的元素remove(o)
✓方法说明:
将数组中的元素o移除,返回移除后的数组;
✓参数说明:
参数o是要移除的元素;
✓使用示例:
例如要将取元素4从数组a中移除;
//将取元素4从数组a中移除
vara=[3,4,5,6];
alert(a.remove(4));
1.1.3.4移除数组中的空元素compact()
✓方法说明:
移除数组中的null元素,返回移除后的数组;
✓参数说明:
无;
✓使用示例:
例如要将数组中的null元素移除;
//将数组中的null元素移除
vara=[3,4,null,5,null,6];
alert(pact());
1.1.3.5判断指定数组是否包含某个指定的元素include(o)
✓方法说明:
判断指定数组是否包含某个元素,返回true或者false;
✓参数说明:
参数o是要判断是否包含的元素;
✓使用示例:
例如要判断数组a是否包含元素4;
//判断数组a是否包含元素4
vara=[3,4,5,6];
alert(a.include(4));
1.1.3.6循环遍历数组的每个元素,对每个元素进行相应处理each(function(item,index){})
✓方法说明:
循环遍历数组,参数是一个处理函数,对每个元素按处理函数处理;
✓参数说明:
参数是一个处理函数,处理函数的第一个参数是当前遍历到的元素,第二个参数是当前遍历到了数组的第几个元素;
✓使用示例:
例如循环遍历数组a,对每个元素进行相应输出;
//循环遍历数组,对每个元素进行相应处理
vara=[3,4,5,6];
a.each(function(item){
alert(item);
});
1.1.4Dom元素扩展的方法
1.1.4.1根据某个dom对象递归向父元素找具有某个属性或者某个样式的元素Element.find(t,attr,cls,aPAttr)
✓方法说明:
通过这个方法,可以根据指定的元素递归向上在自己和父元素中找具有某个属性或者样式的元素;
✓参数说明:
t是要从这个元素开始找得元素,attr参数是查找是否含有的属性名称,cls参数是查找是否含有的样式名称,aPAttr参数是属性数组,用于查找是否含有该属性数组里面的属性的元素;
✓使用示例:
例如根据指定的dom元素,查看dom元素及其父元素中是否能找到含有“trs_layout”样式的元素;
Element.find(dom,null,'trs_layout');
1.1.4.2切换某个元素的显示/隐藏Element.toggle(el)
✓方法说明:
通过这个方法,可以切换某个元素的显示隐藏,如果该元素原来是显示的,执行了该方法,该元素将隐藏,反之亦然。
✓参数说明:
el是要切换的元素的id或者是该元素对象;
✓使用示例:
例如要切换id为test的元素显示/隐藏;
Element.toggle('test');
1.1.4.3显示某个元素Element.show(el)
✓方法说明:
通过这个方法,可以使某个元素的显示,如果该元素原来是隐藏的,执行了该方法,该元素将显示。
✓参数说明:
el是要切换的元素的id或者是该元素对象;
✓使用示例:
例如要显示id为test的元素;
Element.show('test');
1.1.4.4隐藏某个元素Element.hide(el)
✓方法说明:
通过这个方法,可以使某个元素的显示,如果该元素原来是显示的,执行了该方法,该元素将隐藏。
✓参数说明:
el是要切换的元素的id或者是该元素对象;
✓使用示例:
例如要隐藏id为test的元素;
Element.hide('test');
1.1.4.5判断某个元素是否有某个样式Element.hasClassName(el,cs)
✓方法说明:
通过这个方法,可以判断指定元素是否有指定的样式class。
✓参数说明:
el是要切换的元素的id或者是该元素对象;
✓使用示例:
例如要判断一个id为test的元素是否具有样式名为box的样式;
Element.hasClassName('test',’box’);
1.1.4.6给某个元素添加某个样式Element.addClassName(el,cs)
✓方法说明:
通过这个方法,可以为指定元素添加指定的样式class。
✓参数说明:
el是要切换的元素的id或者是该元素对象;
✓使用示例:
例如要给一个id为test的元素添加样式名为box的样式;
Element.addClassName('test',’box’);
1.1.4.7给某个元素去掉某个样式Element.removeClassName(el,cs)
✓方法说明:
通过这个方法,可以为指定元素去掉指定的样式class。
✓参数说明:
el是要切换的元素的id或者是该元素对象;
✓使用示例:
例如要给一个id为test的元素去掉样式名为box的样式;
Element.removeClassName('test',’box’);
1.1.4.8取指定元素的后一个兄弟节点Element.next(dom)
✓方法说明:
通过这个方法,可以获取到指定的dom元素的后一个兄弟节点。
✓参数说明:
参数dom是dom元素对象;
✓使用示例:
例如要获取id为test的dom元素的下一个兄弟节点;
Element.next($('test'));
1.1.4.9取指定元素的前一个兄弟节点Element.previous(dom)
✓方法说明:
通过这个方法,可以获取到指定的dom元素的前一个兄弟节点。
✓参数说明:
参数dom是dom元素对象;
✓使用示例:
例如要获取id为test的dom元素的前一个兄弟节点;
Element.previous($('test'));
1.1.4.10取指定元素的第一个子节点Element.first(dom)
✓方法说明:
通过这个方法,可以获取到指定的dom元素的第一个子节点。
✓参数说明:
参数dom是dom元素对象;
✓使用示例:
例如要获取id为test的dom元素的第一个子节点;
Element.first($('test'));
1.1.4.11取指定元素的最后一个子节点Element.last(dom)
✓方法说明:
通过这个方法,可以获取到指定的dom元素的最后一个子节点。
✓参数说明:
参数dom是dom元素对象;
✓使用示例:
例如要获取id为test的dom元素的最后一个子节点;
Element.last($('test'));
1.1.4.12移除某个元素Element.remove(dom)
✓方法说明:
移除指定的dom元素。
✓参数说明:
参数dom是dom元素对象;
✓使用示例:
例如要移除id为test的dom元素;
Element.remove($('test'));
1.1.5Json对象的相应方法
1.1.5.1获取json对象指定属性的值Ext.Json.value(json,xp,bCase)和$v(json,xp,bCase),两者等价
✓方法说明:
获取json对象指定属性的值;
✓参数说明:
参数json是json对象,xp是属性名称,bCase是控制属性是否不转为大写;
✓使用示例:
例如要获取json对象a的aaa属性值,bCase不传,默认为转为大写;
//获取json对象a的aaa属性值,bCase不传,默认为转为大写
vara={
AAA:
1,
BBB:
2,
CCC:
3
};
alert($v(a,'aaa'));
1.1.5.2获取json对象指定属性的数组Ext.Json.array(json,xp,bCase)和$a(json,xp,bCase),两者等价
✓方法说明:
获取json对象指定属性的值得数组,即指定的属性是一个数组;
✓参数说明:
参数json是json对象,xp是属性名称(可以用”.”分隔),bCase是控制属性是否不转为大写;
✓使用示例:
例如要获取json对象a的doc数组,即多个doc的集合;
//获取json对象a的doc数组,即多个doc的集合
vara={
docs:
{
doc:
[{
title:
'aaa',
content:
'bbb'
},{
title:
'aaa1',
content:
'bbb1'
},{
title:
'aaa2',
content:
'bbb3'
}]
}
};
alert($a(a,'docs.doc',true));
1.1.5.3将xmlDocument对象解析成json对象Ext.Json.parseXml(xml)
✓方法说明:
将xmlDocument对象解析成json对象;
✓参数说明:
参数xml是xmlDocument对象;
✓使用示例:
将xmlDocument对象转化为json对象;
Ext.Json.parseXml(xml)
1.1.6浏览器event的方法
1.1.6.1添加监听事件的方法Event.observe(el,name,fn)
✓方法说明:
通过这个方法,可以给某个对象绑定对某个事件的监听,并做相应的事情;
✓参数说明:
el是监听对象的id或者name串,name参数是监听的事件名串,fn是监听所要触发的事件;
✓使用示例:
例如要给一个id为oIpt的input元素绑定一个监听click事件,单击后input框清空;
Event.observe('oIpt','click',function(){
//执行清空操作
$('oIpt').value="";
});
1.1.6.2取消监听某事件的方法Event.stopObserving(el,name,fn)
✓方法说明:
取消对某个对象的某个事件的监听,并做相应的事情;
✓参数说明:
el是监听对象的id或者name串,name参数是监听的事件名串,fn是监听所要触发的事件;
✓使用示例:
例如要对上面那个id为oIpt的input元素取消监听click事件;
Event.stopObserving('oIpt','click',function(){
.......
});
1.1.7向Json追加参数的方法Ext.apply(o1,o2),Ext.applyIf(o1,o2)
✓方法说明:
Ext.apply和Ext.applyIf都是向Json中追加参数的方法,applyIf所不同的是只追加没有的,有就不追加了,而apply如果是有的话就覆盖了。
✓参数说明:
o1是被追加的Json对象,是返回的对象,o2是要追加的参数;
✓使用示例:
比如要向一个Json--oparams中追加一个siteid属性;
//定义构造oParams
varoParams={
objectId:
$('objId').value,
docName:
$('docName').value
}
//向oParams中追加siteid参数,siteid以一个json对象的形式加入
//applyIf与apply使用方法类似,使用需根据需要而定
Ext.apply(oParams,{
SiteId:
obj.getId()
});
1.1.8转成数组的方法$A(iterable)
✓方法说明:
这个方法是把对象集合转成对象数组,让其具有数组的属性;
✓参数说明:
参数iterable是个对象集;
✓使用示例:
把当前页面的所有input元素的集合转成数组
varinputArray=$A(document.getElementsByTagName("INPUT"));
1.1.9客户端转义方法$transHtml(_sContent)和$trans2Html(_sContent,_bChangeBlank)
✓方法说明:
$transHtml和$trans2Html都是对内容中的特殊字符进行转义,$transHtml主要是对“<”,“>”,“"”进行转义,而$trans2Html是根据参数_bChangeBlank来决定是否对空格进行转义。
✓参数说明:
参数_sContent需要转义的内容,是字符串,_bChangeBlank为boolean型,决定是否对空格转义;
✓使用示例:
//获取对象obj上的value属性值,并进行转义
varvalue=$transHtml(obj.getProperty('value'));
//需要把空格也做转义
varvalue=$trans2Html(obj.getProperty('value'),true);
1.1.10获取form中某个元素的值:
$F(_id)
✓方法说明:
获取form表单中某个子节点(id为_id的元素)的值
✓参数说明:
参数_id是元素的id
✓使用示例:
获取id为startTimeHour的元素的值
//获取id为startTimeHour的节点的值
varaStartTimeHour=$F('startTimeHour');
1.1.11将json对象转化成用‘&’连接的链接参数键值串$toQueryStr(p0,up,encode),方法$toQueryStr2(p0,up)功能类似,只是不做字符的编码
✓方法说明:
将json对象转化成链接后面所带参数的形式,返回的是以’&’拼接的参数键值串;
✓参数说明:
参数p0是需要转化的json对象,参数up是控制是否要转为大写,参数encode是控制是否要对字符编码;
✓使用示例:
将参数json对象a转化为链接参数串;
//将参数json对象a转化为链接参数串
vara={
aaa:
1,
bbb:
2,
ccc
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 完整版 TRSWCM65 二次开发 023 接口 API 文档