自定义组件的事件(如 onTap 等),并不是每个自定义组件默认支持的,需要自定义组件本身明确支持才能使用。自定义组件支持事件具体方法请参见 component 构造器。
使用方法
自定义组件的使用和基础组件类似。
在页面 JSON 文件中指定使用的自定义组件。
// /pages/index/index.json
{
"usingComponents": {
"customer": "/components/customer/index"
}
}
在页面的 AXML 文件中使用自定义组件,与使用基础组件类似。
<!-- /pages/index/index.axml -->
<view>
<!-- 给自定义组件传递 属性name与属性age -->
<customer name="tom" age="{{23}}"/>
</view>
说明:- 使用自定义组件时,给自定义组件传递的属性可以在自定义组件内通过
this.props
获取,参见 props。 - 自定义组件只能在 page 自身的 AXML 文件和组件自身的 AXML 文件中使用,不能通过 import 或 include 使用。
正确示例:
<!-- /pages/index/index.axml -->
<my-com />
错误示例:
<!-- /pages/index/index.axml -->
<include src="./template.axml" />
<!-- /pages/index/template.axml -->
<view>
<my-com />
</view>
引用自定义组件
// 在 /pages/index/index.json 中配置(不是 app.json )
{
"usingComponents":{
"your-custom-component":"mini-antui/es/list/index",
"your-custom-component2":"/components/card/index",
"your-custom-component3":"./result/index",
"your-custom-component4":"../result/index"
}
}
// 项目绝对路径以 / 开头,相对路径以 ./ 或者 ../ 开头
文档内容是否对您有帮助?