开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
开发 > 框架 > 自定义组件 > 自定义组件介绍
贡献者
收藏
订阅更新
我的文档
设置
自定义组件功能可将需要复用的功能模块抽象成自定义组件,从而在不同页面中复用,更可以将自定义组件发布到 npm 上,从而在不同小程序中进行复用,npm 的使用可查看 npm 包管理
使用须知
小程序基础库1.7.0 版本开始支持自定义组件功能。 通过调用 my.caniuse('component') 可判断自定义组件功能是否可在当前版本使用;从 1.14.0 版本开始,自定义组件有了较大改动,支持 component2 相关功能,通过调用 my.caniuse('component2') 可判断新自定义组件功能是否可在当前版本使用,component2 相关功能如下:
新增 oninitderivedatafromprops 生命周期函数
支持使用 ref 获取自定义组件实例
使用 component2 的相关功能,需要在 ide 中的 详情 > 项目配置 中,勾选 启用 component2 编译

创建并使用自定义组件
与 page 类似,自定义组件也由 axmljsjsonacss 四个部分组成。
创建并使用自定义组件有以下 4 个步骤:
1新建自定义组件文件夹。
2.json 文件中声明自定义组件。
3使用 component 函数,注册自定义组件。
4使用自定义组件。
以下讲述如何创建最基本的自定义组件。
新建自定义组件文件夹
打开一个现有项目中(或者在 ide 中,新建一个官方提供的 blank 项目),在 ide 左侧文件树先新建一个 components 文件夹,用于存放所有组件,文件夹名字可以任意修改。在 components 文件夹的右击菜单中,选择新建小程序组件,输入组件名(例如 index,以下示例均以组件名 index 为例),ide 会自动生成自定义组件所需的几个文件,如下所示:



声明自定义组件
组件配置文件 index.json 用于声明当前目录是个自定义组件。
注册自定义组件
组件注册  index.js 用于注册一个组件对象。
组件模板 index.axml 和组件样式 index.acss(可选):定义组件模板和样式。其中,样式文件可选。
使用自定义组件
声明好一个组件后,即可在其它页面上使用。
先在页面配置中说明要使用哪个自定义组件,主要指定组件标签名字和组件所在路径。
然后在页面中引用组件即可。
相关文档
npm 包管理
生命周期
ref 获取组件实例
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图