# VaporixUI **Repository Path**: DonkeySmall/vaporix-ui ## Basic Information - **Project Name**: VaporixUI - **Description**: 元汽UI · Vaporix UI,Uniapp X 蒸汽模式的高颜值、原生渲染组件库,轻量、极速、开箱即用 - **Primary Language**: TypeScript - **License**: MIT - **Default Branch**: master - **Homepage**: https://www.vaporix-ui.com - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2026-10-21 - **Last Updated**: 2026-11-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

元汽UI

元汽UI · Vaporix UI

uni-app x 蒸汽模式的高颜值、原生渲染组件库

60 个组件 · 1112 个图标 · 亮暗两套令牌 · 免费层 MIT

文档 · 组件 · 安装 · 插件市场 · Pro 组件 · 更新日志 · English

uni-app x 蒸汽模式 HBuilderX 5.26 及以上 60 个组件 1112 个图标 MIT 许可

官网链接:https://www.vaporix-ui.com

## 设计概念 冷色、低饱和、细描边。层级靠留白和 1px 描边,阴影只给浮层。 | 项 | 取值 | | --- | --- | | 令牌 | 颜色、字号、间距、圆角、高度全取 `--vx-*`,亮暗各一份 | | 字号 | 页面品牌 28、区块标题 17、正文 15、辅助 13 | | 控件 | 高度 32 / 40 / 48,文案 14 / 16 / 18 | | 圆角 | 控件 6 / 8 / 10,容器 8,贴边面板 12 | | 动效 | 按下 120ms,过渡 220ms,加载旋转 700ms | ## 截图

组件目录 按钮演示页 卡片演示页

组件目录 · 按钮 · 卡片(Web 演示,App 为原生渲染)

