xui.DataBinder


父类

xui.absObj

构造函数

xui.DataBinder ( /**/ )

生成一个databinder对象.

静态属性

WDSLCache    

WDSLCache

SOAP的WDSL缓存.

静态方法

destroyAll    getFromName    

destroyAll ( )    [函数源代码]

销毁所有xui.DataBinder对象.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. //xui.DataBinder.destroyAll()

 

^

getFromName ( name )    [函数源代码]

获取名字为指定值的xui.DataBinder对象.

返回值: xui.DataBinder Object.

参数:

  • name [必需参数] : String, DataBinder名字.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var db = new xui.DataBinder(); 

  2. db.setName('abc'); 

  3. alert(db = xui.DataBinder.getFromName('abc')); 

  4. db.destroy(); 

  5. alert(xui.DataBinder.getFromName('abc'));

 

^

继承自 xui.absObj

getAll    pickAlias    setDataModel    setEventHandlers    unserialize    

getAll ( )    [函数源代码]

获取该类的所有对象实例.

返回值: xui.absObj, 当前类对象

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. alert(xui.UI.getAll().get().length)

 

^

pickAlias ( )    [函数源代码]

为类选择一个可用的对象的别名.

返回值: String

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. alert(xui.UI.Button.pickAlias())

 

^

setDataModel ( hash )    [函数源代码]

设置类的一系列数据模型.

返回值: xui.absObject

参数:

  • hash [必需参数] : 键值对

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var o = (new xui.UI.Button).render(); 

  2. //no 'test' data[getTest function, setTest functon] yet 

  3. alert(o.getTest); 

  4. //Add 'test' data model to the Class 

  5. xui.UI.Button.setDataModel({ 

  6.     test : 'default value' 

  7. }); 

  8. //Creates a new instance 

  9. o = (new xui.UI.Button).render(); 

  10. //call getTest here 

  11. alert(o.getTest()); 

  12. //Removes that 'test' data model from the Class 

  13. xui.UI.Button.setDataModel({ 

  14.     test : null 

  15. })

 

^

setEventHandlers ( hash )    [函数源代码]

设置类的一系列事件.

返回值: xui.absObject

