1.0.0 • Published 9 months ago

@jxsun/vie-ui v1.0.0

Weekly downloads
-
License
MIT
Repository
-
Last release
9 months ago

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: 回滚操作;