Skip to content

一款轻量级、模块化基于 Vue3.x 的 H5 前端 UI 组件库 😊

License

Notifications You must be signed in to change notification settings

biaov/mine-h5-ui

Repository files navigation

mine-h5-ui

一款轻量级、模块化基于 Vue3.x 的 H5 前端 UI 组件库 👍

mineh5ui

mine-h5-ui mine-h5-ui mine-h5-ui mine-h5-ui mine-h5-ui mine-h5-ui

特性

  • 丰富的模块化组件和组合式 API,60+ 个组件
  • 支持按需加载,tree-shaking 优化
  • 完善的组件使用文档和演示示例
  • 内置每个组件的单元测试
  • 多页面配置
  • 支持移动端预览
  • 支持 PWA
  • 支持 TypeScript
  • 版本更新日志
  • 开发指南

安装

npm i mine-h5-ui

使用

import { createApp } from 'vue'
import App from './App.vue'
import mineh5ui from 'mine-h5-ui'
import 'mine-h5-ui/styles/index.css'

createApp(App).use(mineh5ui).mount('#app')

使用文档

演示地址

项目文档

运行项目

克隆项目

git clone https://github.com/biaov/mine-h5-ui.git --depth=1

安装依赖

  • 项目根目录安装项目依赖
npm i

启动项目

npm start

打包项目

  • 打包组件库文档和组件库
npm run build

技术栈

  • Vite + Vue3.x + TypeScript + Less + Gulp + Vitest

目录解析

├── mine-h5-ui -------------------------------- 组件库名称
│   ├── .husky -------------------------------- Git 操作时自动触发脚本
│   ├── .vscode ------------------------------- VSCode 配置
│   ├── config -------------------------------- 配置文件
│   ├── dist ---------------------------------- 打包后的文件
│   ├── examples ------------------------------ 组件库文档
│   │   ├── assets ---------------------------- 静态资源
│   │   ├── components ------------------------ 组件库文档组件
│   │   ├── config ---------------------------- 配置文件
│   │   ├── docs ------------------------------ 组件库文档主页面 Markdown 文件
│   │   ├── router ---------------------------- 路由
│   │   ├── styles ---------------------------- 样式
│   │   ├── utils ----------------------------- 工具
│   │   ├── views ----------------------------- 组件库文档页面
│   │   ├── App.vue --------------------------- 组件库文档主页面
│   │   └── main.ts --------------------------- 组件库文档入口文件
│   ├── mobile -------------------------------- 移动端组件库文档
│   │   ├── assets ---------------------------- 静态资源
│   │   ├── components ------------------------ 组件库文档组件
│   │   ├── router ---------------------------- 路由
│   │   ├── views ----------------------------- 组件库文档页面
│   │   ├── App.vue --------------------------- 组件库文档主页面
│   │   └── main.ts --------------------------- 组件库文档入口文件
│   ├── node_modules -------------------------- 依赖包
│   ├── packages ------------------------------ 组件库组件
│   ├── public -------------------------------- 静态资源
│   ├── scripts ------------------------------- 脚本
│   ├── tests --------------------------------- 测试
│   ├── typings ------------------------------- 类型
│   ├── .editorconfig ------------------------- 编辑器配置
│   ├── .eslintignore ------------------------- Eslint 忽略文件
│   ├── .eslintrc.js -------------------------- Eslint 配置
│   ├── .gitignore ---------------------------- Git 忽略文件
│   ├── .ncurc.json --------------------------- NCU 配置
│   ├── .npmignore ---------------------------- NPM 忽略文件
│   ├── .prettierignore ----------------------- Prettier 忽略文件
│   ├── index.html ---------------------------- 组件库文档入口文件
│   ├── LICENSE ------------------------------- 授权协议
│   ├── mobile.html --------------------------- 移动端组件库文档入口文件
│   ├── package-lock.json --------------------- 依赖包版本锁定文件
│   ├── package.json -------------------------- 依赖包配置文件
│   ├── README.md ----------------------------- 项目文档
│   ├── RELEASE.md ---------------------------- 发布文档
│   ├── tsconfig.json ------------------------- TS 配置
│   ├── vite.config.ts ------------------------ Vite 配置
└   └── vitest.config.ts ---------------------- Vitest 配置

依赖解析

dependencies

  • clipboard: 剪切板
  • html2canvas: 截屏
  • mockjs: 模拟数据
  • qrcode: 二维码
  • vue: 前端框架
  • vue-router: 路由

devDependencies

  • @eslint/js: Eslint js 解析器
  • @types/mockjs: mockjs 的类型
  • @types/node: node 的类型
  • @types/postcss-pxtorem: postcss-pxtorem 的类型
  • @types/qrcode: qrcode 的类型
  • @vitejs/plugin-vue: Vite 解析 Vue 文件
  • @vue/compiler-sfc: 编译 Vue 单文件组件
  • @vue/test-utils: 单元测试和集成测试
  • autoprefixer: 添加浏览器厂商前缀
  • eslint: 代码检查工具
  • eslint-plugin-prettier: 检测不符合 Prettier 格式的代码
  • eslint-plugin-vue: 检测和修复 Vue 代码
  • globals: 全局类型,Node 和 Browser
  • autoprefixer: 使用 Gulp 添加浏览器厂商前缀
  • husky: Git 操作时自动触发脚本
  • jsdom: 模拟浏览器环境
  • less: CSS 预编译器
  • markdown-it-container: Markdown 解析器
  • postcss-pxtorem: 生成 Rem 的 Postcss 插件
  • prettier: 代码格式化
  • shiki: Markdown 代码高亮
  • tslib: TS 库
  • tailwindcss: 根据 html class 生成样式
  • typescript: 编程语言
  • typescript-eslint: TS 的 Eslint 解析器
  • unplugin-vue-markdown: 解析 Markdown 文件的 Vite 插件
  • vite: 项目构建工具
  • vite-plugin-dts: 生成 .d.ts 文件的 Vite 插件
  • vite-plugin-eslint: 检查代码格式的 Vite 插件
  • vite-plugin-pwa: 生成 PWA 的 Vite 插件
  • vitest: JS 测试框架
  • vue-tsc: 编译 TS 单文件 Vue 文件的工具

optionalDependencies

  • @rollup/rollup-linux-x64-gnu: 支持 Linux 环境运行 Rollup

贡献者们

贡献者们