@jxsun/vie-ui
v1.0.0
Published
Vue3 基于Element-plus二次封装组件文档
Downloads
3
Maintainers
Readme
vie-ui
Vue2 基于 Element-ui基础组件传送门
基于 Element-ui 二次封装基础组件地址
vie-ui使用Demo项目
vieorg-admin
是基于 Vue3.3、TypeScript、Vite4、Pinia、Element-Plus 开源的一套后台管理模板;此项目全面使用了vie-ui
二次封装基础组件库
介绍
基于 vue3+ ts+ Element-plus 二次封装组件
这是在学习 Vue3 中基于Element-plus 二次封装基础组件文档,希望对你有用。可查看 详细组件案例文档 预览
效果图
效果图
npm 方式安装使用
pnpm i @vieorg/vie-ui
全局注册使用
全局注册 Element-plus组件库
// 在main.js中按下引入
import { createApp } from "vue";
import App from "./App.vue";
import ElementPlus from "element-plus";
import "element-plus/dist/index.css";
import "element-plus/theme-chalk/dark/css-vars.css";
import locale from "element-plus/es/locale/lang/zh-cn";
// element-plus图标
import * as ElementPlusIconsVue from "@element-plus/icons-vue";
import VieUi from '@vieorg/vie-ui'
import '@vieorg/vie-ui/lib/style.css'
const app = createApp(App)
// 注册所有图标
for (const [key, component] of Object.entries(ElementPlusIconsVue)) {
app.component(key, component);
}
// 注册ElementPlus
app.use(ElementPlus, {
locale // 语言设置
// size: Cookies.get('size') || 'medium' // 尺寸设置
});
app.use(VieUi)
app.mount('#app')
按需引入
// 在main.js中按下引入
import '@vieorg/vie-ui/lib/style.css'
// 单个.vue文件引入
<script setup lang="ts">
import {TDetail, TForm} from "@vieorg/vie-ui"
</script>
全部组件如下
| 组件名称 | 说明 | | :----------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- | | TLayoutPage | 布局页面 | | TLayoutPageItem | 布局页面子项 | | TAdaptivePage | 一屏组件(继承TTable 及 TQueryCondition 组件的所有属性、事件、插槽、方法) | | TQueryCondition | 条件查询组件 | | TTable | 表格组件 | | Virtualized TTable | 虚拟列表 | | TForm | 表单组件 | | TSelectTable | 下拉选择表格组件 | | Virtualized TSelectTable | 下拉选择虚拟表格组件 | | TSelectIcon | 图标选择组件 | | TSelect | 下拉选择组件 | | TDetail | 详情组件 | | TButton | 防抖按钮组件 | | TStepWizard | 步骤条组件 | | TTimerBtn | 定时按钮组件 | | TModuleForm | 模块表单/详情组件 | | TDatePicker | 日期选择器组件 | | TRadio | 单选组件 | | TCheckbox | 多选组件 | | TChart | 图表组件 | | TTabs | 标签页组件 | | TSelectIcon | 图标选择组件 |
Use CDN in Project(暂不支持)
<head>
<!-- Import style -->
<link rel="stylesheet" href="//unpkg.com/@vieorg/vie-ui/lib/style.css" />
<!-- Import Vue 3 -->
<script src="//unpkg.com/vue@3"></script>
<!-- Import component library -->
<script src="https://unpkg.com/@vieorg/vie-ui@latest"></script>
</head>
vie-ui Volar 组件类型提示
// 需要在使用的项目的tsconfig.json文件中添加以下
compilerOptions:{
"types": [
"@vieorg/vie-ui/components.d.ts",
],
}
安装依赖
注意: 本地环境版本最好安装 Node.js 16.x+、pnpm 7.x+
npm install -g pnpm
# 安装依赖
pnpm install --registry=https://registry.npmjs.org/
>pnpm config get registry 查看当前指向源
# 如果安装依赖失败,可以尝试使用淘宝镜像 --registry=https://registry.npmmirror.com/
>pnpm config set registry https://registry.npmmirror.com/ 切换淘宝镜像源
>pnpm install
本地运行 vuepress 中组件文档
// docs项目(文档demo示例)基于vue3+vite项目
npm run docs:dev
Thanks to all the contributors
微信交流群
目前微信群已超过 200 人,需要加微信好友(请备注 vie-ui),拉大家进群
| 微信二维码 | | :---------------------------------------: | | |
Git 提交规范
ci
: ci 配置文件和脚本的变动;chore
: 构建系统或辅助工具的变动;fix
: 代码 BUG 修复;feat
: 新功能;perf
: 性能优化和提升;refactor
: 仅仅是代码变动,既不是修复 BUG 也不是引入新功能;style
: 代码格式调整,可能是空格、分号、缩进等等;docs
: 文档变动;test
: 补充缺失的测试用例或者修正现有的测试用例;revert
: 回滚操作;