更新记录

2.0.1（2026-09-27）

• 适配 HarmonyOS 系统，大部分组件、API 运行良好，少部分组件尚未完全适配或存在一些异常，下版本将持续推进适配
• 修复 Demo 主页“组件分类”下的组件列表弹层偶发点击无效的问题
• 修复 对旧版本已废除插件 sn-e-scan-provider、sinle-error 的错误依赖导致无法编译的问题
• 优化 重构 sn-popup 组件底层实现，增强基于此弹层组件的一系列组件 sn-drawer、sn-picker、sn-select、sn-select、sn-popover 等 的动画稳定性、流畅性

2.0.0（2026-09-19）

• 【提示】本次变更较大，可利用 AI 完成版本迁移（差异详情：https://sinleui.pages.dev/differences）
• 【重要】插件推荐运行版本为 HBuilder X Alpha 5.25 及以上（蒸汽模式在此版本之前存在比较严重的问题）
• 【重要】新增 框架全面重构为 uni-app x 蒸汽模式（vapor），VDOM 模式由于性能原因不再支持。
• 新增 多风格（Style）系统：内置 default / ink / chinese / new-year / morandi-green / orange 六套风格，支持自由修改增删内置风格，或者为应用添加自定义风格，并支持一键切换。
• 新增 五乘数体系（fontsizeFactor / radiusFactor / marginFactor / paddingFactor / aniTimeFactor）与三基础动画时长 baseAniTimeShort / Normal / Long，修改自动持久化并实时驱动页面
• 新增 国际化支持。插件默认支持简体中文 zh-Hans、英语 en、法语 fr、俄语 ru、日语 ja、繁体中文 zh-Hant、韩语 ko、西班牙语 es、德语 de、意大利语 it、葡萄牙语 pt 共计 11 种语言。
• 新增 SnColorBase.shadow 阴影色字段，随主题自动切换
• 新增 全局弹窗 showLoading / hideLoading；showToast 新增 title 兼容写法与 passThrough 点击穿透，showModal / showActionsheet 新增 openAnimation / closeAnimation 自定义开合动画
• 新增 snu 金额工具 roundAmount / numToUpperAmount（字符串级舍入，规避浮点陷阱）与全新 Resolve、Perm 方法分组
• 新增 $snui.logging 日志开关与 log / info / debug / warn / error 统一日志接口，组件内部不再直接 console 来报日志。
• 新增 Utils 工具库 hideToast 隐藏轻提示
• 新增 Utils 工具库 clamp 夹具函数，对所给值限制范围
• 新增 $snui.colors 颜色 light，与 dark 相对应。亮色模式下，light 即 #fff，dark 即 #000；暗黑模式下，两者颜色互换，light 即 #000，dark 即 #fff
• 新增 syncStatusBarColor / createCalendarDayPaint / createCalendarDayContent 全局函数与 SN_DEFAULT_STYLE_ID 常量
• 新增 sn-agreement 协议勾选：支持链接文本与勾选状态双向绑定
• 新增 sn-album 相册：网格宫格展示图片组并支持点击预览
• 新增 sn-amount 金额展示：字符串级精确舍入、千分位分隔与中文大写金额
• 新增 sn-arc-progress 环形进度：基于 canvas 绘制，支持自定义起止角度
• 新增 sn-arc-slider 圆弧滑块：圆弧形态滑动选择器，含 hue 颜色模式
• 新增 sn-calendar 日历选择器：底部弹出，支持单选 / 区间 / 多选三种模式
• 新增 sn-calendar-view 月历视图：可滑动的月历面板，供日历系列组件复用
• 新增 sn-calendar-punch 打卡日历：签到打卡记录日历
• 新增 sn-calendar-week 周日历：一次展示一周并支持滑动切周
• 新增 sn-cascader 级联选择：支持静态 data 与异步 loadData 双数据源
• 新增 sn-cell 列表项：通用单元格组件，框架内部列表布局统一复用
• 新增 sn-clipper 图片裁剪：可视裁剪框拖拽缩放，导出区域与预览一致
• 新增 sn-code-input 验证码输入：支持掩码、光标与粘贴识别
• 新增 sn-color-picker 颜色选择器：支持 alpha 透明度与预设色
• 新增 sn-color-picker-view 颜色视图：颜色选择的滑动面板视图
• 新增 sn-drag 拖拽排序：长按拖拽交换排序
• 新增 sn-drag-item 拖拽项：配合 sn-drag 使用的可拖拽子项
• 新增 sn-drawer-list 抽屉长列表：底部抽屉形态的长列表容器
• 新增 sn-ellipsis 文本省略：超长文本省略并支持展开 / 收起
• 新增 sn-footer 页脚：Logo + 导航链接 + 版权三段式布局
• 新增 sn-fullscreen 全屏：原位展开全屏容器
• 新增 sn-form-field 表单项容器：标签、内容、必填标与校验注册的基座
• 新增 sn-input-field 标签输入框：表单项 + 输入框组合，内置错误提示
• 新增 sn-textarea-field 标签文本域：表单项 + 文本域组合，含字数统计
• 新增 sn-highlight-text 高亮文本：关键词高亮显示
• 新增 sn-keyboard 安全键盘：数字 / 整数 / 密码 / 身份证 / 车牌五种类型
• 新增 sn-mention 提及输入：@ 提及选择输入框
• 新增 sn-message 消息条：全局消息队列，六方向弹出与分组计数
• 新增 sn-notification 通知：带标题内容与类型图标，支持进度条与拖动关闭
• 新增 sn-pagination 分页器：简洁 / 完整两种模式，支持快速跳转
• 新增 sn-popover 气泡卡片：锚点定位的轻量气泡弹层
• 新增 sn-post-card 帖子卡片：动态 / 帖子信息展示卡片
• 新增 sn-region-picker 省市区选择：内置中国区划数据，省 / 市 / 县模式
• 新增 sn-scroll-view 滚动容器：与长列表共用刷新 / 加载更多 / 回到顶部机制
• 新增 sn-slide-captcha 滑块验证：拖拽滑块完成验证
• 新增 sn-slider-double 双向滑块：区间范围选择
• 新增 sn-sorter 排序：字段排序选择器
• 新增 sn-steps 步骤条：横 / 竖排布，圆点 / 点状两种形态
• 新增 sn-step 步骤项：配合 sn-steps 的步骤节点
• 新增 sn-table 表格：支持固定表头与固定列
• 新增 sn-tr 表格行：配合 sn-table 的行节点
• 新增 sn-td 表格单元格：配合 sn-table 的单元格节点
• 新增 sn-tree 树：多模式选择与懒加载
• 新增 sn-watermark 水印：页面或局部水印覆盖，不影响其他组件，无副作用。
• 新增 Demo 手势库实例，结合可视化元素演示手势库应用
• 新增 sn-e-toast 插件：替换 snu.showToast 基于 dialogPage 实现的不可透穿手势的 Toast 轻提示，原生弹层实现同官方 uni.showToast 基本一致的体验。同时相对于官方的 UI 新增了动画和丰富的样式支持。
• 优化 $ 动态变量解析，在原有的仅支持基础上支持解析任意尺寸，自动计算符合当前框架尺寸乘数的结果。新增 Resolve 相关解析 API （详见文档）暴露给开发者使用以适配框架样式。
• 优化 动画统一由 UniElement DOM animate / transition + --ani-time-* 变量实现，支持 $ 简写并随 aniTimeFactor 全局调速
• 优化 点击态统一为 useHover + hover-style 机制，替代旧 hover-class，配套 hover-start-time / hover-stay-time / hover-trans-time
• 优化 内部列表项 / 子项布局统一复用 sn-cell，子元素样式经 itemStyle / itemHoverStyle / itemTextStyle / itemIconStyle / itemClass / itemBorder 传递链透传
• 优化 长列表组件（sn-list-view / sn-waterflow）改为数据驱动 + 作用域插槽渲染，条目按数据项 type 分组复用回收，避免了直接传入 list-item / flow-item 组件被渲染为普通view 而引发的内存泄露问题
• 优化 重新设计了 sn-input 和 sn-textarea 的默认样式。如需原来的样式可以通过丰富的属性来实现。
• 优化 跟手组件触摸交互改为 DOM 直操作，APP 端拖动更顺滑
• 优化 sn-select、sn-menu 支持触底上移，即如果触发点位于页面底部，将自动将弹出层上移，避免触底。
• 优化 各组件尺寸类统一支持联合类型 String | Number
• 优化 sn-datetime-picker 的性能问题。
• 优化 禁用态统一使用主题禁用色，Web 端条件编译设置 cursor: not-allowed
• 优化 sn-select 滚动模式下打开将自动定位到当前选中项。
• 优化 sn-waterflow Web 端启用虚拟滚动，长列表滚动更流畅
• 优化 sn-picker-view 在 APP端使用拍平，极大提升了载入大量数据时的性能，卡顿大幅减轻
• 优化 sn-upload-media 及 sn-upload-media-unicloud 在非 Web 端平台改用系统提供的选择器，无需再向系统申请媒体权限
• 优化 sn-scan 从相册中选择图片时改用系统提供的选择器，无需再向系统申请媒体权限，且不会产生大量缓存文件而导致占用空间膨胀
• 优化 Demo 新特性速览跳转到工具库 Demo 时出现的卡顿问题
• 优化 sn-e-markdown Android 改为原生渲染，消除 WebView 卡顿
• 优化 按钮 / 输入框 / 开关加载态指示器延迟 100ms 显示，避免闪烁
• 优化 sn-rate 只读态改为双层裁剪渲染，提升性能
• 【重要】更改【破坏性变更】重构原有 API 架构，具体见文档。
• 更改【破坏性变更】 全部组件样式扩展统一为 customStyle + {语义}Style / Class 透传体系，适配蒸汽模式样式隔离 2.0
• 更改 【破坏性变更】 SnError ：字段变更为 scope / funName / errCode / err，旧 moduleName / apiname / errSubject / errMsg 全部失效
• 更改 【破坏性变更】$snui.setColorSet 更名 setColorBase，颜色键校验更严格
• 更改 组件 v-model 规范化：旧 vModel / modelValue 统一为 v-model（sn-checkbox / sn-radio / sn-switch / sn-rate / sn-slider / sn-progress 等）
• 更改 【破坏性变更】弹出层组件 open / close 事件改为六段动画生命周期事件 beforeenter / enter / afterenter / beforeleave / leave / afterleave，clickMask 统一更名 clickoverlay
• 更改 【破坏性变更】扩展插件收编为内置组件：sn-e-gesture → sn-gesture、sn-e-qrcode → sn-qrcode、sn-e-barcode → sn-barcode
• 更改 【破坏性变更】 sn-waterfall 更名重写为 sn-waterflow，并进行了重构。在APP 端封装官方内置组件 waterflow，在 Web 端采用自实现的虚拟列表。
• 更改 【破坏性变更】sn-markdown 迁移为独立插件 sn-e-markdown
• 更改 【破坏性变更】 sn-longlist 重构为 sn-list-view，refresher-triggered 改为 v-model 双向绑定
• 更改 【破坏性变更】 sn-form-item 拆分为 sn-form-field / sn-input-field / sn-textarea-field，submited 事件更名 submit
• 更改 【破坏性变更】sn-menu 菜单类组件的子组件从 sn-menu-item 改为 sn-cell ，移除插槽并新增 select 事件。
• 更改 重新设计 sn-signature 组件布局，适配横屏模式。
• 更改 尺寸 / 时间类 props 统一放宽为 String | Number 并接入 $ 乘数语法，颜色类 props 使用 String(色值) 支持 $ 主题色
• 更改 【破坏性变更】字号板（font.baseSize + size 等级）、圆角等级板、动画等级板，改为乘数体系
• 更改 【破坏性变更】各组件 customXxxStyle（UTSJSONObject）更名去 custom 前缀为 {语义}Style 并成对新增 {语义}Class，customStyle 类型放宽为 UTSJSONObject | String
• 更改 【破坏性变更】$snui.configs 六大子配置体系，改为 $snui 扁平属性直接读写
• 修复 Android 端跟手组件拖动卡顿问题，触摸交互改 DOM 直写保证帧率
• 修复 sn-notice 组件在横屏或宽屏场景下文字完全隐藏后需要等待较长时间才会再次显示的问题
• 修复 sn-notice 组件过长文本会被截断的问题
• 修复 弹出层类组件未置于 sn-page 根节点时 --sn-* 颜色与 --ani-time-* 动画时长变量失效的问题
• 修复 非法 type / level 导致异常的问题，当前自动回退默认主题
• 修复 sn-timer / sn-countdown 等组件类型过度收窄导致的传参报错
• 修复 Date 日期库部分情况下报空指针异常的问题
• 修复 Utils 工具库 isDate 在高版本 uni-app x 上报空指针异常的问题
• 修复 sn-scan 图片扫描成功后预览图与识别点错位的问题
• 修复 sn-scan 手指在扫描线上无法触发缩放事件的问题（即缩放具有明显的卡顿感的问题）
• 移除 【破坏性变更】Store 状态管理库（$snui.store 及 StoreLib 全部废弃），蒸汽模式可直接使用 pinia 。
• 移除 【破坏性变更】configs.font.mainFamily 内置字体配置与 configs.app.grayMode 哀悼置灰模式
• 移除 【破坏性变更】snu 方法：makePhoneCall、vibrate、addPx、share、chooseMedia、previewImage、showToasty。上述方法官方基本已有实现或已不实用。
• 移除 废弃类型：SnShareConfig、SnChooseMediaOptions、SnPreviewImageConfig、SnPreviewImageLongPressActions、SnToastyConfig
• 移除 【破坏性变更】 栅格布局组件 sn-col / sn-row 与过渡组件 sn-transition。上述组件已不实用。
• 移除 【破坏性变更】SVG 组件 sn-e-svg。官方内置 image 已支持 svg 格式。
• 移除 sn-list-item、sn-list-chat 、 sn-menu-item 静态列表子组件，改由 sn-cell 实现
• 移除 【破坏性变更】 sn-perm-listener 组件标签形态，权限提示能力迁移为 snu.setPermTips / registerPermListener 等全局 API。

