在w页面中,组件是构成页面的基本元素。在平台提供的组件中,都继承自component。

目录

一、综述
二、属性
三、方法

一. 综述

组件是构成页面的基本元素,而平台的组件都继承自component类,所以所有的组件都有一些相同的特性,比如属性xid,方法set,get等。

二. 属性

组件的属性分为设计时属性和运行时属性,设计时属性只能在设计时设置,不能在运行时设置;运行时属性可以在运行时使用set方法设置。

  • xid
[string] 组件id,基于是单页模式,不能设置id属性,必须使用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