uniapp viewui
uniapp 集成 ViewUI(View Design)
ViewUI(原 iView)是一款基于 Vue.js 的高质量 UI 组件库。在 uniapp 中集成 ViewUI 需要适配移动端组件或使用其 H5 版本。以下是具体方法:
方法一:使用 ViewUI 的 H5 版本(仅限 H5 平台)
-
安装 ViewUI
在项目根目录运行命令:npm install view-design --save -
全局引入
在main.js中配置:import ViewUI from 'view-design'; import 'view-design/dist/styles/iview.css'; Vue.use(ViewUI); -
组件使用
在页面中直接调用 ViewUI 组件:<template> <Button type="primary">ViewUI Button</Button> </template>
方法二:适配 uniapp 的移动端组件

由于 ViewUI 主要为 PC 端设计,移动端需使用替代方案:
-
官方推荐:通过条件编译区分平台
<!-- #ifdef H5 --> <Button type="primary">PC按钮</Button> <!-- #endif --> <!-- #ifndef H5 --> <uni-button type="primary">移动端按钮</uni-button> <!-- #endif -->
注意事项
- ViewUI 的完整功能仅支持 H5 平台,小程序/App 需自行封装兼容组件
- 推荐优先使用 uniapp 原生组件(如
uni-ui)确保多端兼容性 - 若需定制主题,可修改
iview.css变量或通过uni.scss覆盖样式
替代方案:uniapp 原生 UI 库
若需多端兼容,可考虑以下方案:

- uni-ui:官方扩展组件库,支持全平台
npm install @dcloudio/uni-ui - uView UI:专为 uniapp 设计的跨端 UI 框架
npm install uview-ui
样式冲突解决
当 ViewUI 与 uniapp 样式冲突时,可通过以下方式处理:
-
使用 scoped 样式
<style scoped> /* 组件内样式 */ </style> -
提升选择器优先级
body .ivu-btn { /* 覆盖样式 */ } -
通过
!important强制覆盖(慎用).custom-btn { color: red !important; }






