uView Pro

# npm 安装方式配置

# 准备工作

在进行配置之前，请确保您已经根据安装中的步骤对 uView 进行了 npm 安装，如果没有，请先执行安装：

// 如果您的项目是HX创建的，根目录又没有package.json文件的话，请先执行如下命令：
// npm init -y

// npm 安装
npm install uview-pro
// yarn 安装
yarn add uview-pro
// pnpm 安装
pnpm add uview-pro

# 配置步骤

# 1. 引入 uView 主库

在项目根目录中的main.ts中，引入并使用 uView 的工具库，注意这两行要放在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 的全局 SCSS 主题文件

在项目根目录的uni.scss中引入此文件。

/* uni.scss */
@import "uview-pro/theme.scss";

# 3. 引入 uView 基础样式

注意！

在App.vue中首行的位置引入，注意给 style 标签加入 lang="scss"属性

<style lang="scss">
	/* 注意要写在第一行，同时给style标签加入lang="scss"属性 */
	@import "uview-pro/index.scss";
</style>

# 4. 配置 easycom 组件模式

此配置需要在项目根目录的pages.json中进行。

温馨提示

  1. uni-app 为了调试性能的原因，修改easycom规则不会实时生效，配置完后，您需要重启 HX 或者重新编译项目才能正常使用 uView 的功能。
  2. 请确保您的pages.json中只有一个easycom字段，否则请自行合并多个引入规则。
// pages.json
{
  "easycom": {
    "^u-(.*)": "uview-pro/components/u-$1/u-$1.vue"
  },

  // 此为本身已有的内容
  "pages": [
    // ......
  ]
}