更新记录

0.72.1(2026-11-19) 下载此版本

修复小程序导航栏、吸顶和页签高度,开关空文案不再整件不渲染。

0.72.0(2026-11-18) 下载此版本

  • vx-switch 新增 onText / offText:把「开 / 关」写进轨道另一半,随状态换边换字;on / off 插槽放图标。滑块、轨道尺寸和位移不变,文字建议 1 个汉字或 2~3 个字母,超出裁掉;字号走 --vx-switch-text-*(9 / 10 / 11)。
  • 文档拆开:组件 API 移到 api/,一个组件一个文件;readme.md 只留优势、接入和组件清单。升级不受影响,只看文档的话路径变了。

平台兼容性

uni-app x(5.31)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ √ √ √ √

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× √ √ √

元汽UI

uni-app x 蒸汽模式的高颜值、原生渲染组件库。60 个基础组件、1112 个图标、亮暗两套主题、五端同一套源码,MIT 免费商用。

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

优势

一个页面从零到上线,不用再引第二个组件库。

  • 原生渲染:组件是 .uvue,蒸汽模式编译成原生视图。App 端不走 WebView,没有第三方运行时。
  • 一套令牌:颜色、字号、间距、圆角、高度全取 --vx-*。亮暗主题只换页面根节点一个 class。
  • 五端同源:Android、iOS、鸿蒙、Web、微信小程序共用一份代码,平台差异收在组件内部。
  • 不缺件:基础、表单、反馈、布局、导航五类共 60 件,缺一个控件就得换库的项目也够用。
  • 复制即用:放进 uni_modules 自动注册,不用写 custom 正则。
  • MIT:个人和商业项目都能用,不要求署名,不限项目数量。

平台

端 支持
Android / iOS / 鸿蒙 / Web / 微信小程序 √
其他小程序、uni-app(vue2 / vue3)、nvue —

环境要求

项 要求
HBuilderX 5.26 及以上
项目 uni-app x,蒸汽模式
样式隔离 manifest.json 里开启 2.0
App 动效 @keyframes 要 5.31 起,更早版本加载圈不旋转

接入

  1. 把 vaporix-ui 目录放到项目的 uni_modules 下。

  2. 引入令牌。App 端写在 App.uvue 的 <style> 里:

<style>
    /* #ifndef WEB */
    @import "@/uni_modules/vaporix-ui/libs/style/variables.css";
    /* #endif */
</style>

Web 端在样式隔离 2.0 下改在 main.uts:

// #ifdef WEB
import "@/uni_modules/vaporix-ui/libs/style/variables.css"
// #endif

App 端图标字体不需要额外配置:variables.css 和 icons-extend.css 在 App 分支里内嵌 base64,字体随样式一起进包。Web 用包内 woff2,extend 分四段各带 unicode-range,页面只下载用到的段;小程序内嵌 base64。

  1. 页面根节点加 vx-theme-light 或 vx-theme-dark。

  2. 组件目录符合 easycom 规范,autoscan 会自动注册,不需要写 custom 正则:

"easycom": {
    "autoscan": true
}

同时安装 vaporix-ui-pro 时也不要写一条 ^vx-(.*),否则所有 vx- 标签都会指向其中一个目录。

组件一览

一个组件一个 API 文件,放在包内 api/ 目录,文件名就是标签名。下表的组件名链到文档站的同名页面。

基础

组件 说明
vx-button 按钮,一屏一个实心主操作
vx-icon 图标,core 112 + extend 1000
vx-text 文本,正文、金额、证件格式化
vx-link 超链接,Web 新开标签页,App 复制
vx-tag 标签,状态和分类
vx-badge 徽章,计数、短词和圆点

表单

