|
配置属性
静态成员中最重要的就是ATTRS，其中列出了你的类所需的所有配置参数。例如你需要一个名为value的成员，这个成员用于保存一个数字，默认初始值为0，可以这样传入第五个参数。 ATTRS: {
value: {
value: 0,
validator: Lang.isNumber
}
}
ATTRS中当然可以写入多个成员，每个成员都下辖各自的配置项，通过阅读addAttr()来了解更多参数配置。我们看到，validator使用了之前代码中定义的缩写Lang，验证函数得到一个实参的输入，返回一个布尔值，所有的Y.Lang.isXxxx都可以作为校验函数，当然，为了更严格细致的校验，你可能需要定义新的validator、setter和getter，这里推荐使用字符串作为句柄赋值给validator、setter或者getter，Attribute会将字符串对应到具体的函数。比如要定义一个validCodes属性，可以接收单个值或者一个数组，但应当统一返回一个数组： ATTRS: {
validCodes: {
setter: ‘_setValidCodes’
}
}
我们需要在Y.Base.create()的第四个参数中声明_setValidCodes方法，其他的成员也可以在这里追加声明。 _setValidCodes: function (value) {
if (!Lang.isArray(value)) {
value = [ value ];
}
return value;
}
除非函数足够简单，最好单独重写setter、setter和validator，传入他们的函数名作为实参，让Attribute将函数名对应到真实的函数。
总之，使用setter作为标准输入，这样会为组件带来一些非常有用的特性。比如配置项值的改变会触发beforeChange和afterChange事件，如果在beforeChange事件中停止事件，则可以阻止属性的更改，因此组件实例生成后，请善用自定义事件。比如你如果绑定了afterChange事件，如果触发了回调，那么一定是值被改变了，而不是即便试图更改属性值却在beforeChange中被阻止了。
validator和setter的校验强度是你来决定的，如果你的validator的校验逻辑很严格，就不用再在setter中添加严格的校验，甚至不需要setter，反之亦然，setter校验很严格的话也可以缺省validator。比如，下面两句代码，你可以任选其一： validator: Y.Lang.isBoolean, // to make the attribute accepts strictly a Boolean
setter: Boolean, // to make the attribute accept any value and have Boolean
Setter也可以作为校验器来使用。如果输入的值不能转换成attribute可接受的值，setter就会返回Y.Attribute.INVALID_VALUE。这种情况下，attribute不会发生改变。
当我定义成员的时候，通常会指定这个常量，并放在模块的顶部（和CBX， BBX这些缩写声明一起），例如： var VALUE = ‘value’,
VALID_CODES = ‘validCodes’;
这样做的原因是，在一个模块内可能会多次用到这个值，使用常量更加方便。但是，请千万别在属性声明中使用这些常量。 ATTRS: {
// *** Don’t do this *** //
VALUE: {
value: 0,
validator: Lang.isNumber
}
}
这样书写会生成一个名为VALUE而不是value的属性成员，同时记住，不要覆盖基类中的属性成员，Widget中已经有许多属性成员（见表格），如boundingBox、visible、disabled、height、width等，你也可以修改他们，Y.Base.create()会将父类和基类(Base)中的属性成员合并，所以要重载已有的属性成员，你只要在派生类中重复定义即可。
当你要定义的属性成员是数组或者对象的时候要尤为小心，对象（数组）是一个引用值，如果初始化的属性中含有object，他们(所有实例的这个成员)指向的会是同一个object。当你更改这个object或者删除的时候，所有的实例也都跟着改变(prototye永远指向父类的prototye)，所以，Base提供了克隆的机制，在你传入object属性成员的时候克隆一份，这会避免引用重复的问题，其他objects的初始化，请使用valueFn参数，或者直接在类的构造函数（initialize）中构建他们。
出处：Taobao.com UED Team
责任编辑：bluehearts
上一页 使用YUI 3开发Web应用的诀窍 [2] 下一页 使用YUI 3开发Web应用的诀窍 [4]
◎进入论坛网页制作、WEB标准化版块参加讨论，我还想发表评论。
|
第 1 页 
第 3 页 使用YUI 3开发Web应用的诀窍 [3]
