创建自定义组件
一个自定义组件由 json jxml jxss js 4个文件组成。要编写一个自定义组件,首先需要在 json 文件中进行自定义组件声明(将 component 字段设为 true 可这一组文件设为自定义组件):
同时,还要在 jxml 文件中编写组件模版,在 jxss 文件中加入组件样式,它们的写法与页面的写法类似。具体细节和注意事项参见组件模版和样式 。
代码示例:
<view class="inner">
{{msg}}
</view>
<slot></slot>
在自定义组件的 js 文件中,需要使用 Component() 来注册组件,并提供组件的属性定义、内部数据和自定义方法。
组件的属性值和内部数据将被用于组件 jxml 的渲染,其中,属性值是可由组件外部传入的。更多细节参见 Component构造器 。
代码示例:
Component({
properties: {
type: String,
value: 'default value',
}
},
data: {
// 这里是一些组件内部数据
someData: {}
methods: {
customMethod: function(){}
}
})
使用自定义组件
这样,在页面的 jxml 中就可以像使用基础组件一样使用自定义组件。节点名即自定义组件的标签名,节点属性即传递给组件的属性值。
代码示例:
<view>
<!-- 以下是对一个自定义组件的引用 -->
</view>
自定义组件的 jxml 节点结构在与数据结合之后,将被插入到引用位置内。
Tips:
- 因为 JXML 节点标签名只能是小写字母、中划线和下划线的组合,所以自定义组件的标签名也只能包含这些字符。
- 自定义组件也是可以引用自定义组件的,引用方法类似于页面引用自定义组件的方式(使用 usingComponents 字段)。
- 自定义组件和使用自定义组件的页面所在项目根目录名不能以 “jd-” 为前缀,否则会报错。