组件 说明
vx-input 输入框,含搜索变体
vx-textarea 多行输入框,字数统计
vx-number-box 数字框,加减和输入
vx-radio-group / vx-radio 单项选择器
vx-checkbox-group / vx-checkbox 多项选择器
vx-switch 开关,含轨道文字
vx-rate 星级评分,半星和滑动
vx-datetime 日期时间滚轮,十种模式
vx-picker 联动选择,多列滚轮
vx-calendar 日历,单日或区间
vx-form / vx-form-item 表单容器与表单项

反馈

组件 说明
vx-tips 消息提示,横幅或浮层
vx-toast 轻提示,居中短文案
vx-loading 加载中,含全屏浮层
vx-loadmore / vx-nomore 列表尾部状态
vx-no-data 空状态
vx-actionsheet 操作菜单
vx-modal 弹框,可自定义动作
vx-drawer 抽屉,四向滑出
vx-bubble-popup 气泡弹框,也能做聊天气泡
vx-popup 弹出层底座

布局

组件 说明
vx-list-view / vx-list-cell 列表分组与列表行
vx-card 卡片,头正文底三段
vx-section 区块标题栏
vx-grid / vx-grid-item 宫格
vx-row / vx-col 24 栅格,四档断点
vx-image 图片底座,三态回落
vx-image-group 图片组合,重叠和多行
vx-collapse / vx-collapse-item 折叠面板
vx-tabs 页签,含竖排
vx-sticky 吸顶容器
vx-divider 分割线
vx-white-space 上下留白
vx-wing-blank 左右留白
vx-safe-area 安全区占位

导航与展示

组件 说明
vx-navigation-bar 自定义导航栏,滚动渐显
vx-status-bar 状态栏占位
vx-tabbar 底部标签栏,凸起主按钮
vx-footer 页脚,版权和链接
vx-swipe-action 滑动菜单
vx-time-axis 时间轴
vx-steps 步骤条
vx-progress 进度条
vx-countdown 倒计时
vx-rolling-news 滚动消息轮播
vx-notice-bar 通告栏
vx-avatar 头像,三态回落
vx-qrcode 二维码,view 绘制

API 文档

包内 api/ 目录每个组件一个文件,顺序固定:示例 → 属性 → 事件 → 插槽 → 方法 → 说明,缺的部分不出现。文件名是 api/vx-<name>.md,例如 api/vx-modal.md。

  • 只想知道有什么组件:上面的清单。
  • 想知道某个组件的全部参数:打开 api/ 下的同名文件,或看文档站的同名页面。
  • 想知道多个组件共用的约定(尺寸档位、语义色、v-model 写法、弹层的 cancel()):api/README.md 末尾有一节。

可交互预览、属性演示和平台差异:https://www.vaporix-ui.com/components

和 Pro 的关系

表格、虚拟列表、图片上传、富文本、级联选择、瀑布流等 31 个重型件在付费的 vaporix-ui-pro,共用同一套令牌和 vx- 前缀,两个模块并列放进 uni_modules。已免费的组件不会挪进 Pro。

范围和授权:https://www.vaporix-ui.com/docs/pro

约定

  • <script setup>,不写 lang。5.26 按 uts2js 编译 TypeScript 写法,5.31 起默认就是 TypeScript。
  • 公共类型在 libs/types/common.ts,组件 Props 在同目录 props.ts。
  • 选择器只用单个 class,组合态写成一个,例如 vx-button--plain-primary。
  • 颜色、字号、间距、圆角、高度从 --vx-* 取;令牌只在 libs/style/variables.css 维护一份。
  • JS API 需要的色值和时长分别放在 libs/theme.ts、libs/motion.ts,与 variables.css 同步修改。

完整设计规范在源码仓库根目录的 DESIGN.md。

更新

版本记录见 changelog.md,每次发版补一条,升级前先看对应版本。

授权

基础组件使用 MIT,全文见 license.md。图标来自 Phosphor 2.1.2(MIT),许可证在 libs/icons/LICENSE。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT License

Copyright (c) 2026 吴所畏惧

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

暂无用户评论。