参数:

  • hash [必需参数] : 键值对

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var o = new xui.UI.Button

  2. //No 'onA' event handler yet 

  3. alert(o.onA); 

  4. //Sets 'onA' event handler to Class 

  5. xui.UI.Button.setEventHandlers({ 

  6.     onA : function(){} 

  7. }); 

  8. //Adds an 'onA' event function to the instance 

  9. o.onA(function(){ 

  10.     alert('a'

  11. }); 

  12. //Fires the 'onA' event function 

  13. o.onA(); 

  14. //Removes the 'onA' event handler from Class 

  15. xui.UI.Button.setEventHandlers({ 

  16.     onA : null 

  17. });

 

^

unserialize ( target,keepSerialId )    [函数源代码]

将JSON字符串或数组反序列化为xui.absObj对象.

返回值: xui.UI

参数:

  • target [必需参数] : String/Array.

  • keepSerialId [可选参数] : Boolean, 指示是否保留序列号. 默认为 [false].

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var s = xui.UIProfile.getFromDom('btnLang').boxing().serialize(false); 

  2. alert(_.serialize(s)); 

  3. alert(xui.UI.unserialize(s))

 

^

继承自 xui.absBox

pack    plugIn    

pack ( arr,ensureValue )    [函数源代码]

打包装箱一组元素,并生成一个 [xui.absBox] 对象.

返回值: xui.absBox

参数:

  • arr [必需参数] : Array, 一组值.

  • ensureValue [可选参数] : Boolean, 是否强制检测每个箱内元素值的有效性. 默认为 true.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var nodes = xui.Dom.pack(['btnLang',document.getElementById('btnLang')]); 

  2. alert(nodes.get(0).id)

 

^

plugIn ( name,fun )    [函数源代码]

向当前类加一个 plug-in 函数.

返回值: [self]

参数:

  • name [必需参数] : String, plug-in 函数名字.

  • fun [必需参数] : Function, plug-in 插件函数体.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var n = xui('btnLang'); 

  2. alert(n.getBackgroundImg); 

  3. xui.Dom.plugIn('getBackgroundImg',function(){ 

  4.     return this.css('backgroundImage'

  5. }); 

  6. alert(n.getBackgroundImg());

 

^

实例方法

checkValid    destroy    getData    getDataSourceType    getDirtied    getName    getProxyType    getQueryArgs    getQueryAsync    getQueryMethod    getQueryModel    getQueryOptions    getQueryPassword    getQueryURL    getQueryUserName    getRequestId    getRequestType    getResponseType   getTokenParams    getUI    getUIValue    invoke    isDirtied    read    setData    setDataSourceType    setHost    setName    setProxyType    setQueryArgs    setQueryAsync    setQueryMethod    setQueryModel    setQueryOptions    setQueryPassword    setQueryURL    setQueryUserName    setRequestId   setRequestType    setResponseType    setTokenParams    updateDataFromUI    updateDataToUI    updateValue    write    

checkValid ( )    [函数源代码]

检查所有绑定值是否有效. 例如: 用户输入了字符到数字框里面,而数字框又绑定了databinder, 这个函数就会返回[false].

返回值: xui.absValue

^

destroy ( )    [函数源代码]

销毁该对象.

说明: 一般情况下,程序员无需直接调用该函数.

^

getData ( key )    [函数源代码]

获取内部数据.

返回值: Object, 键值对.

参数:

  • key [可选参数] : String, 如指定key表示只获取特定键的内部数据

^

getDataSourceType ( )

获取数据源的类型.

返回值: String

^

getDirtied ( withCaption )    [函数源代码]

得到脏绑定控件的界面值

返回值: Object, 键值对.

参数:

  • withCaption [可选参数] : Boolean, 是否连控件的caption一起获取(如果控件有caption属性的话), 默认为false

^

getName ( )

返回数据绑定器名字.

返回值: String

说明: 参看'getValue'代码片段.

^

getProxyType ( )

获取远程数据源的数据请求代理种类.

返回值: String

^

getQueryArgs ( )

获取远程数据源的数据请求参数.

返回值: Object

^

getQueryAsync ( )

获取远程数据源的数据请求是否为异步方式.

返回值: Boolean

^

getQueryMethod ( )

获取远程数据源的URL请求方式.

返回值: String

^

getQueryModel ( )

获取远程数据源的模板(MVC的M)名称.

返回值: Boolean

^

getQueryOptions ( )

获取远程数据源数据请求时的自定义选项[同 Ajax/SAjax/IAjax 的 options].

返回值: Object

^

getQueryPassword ( )

获取远程数据源的URL请求密码.

返回值: String

^

getQueryURL ( )

获取远程数据源的URL请求地址.

返回值: String

^

getQueryUserName ( )

获取远程数据源的URL请求用户名.

返回值: String

^

getRequestId ( )

获取远程数请求的标识ID.

返回值: String

^

getRequestType ( )

获取向远程数据源发送数据请求的数类型.

返回值: String

^

getResponseType ( )

获取从远程数据源得到的数据类型.

返回值: String

^

getTokenParams ( )

获取数据请求token参数.

返回值: Object

^

getUI ( key )    [函数源代码]

获取绑定在本对象上的UI.

返回值: xui.UI.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var id = 'xui.temp.ui'

  2. if( ! xui.Dom.byId(id)){ 

  3.     this.prepend(xui.create('<div id=' + id + ' style="border:solid 1px;padding:10px;">' + '<br /><button onclick="xui(this).parent().remove()">remove this example</button>' + '</div>')); 

  4.     xui(id).append(new xui.UI.Input({ 

  5.         position : 'relative'

  6.         dataBinder : 'abc' 

  7.     })); 

  8.     alert(xui.DataBinder.getFromName('abc').getUI().serialize()); 

  9. }

 

说明: To see the 'getValue' snippets.

^

getUIValue ( withCaption,dirtied )    [函数源代码]

得到绑定控件的界面值

返回值: Object, 键值对.

参数:

  • withCaption [可选参数] : Boolean, 是否连控件的caption一起获取(如果控件有caption属性的话), 默认为false

  • dirtied [可选参数] : Boolean, 是否只获得脏控件的界面值

^

invoke ( onSuccess,onFail,onStart,onEnd,mode,threadid,options )    [函数源代码]

远程数据调用.

返回值: [xui.absIO]

参数:

  • onSuccess [可选参数] : Function, 参数:[response Object, response type, threadid]. 当request成功时回调该函数.

  • onFail [可选参数] : Function, 参数:[response Object, response type, threadid]. 当request失败时回调该函数.

  • onStart [可选参数] : Function, ajax开始时的载的回调函数.

  • onEnd [可选参数] : Function, ajax结束时的回调函数.

  • mode [可选参数] : String, 调用方式,normal(ajax调用)/busy(ajax调用并显示busy界面)/return(不调用,返回ajax对象)之一,默认为normal.

  • threadid [可选参数] : String, 目前request所在的线程的 id. 过程一般为:[挂起thread -> 执行request -> 继续thread]

  • options [可选参数] : Object, 一组配置数据.

^

isDirtied ( )    [函数源代码]

判断绑定控件是否已经被修改.

返回值: Boolean

^

read ( onSuccess,onFail,onStart,onEnd,mode,threadid,options,adjustData )    [函数源代码]

读取数据的远程数据调用.

返回值: [xui.absIO]

参数:

  • onSuccess [可选参数] : Function, 参数:[response Object, response type, threadid]. 当request成功时回调该函数.

  • onFail [可选参数] : Function, 参数:[response Object, response type, threadid]. 当request失败时回调该函数.

  • onStart [可选参数] : Function, ajax开始时的载的回调函数.

  • onEnd [可选参数] : Function, ajax结束时的回调函数.

  • mode [可选参数] : String, 调用方式,normal(ajax调用)/busy(ajax调用并显示busy界面)/return(不调用,返回ajax对象)之一,默认为norma.

  • threadid [可选参数] : String, 目前request所在的线程的 id. 过程一般为:[挂起thread -> 执行request -> 继续thread]

  • options [可选参数] : Object, 一组配置数据.

^

setData ( key,value )    [函数源代码]

设置内部数据.

返回值: [self].

参数:

  • key [必需参数] : Object/String, 键/值对或键关键字.

  • value [可选参数] : Object, 值关键字,只有在key为String的时候有效.

^

setDataSourceType ( value,force,tag,tag2 )

设置数据源的类型.

返回值: [self].

参数:

  • value [必需参数] : String, 数据源的类型. 'none','memory','remoting' 之一,默认为none. 只有设置为'remoting', queryURL,queryUserName, queryPassword, queryMethod,queryAsync,queryModel,queryArgs,tokenParams,queryOptions,proxyType,requestType,responseType等属性才会有效.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setHost ( value,alias )    [函数源代码]

设置借宿对象和别名.

返回值: [self]

参数:

  • host [可选参数 : Object, 宿主.

  • alias [可选参数 : String, 别名字符串.

^

setName ( value,force,tag,tag2 )

设置数据绑定器的名称.

返回值: [self]

参数:

  • value [必需参数] : String, 名字字符串

说明: 参看'getValue'代码片段.

^

setProxyType ( value,force,tag,tag2 )

设置远程数据源的数据请求代理种类.

返回值: [self].

参数:

  • value [必需参数] : String. auto/Ajax/SAjax/IAjax之一,默认为auto.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setQueryArgs ( value,force,tag,tag2 )

设置远程数据源的数据请求参数.

返回值: [self].

参数:

  • value [必需参数] : Object.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setQueryAsync ( value,force,tag,tag2 )

设置远程数据源的数据请求是否为异步方式.

返回值: [self].

参数:

  • value [必需参数] : Boolean.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setQueryMethod ( value,force,tag,tag2 )

设置远程数据源的URL请求方式.

返回值: [self].

参数:

  • value [必需参数] : String. 'auto','GET'或'POST', 默认为auto.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setQueryModel ( value,force,tag,tag2 )

设置远程数据源的模板(MVC的M)名称. 这个模板字符串会加到数据源请求地址的后面.

返回值: [self].

参数:

  • value [必需参数] : String.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setQueryOptions ( value,force,tag,tag2 )

设置远程数据源数据请求时的自定义选项[同 Ajax/SAjax/IAjax 的 options].

返回值: [self].

参数:

  • value [必需参数] : Object.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setQueryPassword ( value,force,tag,tag2 )

设置远程数据源的URL请求密码.

返回值: [self].

参数:

  • value [必需参数] : String

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setQueryURL ( value,force,tag,tag2 )

设置远程数据源的URL请求地址.

返回值: [self].

参数:

  • value [必需参数] : String

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setQueryUserName ( value,force,tag,tag2 )

设置远程数据源的URL请求用户名.

返回值: [self].

参数:

  • value [必需参数] : String

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setRequestId ( value,force,tag,tag2 )

设置远程数请求的标识ID.

返回值: [self].

参数:

  • value [必需参数] : String. 自定义的请求标识.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setRequestType ( value,force,tag,tag2 )

设置向远程数据源发送数据请求的数类型.

返回值: [self].

参数:

  • value [必需参数] : String. HTTP,JSON,XML,SOAP 之一

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setResponseType ( value,force,tag,tag2 )

设置从远程数据源得到的数据类型.

返回值: [self].

参数:

  • value [必需参数] : String. JSON,XML,SOAP 之一

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setTokenParams ( value,force,tag,tag2 )

设置数据请求token参数.

返回值: [self].

参数:

  • value [必需参数] : Object.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

updateDataFromUI ( updateUIValue,withCaption,returnArr,adjustData,dataKeys )    [函数源代码]

从绑定的UI上获取值,并设置到内部数据data.

返回值: [self]

参数:

  • updateUIValue [可选参数] : Boolean, 立即重新设置界面数据和清理脏数据标识, 默认为true

  • withCaption [可选参数] : Boolean, 是否连控件的caption一起获取(如果控件有caption属性的话), 默认为false

  • returnArr [可选参数] : Boolean, 是否得到数组格式(只针对可多选择absList控件), 默认为false

  • adjustData [可选参数] : Function, 对从UI获取到的数据做调整的函数(在设置到内部data之前)

  • dataKeys [可选参数] : String/Array, 获取的数据项.

^

updateDataToUI ( adjustData,dataKeys )    [函数源代码]

从内部数据data设置数据到所绑定的UI.

返回值: [self]

参数:

  • adjustData [可选参数] : Function, 对内部数据做调整的函数(在设置到UI之前).

  • dataKeys [可选参数] : String/Array, 设置的数据项.

^

updateValue ( )    [函数源代码]

将绑定控件的内部值更新为界面值,并去掉脏标识.

返回值: [self]

^

write ( onSuccess,onFail,onStart,onEnd,mode,threadid,options )    [函数源代码]

写入数据的远程数据调用.

返回值: [xui.absIO]

参数:

  • onSuccess [可选参数] : Function, 参数:[response Object, response type, threadid]. 当request成功时回调该函数.

  • onFail [可选参数] : Function, 参数:[response Object, response type, threadid]. 当request失败时回调该函数.

  • onStart [可选参数] : Function, ajax开始时的载的回调函数.

  • onEnd [可选参数] : Function, ajax结束时的回调函数.

  • mode [可选参数] : String, 调用方式,normal(ajax调用)/busy(ajax调用并显示busy界面)/return(不调用,返回ajax对象)之一,默认为norma.

  • threadid [可选参数] : String, 目前request所在的线程的 id. 过程一般为:[挂起thread -> 执行request -> 继续thread]

  • options [可选参数] : Object, 一组配置数据.

^

继承自 xui.absObj

alias    clone    getAlias    getDesc    getEvents    getHost    getPropBinder    getProperties    getTag    getTagVar    host    reBindProp    serialize    setAlias    setDesc    setEvents    setPropBinder    setProperties    setTag    setTagVar    

alias ( value )    [函数源代码]

@Deprecated.(请用 setAlias/getAlias)

^

clone ( )    [函数源代码]

clone

^

getAlias ( )    [函数源代码]

获取别名.

返回值: String

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var o = xui.UIProfile.getFromDom('btnLang'); 

  2. alert(o.alias); 

  3. alert(o.host[o.alias].get(0) === o)

 

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var host = {},o = new xui.UI.Button

  2. o.setHost(host,'aBtn'); 

  3. alert(host.aBtn.KEY); 

  4. o.setAlias('bBtn'); 

  5. alert(host.aBtn); 

  6. alert(host.bBtn.KEY);

 

^

getDesc ( )

获取控件的描述值

返回值: String

^

getEvents ( key )    [函数源代码]

获取当前对象的所有事件或某个指定的事件.

返回值: Object

^

getHost ( )    [函数源代码]

获取宿主对象.

返回值: Object

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var o = xui.UIProfile.getFromDom('btnLang'); 

  2. alert(o.host === SPA);

 

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var host = {},o = new xui.UI.Button

  2. o.setHost(host,'aBtn'); 

  3. alert(host.aBtn.KEY);

 

^

getPropBinder ( )

获取控件的附属性绑定配置

返回值: Object

^

getProperties ( key )    [函数源代码]

取得当前对象所有的属性或某个指定的属性.

返回值: Object

参数:

  • key [可选参数] : String或Boolean, 属性名称.如果为true,将返回包括隐藏属性的所有属性.

^

getTag ( )

获取控件的附加值

返回值: String

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var id = 'xui.temp.ui40'

  2. if( ! xui.Dom.byId(id)){ 

  3.     this.prepend(xui.create('<div id=' + id + ' style="border:solid 1px;padding:20px;position:relative;height:100px;width:300px;">' + '<button style="position:absolute; bottom:0px; z-index:2;" onclick="xui(this).parent().remove()">remove this example</button>' + '</div>')); 

  4.     var btn; 

  5.     xui(id).prepend(btn = new xui.UI.Button); 

  6.     _.asyRun(function(){ 

  7.         btn.setTag('tag'); 

  8.         alert(btn.getTag()) 

  9.     },1000

  10. }

 

^

getTagVar ( )

获取控件的附加对象

返回值: Object

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var id = 'xui.temp.ui42'

  2. if( ! xui.Dom.byId(id)){ 

  3.     this.prepend(xui.create('<div id=' + id + ' style="border:solid 1px;padding:20px;position:relative;height:100px;width:300px;">' + '<button style="position:absolute; bottom:0px; z-index:2;" onclick="xui(this).parent().remove()">remove this example</button>' + '</div>')); 

  4.     var btn; 

  5.     xui(id).prepend(btn = new xui.UI.Button); 

  6.     _.asyRun(function(){ 

  7.         btn.setTagVar([1,2]); 

  8.         alert(btn.getTagVar()) 

  9.     },1000

  10. }

 

^

host ( value,alias )    [函数源代码]

@Deprecated.(请用 setHost/getHost)

^

reBindProp ( dataMap,inner )    [函数源代码]

重新绑定属性

返回值: [self]

参数:

  • dataMap [必需参数] : Object. 重新绑定的对象

^

serialize ( rtnString,keepHost )    [函数源代码]

将当前对象序列化为JSON字符串.

返回值: String

参数:

  • rtnString [可选参数] : Boolean, to indicate whether or not it returns String or Object. 默认为 true.

  • keepHost [可选参数] : Boolean, to keep host Object link or not. 默认为 false.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. alert(xui.UIProfile.getFromDom('btnLang').boxing().serialize()); 

  2. alert(xui.UIProfile.getFromDom('btnLang').boxing().serialize(false))

 

^

setAlias ( str )    [函数源代码]

设置别名.

返回值: [self]

参数:

  • str [可选参数] : String, 别名字符串.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var o = xui.UIProfile.getFromDom('btnLang'); 

  2. alert(o.alias); 

  3. alert(o.host[o.alias].get(0) === o)

 

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var host = {},o = new xui.UI.Button

  2. o.setHost(host,'aBtn'); 

  3. alert(host.aBtn.KEY); 

  4. o.setAlias('bBtn'); 

  5. alert(host.aBtn); 

  6. alert(host.bBtn.KEY);

 

^

setDesc ( value,force,tag,tag2 )

设置控件的描述值.

返回值: [self]

参数:

  • value [必需参数] : String.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setEvents ( key,value )    [函数源代码]

设置一系列的事件或某个指定的事件到所有对象.

返回值: [self]

参数:

  • key [必需参数] : Object, 事件键/值对或事件关键字.

  • value [可选参数] : Object, 事件函数.

^

setPropBinder ( value,force,tag,tag2 )

设置控件的附属性绑定配置

返回值: [self]

参数:

  • value [必需参数] : Object.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

^

setProperties ( key,value,force )    [函数源代码]

设置一系列的属性或某个指定的属性到所有对象.

返回值: [self]

参数:

  • key [必需参数] : Object/String, 属性键/值对或属性关键字.

  • value [可选参数] : Object, 属性值.

^

setTag ( value,force,tag,tag2 )

设置控件的附加值.

返回值: [self]

参数:

  • value [必需参数] : String.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var id = 'xui.temp.ui41'

  2. if( ! xui.Dom.byId(id)){ 

  3.     this.prepend(xui.create('<div id=' + id + ' style="border:solid 1px;padding:20px;position:relative;height:100px;width:300px;">' + '<button style="position:absolute; bottom:0px; z-index:2;" onclick="xui(this).parent().remove()">remove this example</button>' + '</div>')); 

  4.     var btn; 

  5.     xui(id).prepend(btn = new xui.UI.Button); 

  6.     _.asyRun(function(){ 

  7.         btn.setTag('tag'); 

  8.         alert(btn.getTag()) 

  9.     },1000

  10. }

 

^

setTagVar ( value,force,tag,tag2 )

设置控件的附加对象.

返回值: [self]

参数:

  • value [必需参数] : Object.

  • force [可选参数] : Boolean, 强制设置该属性值,即使属性已经设置为该值. 默认为 [false].

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var id = 'xui.temp.ui43'

  2. if( ! xui.Dom.byId(id)){ 

  3.     this.prepend(xui.create('<div id=' + id + ' style="border:solid 1px;padding:20px;position:relative;height:100px;width:300px;">' + '<button style="position:absolute; bottom:0px; z-index:2;" onclick="xui(this).parent().remove()">remove this example</button>' + '</div>')); 

  4.     var btn; 

  5.     xui(id).prepend(btn = new xui.UI.Button); 

  6.     _.asyRun(function(){ 

  7.         btn.setTagVar([1,2]); 

  8.         alert(btn.getTagVar()) 

  9.     },1000

  10. }

 

^

继承自 xui.absBox

each    get    isEmpty    merge    reBoxing    size    

each ( fun,scope,desc )    [函数源代码]

将函数应用于数组中的每一个箱内元素.

返回值: [self]

参数:

  • fun [必需参数] : Function, [this]指针是 xui.absBox Object, 函数参数: [element, array index]. 应用到每一个箱内元素的函数.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. xui(['xui.UI.Layout:a:','btnLang']).each(function(o, i){ 

  2.     alert(i + ' -> #' + o.id) 

  3. })

 

^

get ( index )    [函数源代码]

根据给定位置得到箱内元素,或者得到箱内所有元素.

返回值: Object/Array

参数:

  • index [可选参数] : Number.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var n = xui(['xui.UI.Layout:a:','btnLang']); 

  2. alert(n.get(1).id); 

  3. alert(n.get()[0].id + ' , ' + n.get()[1].id);

 

^

isEmpty ( )    [函数源代码]

是否目前的箱为空.

返回值: Boolean.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. var n = xui(['xui.UI.Layout:a:','btnLang']); 

  2. alert(n.isEmpty()); 

  3. alert(xui().isEmpty())

 

^

merge ( obj )    [函数源代码]

合并一个箱的所有元素到当前箱.

返回值: [self].

参数:

  • obj [必需参数] : xui.absBox 对象

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. alert(xui('xui.UI.Layout:a:').merge(xui('btnLang')).get().length)

 

^

reBoxing ( key,ensureValue )    [函数源代码]

将当前箱内的所有元素重新打包到另一个箱.

参数:

  • key [可选参数] : new xui.absBox 子类的名字.

  • ensureValue [可选参数] : Boolean, 是否强制检测每个箱内元素值的有效性. 默认为 true.

示例:

- 代码运行js文件 多比手机组态云平台API代码查看器 - 官网

  1. alert(xui('xui.UI.Layout:a:').KEY); 

  2. alert(xui('xui.UI.Layout:a:').reBoxing('xui.UI.Layout').KEY);

 

^

size ( )    [函数源代码]

得到箱内元素的个数.

返回值: Number

^

事件

Events

afterInvoke    afterRead    afterUpdateDataFromUI    afterWrite    beforeInvoke    beforeRead    beforeUpdateDataToUI    beforeWrite    onData    onError    

afterInvoke ( profile,rspData,requestId )

在invoke之后调用.

参数:

  • profile : xui.Profile.

  • rspData : Object, 从远程调用返回的数据

  • requestId : String

^

afterRead ( profile,rspData,requestId )

在read之后调用.

参数:

  • profile : xui.Profile.

  • rspData : Object, 从远程调用返回的数据

  • requestId : String

^

afterUpdateDataFromUI ( profile,dataFromUI )

在updateDataFromUI函数从得到UI数据后被调用,用来调整数据对象. 本事件可以返回调整后的数据对象.

返回值: Object

参数:

  • profile : xui.Profile.

  • dataFromUI : Object, 从UI得到的数据对象.

^

afterWrite ( profile,rspData,requestId )

在write之后调用.

参数:

  • profile : xui.Profile.

  • rspData : Object, 从远程调用返回的数据

  • requestId : String

^

beforeInvoke ( profile,requestId )

在invoke之前调用. 返回false可以阻止远程调用.

返回值: Object

参数:

  • profile : xui.Profile.

  • requestId : String

^

beforeRead ( profile,requestId )

在read之前调用. 返回false可以阻止远程调用.

参数:

  • profile : xui.Profile.

  • requestId : String

^

beforeUpdateDataToUI ( profile,dataToUI )

在updateDataToUI函数设置数据到UI前被调用,用来调整数据对象. 本事件可以返回调整后的数据对象.

返回值: Object

参数:

  • profile : xui.Profile.

  • dataToUI : Object, 即将设置到UI的数据对象.

^

beforeWrite ( profile,requestId )

在write之前调用. 返回false可以阻止远程调用.

参数:

  • profile : xui.Profile.

  • requestId : String

^

onData ( profile,rspData,requestId )

在得到数据之后调用.

参数:

  • profile : xui.Profile.

  • rspData : Object, 从远程调用返回的数据

  • requestId : String

^

onError ( profile,rspData,requestId )

在出现错误后调用.

参数:

  • profile : xui.Profile.

  • rspData : Object, 从远程调用返回的数据

  • requestId : String


上一篇 下一篇

评论



分享