1.1.7（2025-08-12）

• 【重要】插件最低运行版本为 HBuilder X 4.71
• 新增 Utils 工具库 hideToast 隐藏轻提示，根据传入的 Toast 标识，隐藏指定的 Toast
• 新增 Utils 工具库 clamp 夹具函数，对所给值限制范围
• 新增 $snui.colors 颜色 light ，与 dark 相对应。亮色模式下，light 即 #fff，dark 即 #000；暗黑模式下，两者颜色互换，light 即 #000，dark 即 #fff
• 新增 sn-e-gesture 事件 rotate ，为原生手势库提供旋转事件，与 View 的 rotate 事件对齐
• 新增 sn-swipe-action 滑动操作组件，使用插槽随意布局
• 新增 sn-datetime-picker 日期时间选择器组件
• 新增 sn-datetime-picker-view 日期时间选择器容器组件
• 新增 Demo 手势库实例，结合可视化元素演示手势库应用
• 优化 sn-picker-view 在 Android 端使用 Drawable 绘制文字，极大提升了载入大量数据时的性能，卡顿明显减轻
• 优化 sn-upload-media 及 sn-upload-media-unicloud 在非 Web 端平台改用系统提供的选择器，无需再向系统申请媒体权限
• 优化 sn-scan 从相册中选择图片时改用系统提供的选择器，无需再向系统申请媒体权限，且不会产生大量缓存文件而导致占用空间膨胀
• 移除 Utils 工具库 chooseMedia 选择媒体文件，请使用 uni.chooseMedia 代替
• 移除 Utils 工具库 previewImage 选择预览图片，请使用 uni.previewImage 代替
• 调整 Utils 工具库 showToast 返回值由 void 改为 string，返回值即 Toast的标识符
• 修复 Date 日期库部分情况下报空指针异常的问题
• 修复 Utils 工具库 isDate 在高版本 uni-app x 上报空指针异常的问题
• 修复 sn-scan 图片扫描成功后预览图与识别点错位的问题
• 修复 sn-scan 手指在扫描线上无法触发缩放事件的问题（即缩放具有明显的卡顿感的问题）
• 优化 Demo 新特性速览跳转到工具库 Demo 时出现的卡顿问题
• 优化 文档体验

