YUI之Attribute类
Attribute类用于向一个类添加属性,它给类增加了set和get函数用于操作属性值,同时还支持change事件以便监视属性的变化,此外,还可以自定义属性的setter、getter和校验方法,可以定义属性为只读或者一次写(write-once)
1. 要使用Attribute,首先要引入YUI3的种子文件:
然后加载相应模块:
2. Attribute类是用来扩张一个既存的类,使其具有属性管理功能的,以下是将MyClass扩张
的示例代码:
3. 增加属性
一旦一个类扩张了Attribute功能,就可以使用addAttrs批量添加属性,或者使用addAttr一个一个地添加属性,以下是批量添加的例子:
可以在new这个类或者new之后用set方法对属性赋值:
4. 属性配置属性(Attribute configuration properties)
可以对属性(Attribute)进行配置的属性(properties)参见下表,所有属性都是可选的,也是
大小写敏感的:
value: 默认值
valueFn:函数。返回值会被作为属性的值
getter:函数
setter:函数
validator:函数。在setter前被调用,用来校验数据
readOnly:布尔值
writeOnce:布尔值。0-不广播;1-广播到YUI实例;2-广播到YUI实例和YUI global
lazyAdd:布尔值
cloneDefaultValue:可以为"shallow", "deep", true, false。仅在Base的ATTRS中使用。
以下是在addAttr中使用的例子: 5. 属性变化事件
属性变化事件是一种用户自定义事件,其类型为"[attributeName]Change",例如定义了一个
属性"attrA",那么它的变化事件就是"attrAChange"。
定义事件监听器时可以使用两种方法:on和after。其中用on注册的监听器在变化发生前调用,
我们可以在这里检查数据的合法性,并用Event的preventDefault()方法拒绝对属性的修改。而
用after注册的监听器在事件发生后调用。
以下是对属性"enabled"定义变化事件监听器的示例代码:
事件监听器的第一个参数是以Event对象,它具有以下的属性和方法:
newVal
prevVal
attrName
subAttrName
preventDefault()
stopImmediatePropagation():可以在on和after监听器中使用,用于停止事件在监听器栈中的传播
转自:http://blog.sina.com.cn/s/blog_632d19d50100rzuq.html