uni-app 使用 uview-plus

uview-plus 是一个基于 uni-app 的高质量 UI 组件库,提供了丰富的组件和工具函数,帮助开发者快速构建跨平台应用。

1. 安装 uview-plus

在项目中安装 uview-plus

bash 复制代码
pnpm add uview-plus

2. 使用 easycom 方式引入组件

在本项目中,uview-plus 是通过 easycom 的方式按需引入组件的。以下是具体使用方法:

2.1 配置组件路径

pages.json 中配置 easycom 规则:

json 复制代码
{
  "easycom": {
    "autoscan": true,
    "custom": {
      "^u-(.*)": "uview-plus/components/u-$1/u-$1.vue",
      "^up-(.*)": "uview-plus/components/u-$1/u-$1.vue"
    }
  }
}

说明:

  • autoscan: 设置为 true,自动扫描 node_modules/uview-plus/components 目录下的组件。
  • custom: 自定义组件匹配规则,^u-(.*)^up-(.*) 表示以 u-up- 开头的组件名会匹配到 uview-plus 的对应组件路径。

2.2 使用组件

配置完成后,可以直接在页面中使用 uview-plus 的组件,无需手动引入。例如:

vue 复制代码
<template>
  <view>
    <u-button type="primary">主要按钮</u-button>
    <up-button type="success">成功按钮</up-button>
  </view>
</template>

3. 自定义主题

uview-plus 支持通过 SCSS 变量自定义主题。以下是推荐的自定义主题方案:

3.1 创建自定义主题文件

在项目的 src/styles 目录下新建一个 uview-plus.theme.scss 文件,并将 node_modules/uview-plus/theme.scss 中的所有变量复制到该文件中。例如:

scss 复制代码
$u-primary: #007aff; // 修改主色
$u-success: #4cd964; // 修改成功色
$u-warning: #f0ad4e; // 修改警告色
$u-error: #dd524d; // 修改错误色
// 其他变量...

根据需求修改这些变量的值,以实现自定义主题。

3.2 引入自定义主题文件

src/uni.scss 文件的顶部引入自定义主题文件:

scss 复制代码
@import '@/styles/uview-plus.theme.scss';

通过这种方式,uview-plus 的组件将使用自定义的主题变量。

相关推荐
AI砖家4 分钟前
前端 JavaScript 异步处理全方案详解:从回调到 Observable
开发语言·前端·javascript
用户713874229009 分钟前
构建现代 Web 应用的令牌安全体系:Refresh Token Rotation、HttpOnly Cookie 与 Grace Period 全解析
前端
之歆26 分钟前
Day21_电商详情页核心技术实战:从LESS预处理到复杂交互实现
开发语言·前端·javascript·css·交互·less
海鸥两三36 分钟前
基于 Vue 3 + 高德地图的网格规划系统实战(有源码)
前端·javascript·vue.js
丷丩1 小时前
MapLibre GL JS第11课:获取鼠标指针坐标
前端·javascript·gis·地图·mapbox·maplibre gl js
代码AI弗森1 小时前
前端周刊第 467 期[特殊字符] 本期精选目录
前端
随便的名字1 小时前
前端路由的底层逻辑:URL 中 # 和 ? 的区别与关系详解
前端
kongba0071 小时前
ttyd Web终端安装指南(OpenCloudOS 9)
linux·前端
zhoumeina991 小时前
前端串行合成流程 + 每张图上传接口
前端·状态模式
风骏时光牛马1 小时前
Swift 基于MVVM架构实现完整列表数据展示与交互功能实战案例
前端