uniapp初学时建项目公共组件easycom组件规范定义

本文介绍了在uni-app中创建公共组件的规范,包括组件命名前缀的一致性,如使用'bd-',以及通过pages.json配置easycom组件,特别是HBuilderX 2.5.5及以上版本对uview-ui的支持。遵循components/组件名称/组件名称.vue的目录结构,组件无需显式引用和注册即可直接在页面中使用。

1.首先新建公共组件前缀要保持一致。比如你公司是百度前缀可以使用bd-在这里插入图片描述

2.找到pages.json文件使用easycom组件规范(HBuilderX 2.5.5起支持) 绝对路径引入配置一下就好。下面是引入的uview-ui
在这里插入图片描述
3.只要组件安装在项目的components目录下,并符合components/组件名称/组件名称.vue目录结构。就可以不用引用、注册,直接在页面中使用。不用像传统vue组件import导入
在这里插入图片描述

### 如何在 UniApp 中通过 EasyCom 实现组件的动态加载 #### 什么是 EasyComEasyCom 是一种由 HBuilderX 提供的支持机制,旨在简化自定义组件的引入过程。从版本 **HBuilderX 2.5.5** 开始支持此功能[^1]。它允许开发人员无需显式导入和注册即可直接使用符合特定命名约定的组件。 #### 配置 `pages.json` 支持 EasyCom 为了启用 EasyCom 模式,在项目的全局配置文件 `manifest.json` 或页面级配置文件 `pages.json` 中设置如下字段: ```json { "easycom": { "autoscan": true, "path": "components" } } ``` 上述配置表示自动扫描位于项目根目录下的 `components` 文件夹中的所有子文件夹,并将其作为可使用的组件[^3]。如果需要更灵活地控制哪些路径被纳入 EasyCom 扫描范围,则可以指定具体的路径列表替代 `"autoscan"` 的布尔值形式。 #### 组件命名规范 要使某个 Vue 单文件组件能够参与 EasyCom 自动化流程,其所在目录名需与该 `.vue` 文件同名。例如,假设存在这样一个结构化的组件: ``` /components/ my-button/ index.vue ``` 那么可以直接在模板中这样调用而不需要额外声明: ```html <template> <view> <!-- 动态加载 --> <my-button></my-button> </view> </template> ``` #### 动态加载的实际应用案例 下面是一个完整的例子展示如何利用 EasyCom 来实现按条件渲染不同类型的按钮组件: ```javascript // pages/example/example.vue <template> <view> <component :is="currentComponent"></component> </view> </template> <script> export default { data() { return { currentComponent: 'my-button' // 可切换为其他已知组件名称字符串 }; }, }; </script> ``` 在此示例中,`:is` 属性绑定到变量 `currentComponent` 上,这使得我们可以轻松更改显示的具体组件实例而不必修改 HTML 结构本身[^2]。 --- #### 注意事项 尽管 EasyCom 极大地提高了工作效率并减少了冗余代码量,但在实际操作过程中仍需要注意以下几点: - 确保所有的目标组件都遵循统一的标准命名方式; - 如果某些特殊场景下无法满足默认规则的要求,可能还需要回退至传统手动注册手段处理例外情况。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值