uView UI 是一个基于 uni-app 的高质量 UI 组件库,提供丰富的跨平台组件(支持 H5、小程序、App 等)。以下是其核心组件的分类大全及功能说明,结合最新版本(1.2.10)整理:
按钮 (Button)
支持主题色、镂空、禁用等样式,可设置 openType
(如微信小程序授权)和回调事件。
图标 (Icon)
内置多种图标,支持自定义颜色、大小、背景色和渐变色。
布局 (Layout)
提供栅格系统(Row/Col),支持响应式布局。
标签 (Tag)
可设置圆角、描边、禁用状态,支持前后插槽和渐变色背景。
输入框 (Input)
支持清除图标、格式校验,修复了内容错位问题。
表单 (Form)
集成校验规则,支持动态添加/删除表单项(需配合 data-cell
组件)。
选择器 (Picker)
时间、日期、地区等多维数据选择。
验证码 (Sms-Code)
短信验证码输入组件,支持倒计时和重发功能。
数据块 (Data-Block)
展示结构化数据,支持背景图、边框、悬停效果和最大宽度限制。
列表 (List)
瀑布流布局,支持分页加载(需搭配 Load-More
组件)。
表格 (Table)
多列数据展示,支持排序和筛选(如 ua-table
)。
标签页 (Tabs)
可滑动切换的内容容器,兼容自定义导航栏。
导航栏 (Navbar)
自定义导航栏,需配合状态栏高度计算(statusBarHeight + navbarHeight
)。
Dock 菜单 (ua-Dock)
毛玻璃底部导航栏,支持图标、徽章和滚动。
状态栏 (Status-Bar)
动态适配不同设备状态栏高度。
顶部提示 (TopTips)
页面顶部滑出提示,支持成功/警告等主题,需在 onReady
生命周期调用。
弹窗 (Popup)
从屏幕边缘弹出内容,支持自定义位置和动画(1.2.9 版本优化)。
操作菜单 (Action-Sheet)
底部弹出选择菜单,支持图标和颜色定制。
加载提示 (Load-More)
分页加载状态提示(如“加载中”“无更多数据”)。
图表 (Charts)
集成 u-charts
库,支持折线图、饼图等。
时间轴 (Timeline)
展示步骤或历史记录。
富文本编辑器 (Rich-Text)
内置编辑器,支持图文混排。
遮罩层 (Overlay)
半透明遮罩,用于弹窗背景(1.2.9 新增)。
依赖安装
npm install uview-ui
# 必须安装 SCSS 插件(HBuilderX 中搜索 "scss/sass 编译")。
全局配置
main.js
引入:import uView from "uview-ui"; Vue.use(uView);
uni.scss
添加:@import 'uview-ui/theme.scss';
App.vue
首行引入:@import "uview-ui/index.scss";
(需 lang="scss"
)。
按需使用
配置 pages.json
的 easycom
规则,无需手动导入组件4:
json
"easycom": { "^u-(.*)": "uview-ui/components/u-$1/u-$1.vue" }
自定义导航栏问题:使用 TopTips
时需传入 navbar-height
(状态栏高度 + 导航栏高度)。
样式覆盖:修改组件样式需用 ::v-deep
并指定父类(兼容小程序)。
包体积优化:发行时自动剔除未使用组件,开发模式体积较大属正常现象。
以上组件均支持 H5、小程序、App 等平台,最新版本详见 uView 更新日志。完整文档可访问 uView 官网