自定义组件可以通过引用内置的 behavior
来获得内置组件的一些行为。
代码示例:
Component({
behaviors: ['wx://form-field']
})
在上例中, wx://form-field
代表一个内置 behavior
,它使得这个自定义组件有类似于表单控件的行为。
内置 behavior
往往会为组件添加一些属性。在没有特殊说明时,组件可以覆盖这些属性来改变它的 type
或添加 observer
。
使自定义组件有类似于表单控件的行为。 form 组件可以识别这些自定义组件,并在 submit 事件中返回组件的字段名及其对应字段值。这将为它添加以下两个属性。
属性名 | 类型 | 描述 | 最低版本 |
---|---|---|---|
name | String | 在表单中的字段名 | 1.6.7 |
value | 任意 | 在表单中的字段值 | 1.6.7 |
在开发者工具中预览效果
从基础库版本 2.2.3 开始提供支持。
使自定义组件支持 export
定义段。这个定义段可以用于指定组件被 selectComponent
调用时的返回值。
未使用这个定义段时, selectComponent
将返回自定义组件的 this
(插件的自定义组件将返回 null
)。使用这个定义段时,将以这个定义段的函数返回值代替。
代码示例:
// 自定义组件 my-component 内部
Component({
behaviors: ['wx://component-export'],
export() {
return {myField: 'myValue'}
}
})
<!-- 使用自定义组件时 -->
<my-component id="the-id" />
this.selectComponent('#the-id') // 等于 { myField: 'myValue' }