codecamp

支付宝小程序框架 自定义组件·使用

注意:自定义组件的事件(如 onTap 等),并不是每个自定义组件默认支持的,需要自定义组件本身明确支持才能使用。

自定义组件的使用和基础组件类似。

1、在页面 JSON 文件中指定使用的自定义组件。

// /pages/index/index.json
{
  "usingComponents": {
    "my-component": "/components/index/index"
  }
}

2、在页面的 AXML 文件中使用自定义组件,与使用基础组件类似。

<!-- /pages/index/index.axml -->
<view>
  <!-- 给自定义组件传递 属性name与属性age -->
  <my-component name="tom" age="{{23}}"/>
</view>

注意:

  1. 使用自定义组件时,给自定义组件传递的属性可以在自定义组件内通过 this.props 获取,参见 props
  2. 自定义组件只能在 page 自身的 AXML 文件和组件自身的 AXML 文件中使用,不能通过 import 或 include 使用。

正确示例:

<!-- /pages/index/index.axml -->
<my-component />

错误示例:

<!-- /pages/index/index.axml -->
<include src="./template.axml" />


<!-- /pages/index/template.axml -->
<view>
  HI, template
</view>

引用自定义组件

// 在 /pages/index/index.json 中配置(不是 app.json )
{
  "usingComponents":{
    "your-custom-component":"mini-ali-ui/es/list/index",
    "your-custom-component2":"/components/card/index",
    "your-custom-component3":"./result/index",
    "your-custom-component4":"../result/index"
  }
}
// 项目绝对路径以 / 开头,相对路径以 ./ 或者 ../ 开头
支付宝小程序框架 自定义组件·ref获取组件实例
支付宝小程序框架 自定义组件·发布
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

支付宝小程序开发文档

支付宝小程序 快速示例

支付宝小程序 小程序快速示例

支付宝小程序 框架

支付宝小程序 组件

支付宝小程序组件 基础组件

支付宝小程序组件 无障碍访问

支付宝小程序 扩展组件

支付宝小程序扩展组件 UI组件

支付宝小程序 API

支付宝小程序 开发工具

支付宝小程序 云服务

支付宝小程序 Serverless

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }