From 6b7b1e98c8e7e50e590db6a9a121b89f1462db6b Mon Sep 17 00:00:00 2001 From: wanganxp Date: Sun, 19 Jan 2020 18:43:01 +0800 Subject: [PATCH] Update pages.md --- docs/collocation/pages.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/docs/collocation/pages.md b/docs/collocation/pages.md index bde4bed809..7bb12ea976 100644 --- a/docs/collocation/pages.md +++ b/docs/collocation/pages.md @@ -663,29 +663,36 @@ h5 平台下拉刷新动画，只有 circle 类型。 - A：参考[导航栏开发指南](http://ask.dcloud.net.cn/article/34921) # easycom -自`HBuilderX 2.5.5`起支持`easycom`组件模式，简化组件使用。无需在页面里引入和注册组件，打包时会自动剔除没有使用的组件。可以在`HBuilderX 2.5.5`及以上版本新建`uni-ui`项目体验。`easycom`的`autoscan`默认为开启状态，如果需要配置`easycom`请在`pages.json`内修改`easycom`字段。 +传统vue组件，需要安装、引用、注册，三个步骤后才能使用组件。`easycom`将其精简为一步。只要组件安装下项目的components目录下，并符合一定规则。就可以不用引用、注册，直接在页面中使用。同时打包后会自动剔除没有使用的组件。 + +自`HBuilderX 2.5.5`起支持`easycom`组件模式。可以在HBuilderX新建项目界面选择`uni-ui`项目模板体验。只需在页面中敲u，拉出大量代码块，直接选择，即可使用。大幅提升开发效率，降低使用门槛。 + +在[uni-app插件市场](https://ext.dcloud.net.cn/)下载符合规则的组件后，也可以直接使用。 + +`easycom`是自动开启的，可以在`pages.json`的`easycom`节点进行个性化设置。 |属性 |类型 |默认值 |描述 | |:- |:- |:- |:- | |autoscan |Boolean|true |是否开启自动扫描，开启后将会自动扫描符合`components/组件名称/组件名称.vue`目录结构的组件 | |custom |Object |- |以正则方式自定义组件匹配规则。如果`autoscan`不能满足需求，可以使用`custom`自定义匹配规则 | -**使用示例** +**使用示例** ``` -"easycom": { - "autoscan": true, +"easycom": { + "autoscan": true, "custom": { - "uni-(.*)": "@/components/uni-$1.vue" + "uni-(.*)": "@/components/uni-$1.vue" } } ``` -**说明** +**说明** - `easycom`方式引入的组件无需在页面内`import`，也不需要在`components`内声明，即可在任意页面使用 - `easycom`方式引入组件不是全局引入，而是局部引入。例如在H5端只有加载相应页面才会加载使用的组件 - 在组件名完全一致的情况下，`easycom`引入的优先级低于手动引入（区分连字符形式与驼峰形式） - 考虑到编译速度，直接在`pages.json`内修改`easycom`不会触发重新编译，需要改动页面内容触发。 +- `easycom`只处理vue组件，不处理小程序组件 # tabBar 如果应用是一个多 tab 应用，可以通过 tabBar 配置项指定 tab 栏的表现，以及 tab 切换时显示的对应页。 -- GitLab