# uView Vue3.0
**Repository Path**: vk-uni/vk-uview-ui
## Basic Information
- **Project Name**: uView Vue3.0
- **Description**: 最大的亮点：同时支持 `Vue3.0` 和 `Vue2.0`，你没看错，现在 `uview-ui` 支持 `Vue3.0` 了（这应该是目前为数不多的 `uniapp Vue3.0` 组件库）（2021-11-18）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 238
- **Forks**: 70
- **Created**: 2021-11-18
- **Last Updated**: 2026-04-15
## Categories & Tags
**Categories**: webui
**Tags**: UVIEW, vue3, vk, uni-app, ui组件库
## README
# vk-uview-ui
> 插件市场地址： [点击前往](https://ext.dcloud.net.cn/plugin?name=vk-uview-ui)
## `vk-uview-ui` 与 `uview-ui` 的关系？
`vk-uview-ui` 是 `VK` 基于 `uview-ui 1.8.3` 版本改造而来，其本质依然还是 `uview-ui`，是 `VK` 的珍藏版，由 `VK` 维护。
`uview-ui` 是 `vk-unicloud 快速开发框架` 之 `client端框架` 中推荐的 UI，很多 `VK框架` 用户都在用 `uview-ui`
由于 `uview-ui` 作者目前重心全在 `uView 2.0` 的 `nvue` 版本上，故没有精力维护 `uView 1.0`，因此作者贡献出了自己珍藏的 `vk-uview-ui` 版本。
> 在这里，也感谢 `uview-ui` 作者的开源奉献，再次为开源点赞。 同时 `vk-uview-ui` 也是无条件开源。
## `vk-uview-ui` 与 `uview-ui 1.8.3` 功能上有什么区别？
- 1、最大的亮点：同时支持 `Vue3.0` 和 `Vue2.0`，你没看错，现在 `uview-ui` 支持 `Vue3.0` 了（这应该是目前为数不多的 `uniapp Vue3.0` 组件库）（2021-11-18）
- 2、以 `uni_modules` 模块形式发布，方便一键更新（同时组件会自动按需加载，无需手动写 `easycom` 规则（注意，你需要把之前写的 `easycom` 规则删除，在项目根目录的 `pages.json` 中删除）
- 3、对部分组件进行了微调，其中大部分调整不会影响你之前的代码运行（如车牌号键盘点击 1 次中文后会自动切英文+数字键盘），但有以下调整可能会影响你代码运行，请看完后再考虑是否有必要使用。
- - 3.1、`u-picker` 的选择省市区的静态数据源使用 unicloud 中 `opendb-city-china` 表内的数据生成（这样前后端地址数据源保持了一致），但由于数据源变动了，可能会对你有些影响。
- - 3.2、删除了 `uview-ui` 内置的 `国际化语言` 功能，（改造成 `Vue3` 比较麻烦，故作者干脆直接删除了）
- - 3.3、还有其他一些细微变动（这个版本是几个月前就已经改造完的，在 uniapp 刚出 Vue3 的时候就开始了，但是由于当时的 uniapp Vue3 bug 真的太多，当时并没有发布，可以想象一下作者当时碰到 bug 满天飞的场景）
- - 3.4、Vue3.0 中， uniapp 的 Vue3 版本在 H5 APP（非 nvue）微信小程序 中兼容性尚可，其他小程序目前还不行。
> [vk-uview-ui 文档](https://vkuviewdoc.fsq.pub/components/icon.html)
**_目前大的问题应该没有了，作者自己的项目也是用此组件库开发，因此你无需担心后期无人维护。_**
如果你了解了以上须知，那么请继续阅读快速上手。
## 快速上手之 Vue2.0
即使是 `Vue2` 版本，同样比原版 `uView1.0` 做了一些优化，如（车牌号键盘点击 1 次中文后会自动切英文，倒计时支持毫秒等等）
支持：H5、App(vue)、微信小程序、支付宝小程序（其他小程序未测试）
- 1、main.js 引入 vk-uview-ui
```js
import uView from './uni_modules/vk-uview-ui';
Vue.use(uView);
```
- 2、App.vue 引入基础样式（注意 style 标签需声明 scss 属性支持）
```html
```
- 3、uni.scss 引入全局 scss 变量文件
```css
@import '@/uni_modules/vk-uview-ui/theme.scss';
```
## 快速上手之 Vue3.0
不建议把老项目 升级到 Vue3.0 (升级非常麻烦，建议新项目才考虑是否使用 Vue3.0)
支持：H5、App(vue)、微信小程序（其他小程序未测试）
目前 发现 Vue3 H5 版本一个重大 bug（与此 UI 框架无关），调试开发没问题，发布到前端托管时样式会错乱，已确定是 HBX 的问题，等待 HBX 修复此问题。（hbx3.3.0 版本已修复此问题）
- 1、前置步骤：修改 `manifest.json` 内的 `vue` 版本为 `vue3`
- 2、项目根目录新增 `index.html` 文件，文件代码为
```html
```
- 3、main.js 引入 vk-uview-ui
```js
// 引入 uView UI
import uView from './uni_modules/vk-uview-ui';
import { createSSRApp } from 'vue';
export function createApp() {
const app = createSSRApp(App);
// 使用 uView UI
app.use(uView);
return { app };
}
```
- 4、App.vue 引入基础样式（注意 style 标签需声明 scss 属性支持）
```html
```
- 5、uni.scss 引入全局 scss 变量文件
```css
@import '@/uni_modules/vk-uview-ui/theme.scss';
```