# 下载安装方式配置
# 关于 SCSS
uView Pro 依赖 SCSS,您必须要安装此插件,否则无法正常运行。
- 如果您的项目是由
HBuilder X
创建的,相信已经安装 scss 插件,如果没有,请在 HX 菜单的 工具->插件安装中找到"scss/sass 编译"插件进行安装, 如不生效,重启 HX 即可 - 如果您的项目是由
vue-cli
创建的,请通过以下命令安装对 sass(scss)的支持,如果已安装,请略过。
// 安装sass
npm i sass -D
// 安装sass-loader
npm i sass-loader -D
# 准备工作
在进行配置之前,请确保您已经根据安装中的步骤对 uView Pro 进行了下载安装,如果没有,请先下载安装。
# 配置步骤
# 1. 引入 uView 主库
在项目根目录中的main.ts
中,引入并使用 uView Pro 的工具库,注意这两行要放在import Vue
之后。
// main.ts
import { createSSRApp } from "vue";
import uViewPro from "uview-pro";
export function createApp() {
const app = createSSRApp(App);
app.use(uViewPro);
// 其他配置
return {
app,
};
}
# 2. 在引入 uView Pro 的全局 SCSS 主题文件
在项目根目录的uni.scss
中引入此文件。
/* uni.scss */
@import "uview-pro/theme.scss";
# 3. 引入 uView Pro 基础样式
注意!
在App.vue
中首行的位置引入,注意给 style 标签加入 lang="scss"属性
<style lang="scss">
/* 注意要写在第一行,同时给style标签加入lang="scss"属性 */
@import "uview-pro/index.scss";
</style>
# 4. 配置 easycom 组件模式
此配置需要在项目根目录的pages.json
中进行。
温馨提示
- uni-app 为了调试性能的原因,修改
easycom
规则不会实时生效,配置完后,您需要重启 HX 或者重新编译项目才能正常使用 uView 的功能。 - 请确保您的
pages.json
中只有一个easycom
字段,否则请自行合并多个引入规则。
// pages.json
{
"easycom": {
"^u-(.*)": "@/uview-pro/components/u-$1/u-$1.vue"
},
// 此为本身已有的内容
"pages": [
// ......
]
}