小程序 – 自定义组件 – 创建与引入

简介

小程序中除了页面，还包含了组件的功能，通过创建和引用组件可以更快速地开发小程序。

创建组件

①在项目的根目录中，鼠标右键，创建 components -> test 文件夹

②在新建的 components -> test 文件夹上，鼠标右键，点击“新建 Component”

③键入组件的名称之后回车，会自动生成组件对应的 4 个文件，后缀名分别为 .js，.json， .wxml 和 .wxss

注意：为了保证目录结构的清晰，建议把不同的组件，存放到单独目录中，例如：

引用组件

组件的引用方式分为“局部引用”和“全局引用”，顾名思义：

局部引用：组件只能在当前被引用的页面内使用

全局引用：组件可以在每个小程序页面中使用

局部引用

在页面的 .json 配置文件中引用组件的方式，叫做“局部引用”。

全局引用

在 app.json 全局配置文件中引用组件的方式，叫做“全局引用”。

引用时机

根据组件的使用频率和范围，来选择合适的引用方式：

如果某组件在多个页面中经常被用到，建议进行“全局引用”

如果某组件只在特定的页面中被用到，建议进行“局部引用”

区别

从表面来看，组件和页面都是由 .js、.json、.wxml 和 .wxss 这四个文件组成的。但是，组件和页面的 .js 与 .json 文件有明显的不同：

组件的 .json 文件中需要声明 "component": true 属性

组件的 .js 文件中调用的是 Component() 函数

组件的事件处理函数需要定义到 methods 节点中

组件样式隔离

默认情况下，自定义组件的样式只对当前组件生效，不会影响到组件之外的 UI 结构，如图所示：

组件 A 的样式不会影响组件 C 的样式

组件 A 的样式不会影响小程序页面的样式

小程序页面的样式不会影响组件 A 和 C 的样式

好处：

① 防止外界的样式影响组件内部的样式

② 防止组件的样式破坏外界的样式

注意

app.wxss 中的全局样式对组件无效

只有 class 选择器会有样式隔离效果，id 选择器、属性选择器、标签选择器不受样式隔离的影响

建议：在组件和引用组件的页面中建议使用 class 选择器，不要使用 id、属性、标签选择器！

修改样式隔离配置

默认情况下，自定义组件的样式隔离特性能够防止组件内外样式互相干扰的问题。但有时，我们希望在外界能够控制组件内部的样式，此时，可以通过 styleIsolation 修改组件的样式隔离选项

styleIsolation 的可选值