在w页面中,组件是构成页面的基本元素。在平台提供的组件中,都继承自component。
目录
一. 综述
组件是构成页面的基本元素,而平台的组件都继承自component类,所以所有的组件都有一些相同的特性,比如属性xid,方法set,get等。
二. 属性
组件的属性分为设计时属性和运行时属性,设计时属性只能在设计时设置,不能在运行时设置;运行时属性可以在运行时使用set方法设置。
- xid
- class
组件样式,设置组件的展现样式
- bind-visible
visible绑定(bind-visible)可以绑定可监控对象来动态控制元素是否在页面中显示。bind-visible也可以绑定复杂的表达式来控制元素是否显示,参考visible绑定
- bind-css
css绑定(bind-css)为元素添加或删除class,从而改变元素的样式。css绑定非常有用,可以根据数据动态改变元素的样式,比如负值用红色来显示。另外还有一种更直接的改变样式的方法,即通过style绑定,参考css绑定
- bind-style
用于动态定义HTML标签的样式,参考style绑定
- bind-enable,bind-disable,bind-hasFocus
参考数据绑定
- bind-foreach,bind-if,bind-ifnot,bind-with
参考数据绑定
- bind-html
html绑定(bind-html)将在界面中添加特定的html元素,如果要在界面中动态添加html元素,则需要使用html绑定,参考html绑定
- bind-value,bind-checked
参考数据绑定
- bind-text
text绑定(bind-text)用来控制页面元素显示的文本内容,常用在<span>、<em>等元素中,当然也可以用于其它任何元素,参考text绑定
三. 方法
- set
void set (object arg)
设置组件运行时属性的值(设计时属性不能使用此方法),支持set(name,val)和set(object arg)两种形式,前者一般用于设置单个属性值,后者用于批量设置属性值。
> 参数
arg:[object]属性值对
> 返回值
void
> 例:
//设置多个属性值 this.comp(contents).set({ "slidable":true, "wrap" : true, "swipe" : false }); //设置单个属性值 this.comp("contents").set("wrap" , true);
- get
object get(name)
获取组件的属性值,此处注意:xid不能get
> 参数
name:[string]要获取的属性名
> 返回值
object
> 例:
//获取content的wrap属性值 var wrapVal = this.comp(contents).get("wrap");
- on
void on(ename,fn,scope,options)
添加事件处理器
> 参数
ename:[string]事件名称
fn:[function]事件处理器
scope:[object]调用事件处理器时的执行上下文this
options:[object]选项
> 返回值
void
> 例:
this.comp("button1").on("onClick", function(event) { alert(event.source.get('label')); });
- off
void off(ename,fn,scope)
取消事件处理器
> 参数
ename:[string]事件名称
fn:[function]事件处理器
scope:[object]调用事件处理器时的执行上下文this
> 返回值
void
> 例:
//取消button事件 this.comp("button1").off("onClick");
本文由WeX5君整理,WeX5一款开源免费的html5开发工具,H5 App开发就用WeX5!
阅读其他app 开发相关文章:http://doc.wex5.com/?p=3443
评一波