开发过小程序组件的应该对这个behaviors有所了解;
behaviors
是用于组件间代码共享的特性,类似于一些编程语言中的 “mixins” 或 “traits”。
每个 behavior
可以包含一组属性、数据、生命周期函数和方法。组件引用它时,它的属性、数据和方法会被合并到组件中,生命周期函数也会在对应时机被调用。 每个组件可以引用多个 behavior
,behavior
也可以引用其它 behavior
。
详细的参数含义和使用请参考 Behavior 参考文档。
组件中使用
组件引用时,在 behaviors
定义段中将它们逐个列出即可。
// my-component.jsvar myBehavior = require('my-behavior')Component({
behaviors: [myBehavior],
properties: {
myProperty: {
type: String }
},
data: {
myData: 'my-component-data'
},
created: function () {
console.log('[my-component] created')
},
attached: function () {
console.log('[my-component] attached')
},
ready: function () {
console.log('[my-component] ready')
},
methods: {
myMethod: function () {
console.log('[my-component] log by myMethod')
},
}})
在上例中, my-component
组件定义中加入了 my-behavior
,
而 my-behavior
结构为:
这将使 my-component
最终结构为:
属性:myBehaviorProperty
、myProperty
数据字段:myBehaviorData
、myData
方法:myBehaviorMethod
、myMethod
生命周期函数:attached
、created
、ready
当组件触发生命周期时,上例生命周期函数执行顺序为:
[my-behavior] created
[my-component] created
[my-behavior] attached
[my-component] attached
[my-behavior] ready
[my-component] ready
详细规则参考 同名字段的覆盖和组合规则。
同名字段的覆盖和组合规则
组件和它引用的 behavior
中可以包含同名的字段,对这些字段的处理方法如下:
代码示例:
在开发者工具中预览效果
内置 behaviors
自定义组件可以通过引用内置的 behavior
来获得内置组件的一些行为。
Component({
behaviors: ['wx://form-field']})
在上例中, wx://form-field
代表一个内置 behavior
,它使得这个自定义组件有类似于表单控件的行为。
内置 behavior
往往会为组件添加一些属性。在没有特殊说明时,组件可以覆盖这些属性来改变它的 type
或添加 observer
。
wx://form-field
使自定义组件有类似于表单控件的行为。 form 组件可以识别这些自定义组件,并在 submit 事件中返回组件的字段名及其对应字段值。
详细用法以及代码示例可见:form 组件参考文档
wx://form-field-group
从基础库版本 2.10.2 开始提供支持。
使 form 组件可以识别到这个自定义组件内部的所有表单控件。
详细用法以及代码示例可见:form 组件参考文档
wx://form-field-button
从基础库版本 2.10.3 开始提供支持。
使 form 组件可以识别到这个自定义组件内部的 button 。如果自定义组件内部有设置了 form-type 的 button ,它将被组件外的 form 接受。
详细用法以及代码示例可见:form 组件参考文档
wx://component-export
从基础库版本 2.2.3 开始提供支持。
使自定义组件支持 export
定义段。这个定义段可以用于指定组件被 selectComponent
调用时的返回值。
详细用法以及代码示例可见:selectComponent 参考文档