## 为什么用元汽UI | 能力 | 说明 | | --- | --- | | **原生渲染** | 蒸汽模式把 uvue 编译成原生视图,App 端不走 WebView。 | | **免费层不缺件** | 60 个组件够空项目走到上线,Pro 只补高配版和重型件。 | | **复制即用** | `uni_modules` 加 easycom,放目录、引令牌、开蒸汽模式三步。 | | **图标够用** | Phosphor 2.1.2,core 112 默认加载,extend 1000 按需引入。 | ## 快速开始 | 项 | 要求 | | --- | --- | | HBuilderX | 5.26 及以上 | | 项目 | uni-app x,蒸汽模式 | | 样式隔离 | `manifest.json` 里开启 2.0 | | App 动效 | `@keyframes` 要 5.31 起,更早版本加载圈不旋转 | **1. 放入模块** 复制 `uni_modules/vaporix-ui` 到项目的 `uni_modules` 下,也可以从 [DCloud 插件市场](https://ext.dcloud.net.cn/plugin?name=vaporix-ui) 导入。`pages/`、`App.uvue` 属于演示工程,不复制。 **2. 引入令牌** App 端在 `App.uvue`: ```vue ``` Web 端在 `main.uts`: ```ts // #ifdef WEB import "@/uni_modules/vaporix-ui/libs/style/variables.css" // #endif ``` **3. 开蒸汽模式,挂主题** `manifest.json`: ```json { "uni-app-x": { "vapor": true, "styleIsolationVersion": "2", "vapor-render-target": "bytecode" } } ``` 页面根节点挂 `vx-theme-light` 或 `vx-theme-dark`: ```vue ``` easycom 自动扫描,不用写 `custom` 正则。属性表见[组件文档](https://www.vaporix-ui.com/components)。 ## 组件一览 | 分类 | 数量 | 组件 | | --- | :---: | --- | | 基础 | 6 | [按钮](https://www.vaporix-ui.com/components/button) · [图标](https://www.vaporix-ui.com/components/icon) · [标签](https://www.vaporix-ui.com/components/tag) · [徽章](https://www.vaporix-ui.com/components/badge) · [文本](https://www.vaporix-ui.com/components/text) · [超链接](https://www.vaporix-ui.com/components/link) | | 表单 | 12 | [输入框](https://www.vaporix-ui.com/components/input) · [多行输入框](https://www.vaporix-ui.com/components/textarea) · [数字框](https://www.vaporix-ui.com/components/number-box) · [单项选择器](https://www.vaporix-ui.com/components/radio) · [多项选择器](https://www.vaporix-ui.com/components/checkbox) · [开关选择器](https://www.vaporix-ui.com/components/switch) · [评分](https://www.vaporix-ui.com/components/rate) · [日期时间](https://www.vaporix-ui.com/components/datetime) · [联动选择](https://www.vaporix-ui.com/components/picker) · [日历](https://www.vaporix-ui.com/components/calendar) · [表单](https://www.vaporix-ui.com/components/form) · [表单项](https://www.vaporix-ui.com/components/form-item) | | 反馈 | 11 | [消息提示](https://www.vaporix-ui.com/components/tips) · [轻提示](https://www.vaporix-ui.com/components/toast) · [加载中](https://www.vaporix-ui.com/components/loading) · [加载更多](https://www.vaporix-ui.com/components/loadmore) · [没有更多](https://www.vaporix-ui.com/components/nomore) · [暂无数据](https://www.vaporix-ui.com/components/no-data) · [操作菜单](https://www.vaporix-ui.com/components/actionsheet) · [弹框](https://www.vaporix-ui.com/components/modal) · [抽屉](https://www.vaporix-ui.com/components/drawer) · [气泡弹框](https://www.vaporix-ui.com/components/bubble-popup) · [弹出层](https://www.vaporix-ui.com/components/popup) | | 布局 | 18 | [列表分组](https://www.vaporix-ui.com/components/list-view) · [列表行](https://www.vaporix-ui.com/components/list-cell) · [卡片](https://www.vaporix-ui.com/components/card) · [标题栏](https://www.vaporix-ui.com/components/section) · [上下留白](https://www.vaporix-ui.com/components/white-space) · [左右留白](https://www.vaporix-ui.com/components/wing-blank) · [宫格](https://www.vaporix-ui.com/components/grid) · [宫格项](https://www.vaporix-ui.com/components/grid-item) · [栅格布局](https://www.vaporix-ui.com/components/row) · [多端适配](https://www.vaporix-ui.com/components/col) · [图片组合](https://www.vaporix-ui.com/components/image-group) · [折叠面板](https://www.vaporix-ui.com/components/collapse) · [折叠项](https://www.vaporix-ui.com/components/collapse-item) · [标签页](https://www.vaporix-ui.com/components/tabs) · [吸顶容器](https://www.vaporix-ui.com/components/sticky) · [图片](https://www.vaporix-ui.com/components/image) · [分割线](https://www.vaporix-ui.com/components/divider) · [安全区](https://www.vaporix-ui.com/components/safe-area) | | 导航与展示 | 13 | [二维码](https://www.vaporix-ui.com/components/qrcode) · [导航栏](https://www.vaporix-ui.com/components/navigation-bar) · [状态栏](https://www.vaporix-ui.com/components/status-bar) · [标签栏](https://www.vaporix-ui.com/components/tabbar) · [页脚](https://www.vaporix-ui.com/components/footer) · [滑动菜单](https://www.vaporix-ui.com/components/swipe-action) · [时间轴](https://www.vaporix-ui.com/components/time-axis) · [步骤条](https://www.vaporix-ui.com/components/steps) · [进度条](https://www.vaporix-ui.com/components/progress) · [倒计时](https://www.vaporix-ui.com/components/countdown) · [滚动消息](https://www.vaporix-ui.com/components/rolling-news) · [通告栏](https://www.vaporix-ui.com/components/notice-bar) · [头像](https://www.vaporix-ui.com/components/avatar) | 上表是免费层,Pro 见下一节。 ## Pro 组件 31 个组件,与免费层共用一套 `--vx-*` 令牌和 `vx-` 前缀,并列放在 `uni_modules`,easycom 一起扫描。 | 类型 | 组件 | | --- | --- | | 重型件 | [表格](https://www.vaporix-ui.com/components/table) · [虚拟列表](https://www.vaporix-ui.com/components/virtual-list) · [图片上传](https://www.vaporix-ui.com/components/upload) · [富文本](https://www.vaporix-ui.com/components/rich-text) · [拖拽排序](https://www.vaporix-ui.com/components/drag-list) | | 组合件 | [页面容器](https://www.vaporix-ui.com/components/page):导航栏、下拉刷新、触底加载收成一件 | | 选择与输入 | [选择框](https://www.vaporix-ui.com/components/select) · [级联选择](https://www.vaporix-ui.com/components/cascader) · [树型菜单](https://www.vaporix-ui.com/components/tree-view) · [滑动选择](https://www.vaporix-ui.com/components/slider) · [分段器](https://www.vaporix-ui.com/components/segmented-control) · [数据选择器](https://www.vaporix-ui.com/components/data-checkbox) · [验证码输入框](https://www.vaporix-ui.com/components/code-input) · [数字键盘](https://www.vaporix-ui.com/components/keyboard) · [数字键盘输入框](https://www.vaporix-ui.com/components/keyboard-input) | | 展示与动效 | [图片预览](https://www.vaporix-ui.com/components/gallery) · [轮播图](https://www.vaporix-ui.com/components/swiper) · [瀑布流](https://www.vaporix-ui.com/components/waterfall) · [滚动列表](https://www.vaporix-ui.com/components/scroll-list) · [索引列表](https://www.vaporix-ui.com/components/index-list) · [分隔列表](https://www.vaporix-ui.com/components/divide-list) · [分页器](https://www.vaporix-ui.com/components/pagination) · [筛选栏](https://www.vaporix-ui.com/components/dropdown) · [环形进度条](https://www.vaporix-ui.com/components/circular-progress) · [数字动画](https://www.vaporix-ui.com/components/count-to) · [骨架屏](https://www.vaporix-ui.com/components/skeleton) · [加载动画](https://www.vaporix-ui.com/components/loader) · [提示页](https://www.vaporix-ui.com/components/msg) · [压屏窗](https://www.vaporix-ui.com/components/landscape) · [新手引导](https://www.vaporix-ui.com/components/guide) · [返回顶部](https://www.vaporix-ui.com/components/back-top) | 详见 [Pro 组件](https://www.vaporix-ui.com/docs/pro)。 ## 仓库结构 本仓库同时是演示工程,组件库在 `uni_modules/vaporix-ui`。 ``` vaporix-ui/ ├── DESIGN.md 设计规范 ├── App.uvue 应用入口,非 Web 端引入令牌 ├── main.uts 创建应用;Web 端引入令牌 ├── manifest.json 蒸汽模式、样式隔离 2.0 ├── pages.json 路由、easycom 和原生 tabBar ├── pages/ │ ├── index/index.uvue 组件目录 │ ├── api/ 接口目录与示例 │ ├── mine/mine.uvue 外观与版本 │ └── demo/ │ ├── shared/ 目录数据、主题状态、公共 CSS │ └── button/button.uvue 组件演示页,共 54 页 ├── static/ tabBar 图标、演示素材、README 截图 └── uni_modules/vaporix-ui/ ├── components/ 一个目录一个组件 ├── libs/style/variables.css 设计令牌与 core 图标字体 ├── libs/style/icons-extend.css extend 图标字体(可选) ├── libs/ JS 模块:主题、表单规则、日期、农历、二维码 ├── readme.md 组件 API └── changelog.md 版本记录 ``` ## 本地运行 1. 用 HBuilderX 5.26+ 打开本目录。 2. 在 `manifest.json` 里确认已勾选蒸汽模式。换机器后点「重新获取」生成自己的 appid。 3. 运行到浏览器或真机。浏览器走 VDOM,不代表 App 蒸汽模式。 演示工程分三个 tab:组件是 54 个演示页,接口是 `libs` 模块的可运行示例,我的是外观与版本。主题状态在 `pages/demo/shared/theme.ts`,页面根节点切 `vx-theme-light` / `vx-theme-dark` 即换令牌。 新增演示页:写 `pages/demo//.uvue`,在 `pages.json` 注册路由,在 `catalog.ts` 的 `DEMO_COMPONENTS` 登记。 ## 开发约定 1. `