mine-h5-ui

mine-h5-ui

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

特性

• 丰富的模块化组件和组合式 API，60⁺ 个组件
• 支持按需加载，tree-shaking 优化
• 完善的组件使用文档和演示示例
• 内置每个组件的单元测试
• 内置使用文档的 Web UI 自动化测试
• 多页面配置
• 支持移动端预览
• 支持 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')

• 👉 在快速开始中查看更多信息。

使用文档

• 😎 mine-h5-ui@2.x 基于 Vue3.x
• 😎 mine-h5-ui@1.x 基于 Vue2.x

演示地址

• H5 地址
• 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 + Vitest + NodeJs + Markdown + selenium

目录解析

├── 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 解析器
• @tailwindcss/vite: Vite 中配置 Tailwindcss
• @types/markdown-it-container: markdown-it-container 的类型
• @types/mockjs: mockjs 的类型
• @types/node: node 的类型
• @types/postcss-pxtorem: postcss-pxtorem 的类型
• @types/qrcode: qrcode 的类型
• @types/selenium-webdriver: selenium-webdriver 的类型
• @vitejs/plugin-vue: Vite 解析 Vue 文件
• @vue/compiler-sfc: 编译 Vue 单文件组件
• @vue/test-utils: 单元测试和集成测试
• autoprefixer: 添加浏览器厂商前缀
• eslint: 代码检查工具
• eslint-config-prettier: 禁用 Eslint 中与 Prettier 冲突的规则
• eslint-plugin-vue: 检测和修复 Vue 代码
• globals: 全局类型，Node 和 Browser
• autoprefixer: 使用 Gulp 添加浏览器厂商前缀
• husky: Git 操作时自动触发脚本
• jsdom: 模拟浏览器环境
• less: CSS 预编译器
• markdown-it-container: Markdown 解析器
• postcss-pxtorem: 生成 Rem 的 Postcss 插件
• prettier: 代码格式化
• selenium-webdriver: Web UI 自动化测试
• shiki: Markdown 代码高亮
• tslib: TS 库
• tailwindcss: 根据 html class 生成样式
• typescript: 编程语言
• typescript-eslint: TS 的 Eslint 解析器
• unplugin-vue-markdown: 解析 Markdown 文件的 Vite 插件
• vi-canvas-mock: 处理单元测试 canvas 问题
• vite: 项目构建工具
• vite-node: 执行 ts 文件
• vite-plugin-dts: 生成 .d.ts 文件的 Vite 插件
• vite-plugin-eslint2: 检查代码格式的 Vite 插件
• vite-plugin-pwa: 生成 PWA 的 Vite 插件
• vitest: JS 测试框架
• vue-tsc: 编译 TS 单文件 Vue 文件的工具

optionalDependencies

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

贡献者们