Advertisement

微信小程序 自定义组件

阅读量:

1. 微信小程序 自定义组件

微信小程序支持组件化开发,这有助于我们复用代码,提高开发效率。下面我将给出一个简单的微信小程序组件化示例,包括一个自定义组件的创建和使用。
在这里插入图片描述

1.1. 创建自定义组件

首先,在项目的 components 目录下创建一个新的组件文件夹,比如命名为 my-component。在该文件夹内,至少包含三个文件:my-component.js(组件的逻辑)、my-component.json(组件的配置文件)、my-component.wxml(组件的结构)、my-component.wxss(组件的样式)。
在这里插入图片描述

1.1.1. my-component.json

配置文件声明了这是一个组件。

复制代码
    {  
      "component": true,  
      "usingComponents": {}  
    }
    
    
    javascript
    
    

1.1.2. my-component.wxml

组件的模板,它包含一个文本节点,文本内容通过数据绑定从组件的JS文件中获取.

复制代码
    <view class="inner">  
      <text>{{text}}</text>  
    </view>
    
    
    javascript
    
    

1.1.3. my-component.wxss

组件的样式文件。

复制代码
    .inner {  
      padding: 20rpx;  
      border: 1px solid #ccc;  
      margin-top: 10rpx;  
    }
    
    
    javascript
    
    

1.1.4. my-component.js

组件的样式文件。

复制代码
    Component({  
      properties: {  
    // 这里定义了组件的外部属性  
    text: {  
      type: String,  
      value: 'Hello, this is a custom component!'  
    }  
      },  
      methods: {  
    // 这里定义组件的方法  
    // 示例:无  
      }  
    })
    
    
    javascript
    
    
![](https://ad.itadn.com/c/weblog/blog-img/images/2025-08-16/lT3LDSJpRGYv5wQeXAMW9c26Cf0g.png)

1.2. 在页面中使用自定义组件

在页面的 JSON 配置文件中声明组件

1.2.1. customView.json

首先,在需要使用该组件的页面的 JSON 配置文件中,声明组件。比如,在 pages/customView/customView.json 中:

复制代码
    {  
      "backgroundColor": "#f6f6f6",
      "navigationBarBackgroundColor": "#3691FB",
      "navigationBarTitleText": "自定义组件",
      "enablePullDownRefresh": true,
      "usingComponents": {  
    "my-component": "../../component/my-component/my-component"  
      }  
    }
    
    
    javascript
    
    

1.2.2. customView.wxml

在页面的 WXML 文件中使用组件
然后,在该页面的 WXML 文件中,就可以像使用基础组件一样使用自定义组件了。比如,在 pages/customView/customView.wxml 中:

复制代码
    <view>  
      <my-component text="你好,我是自组件"></my-component>  
    </view>
    
    
    javascript
    
    

这里,我们给 my-component 组件的 text 属性传递了一个新的值 “Hello, this is a test!”。

1.2.3. customView.wxml 预览和调试

完成上述步骤后,你就可以在微信开发者工具中预览和调试你的小程序了。如果一切正常,你应该能在页面上看到由 my-component 组件渲染的文本内容。
这就是微信小程序组件化的一个基本示例。通过组件化,你可以将复杂的页面拆分成多个可复用的组件,从而提高开发效率和代码的可维护性。

全部评论 (0)

还没有任何评论哟~