平台兼容性

uni-app x(5.25)

其他

V2 版本说明

SinleUI V2 版本较 V1 版本差异较大，可利用 AI 完成版本迁移（差异详情）

SinleUI V2 版本框架全面重构为 uni-app x 蒸汽模式（VAPOR），VDOM 模式由于性能原因不再支持。

特别说明

⚠⚠ ️本项目尚不完善，请勿用于商业项目 ⚠⚠

由于插件使用了第三方依赖，导入插件后必须打包自定义基座后运行。

！！！！购买此产品请务必选择“源码版授权”！！！！

文档/DEMO项目已开源

文档项目地址：Github 或 Gitee

示例工程项目地址（示例工程不含 sinle-ui 插件，请购买后自行导入）：Github 或 Gitee

插件交流群：108588496

文档

文档部分内容可能不完善，多多包涵 ☺️ 如有问题，欢迎在交流群（uni-im 或 Q 均可）提问

文档地址： Github Pages 或 Cloudflare

Demo

• Android - 下载地址：Github Releases 或 Gitee Releases 或 蓝奏云（不限速）
• Web - Demo 地址：Github Pages 或 Cloudflare

介绍

SinleUI

一个简洁、轻巧的现代移动应用UI框架

🖥️ 作者有话说

这个UI框架是作者苦于 uni-app x 插件市场缺失适合自己的UI库，在开发项目的过程中写的。我自己项目比较多，而且都是一些小型项目，资金不算太充裕。对于小型个人项目来说，较完美的UI框架授权费用相对较高，自我感觉非常不划算，其他免费的UI框架大多有点不合项目的风格，于是自己写了一个。

由于作者时常在校，因此更新频率视情况待定。若没有满足您的需求，可以自己二次开发。

本UI框架适合个人项目开发。当然，如果您愿意为项目贡献，也欢迎提供代码、指出 Bug 或打赏，这也是我创作的动力。😊

🍕 项目声明

本UI框架作者为：Aaron Lan

采用MIT协议，允许二次开发和修改，以及对使用本UI框架的项目闭源处理。但必须在项目显著位置（包括但不限于项目发布页、项目声明文件、项目许可信息页面）进行使用声明。

🍪 引用声明

本项目内置字体说明

• Remix Icon 【免费商用】

📖 MIT许可证

Copyright (C) <2023-> \<Singmy></p> <p>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:</p> <p>The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.</p> <p>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.</p> </blockquote>