更新记录

2.0.4（2026-10-25）

• 【重要】优化 主题链路改为由框架应用主题驱动：颜色变量（--sn-*）改由 sn-page 样式中的系统外观媒体查询声明，组件内不再由脚本写入颜色变量；主题状态改为跟随框架应用主题（应用启动、系统外观变化与手动切换三处统一），App 端建议在 manifest.json 配置 app.defaultAppTheme 为 auto，冷启动首帧即与系统一致（需 HBuilderX 5.25 及以上蒸汽模式）
• 优化 文档阅读体验，丰富了框架特性相关介绍
• 新增 持久化标记 cssPalette：使用自定义配色或非默认内置风格时自动回落为脚本内联变量，默认风格走媒体查询色板
• 新增 sn-page 的五个乘数 CSS 变量补充同值缩写 --mf、--pf、--rf、--ff、--af（依次为外边距、内间距、圆角、字号、动画时长乘数），calc() 中可任选长名或缩写
• 优化 弹窗页（showModal、showActionsheet、showLoading）自行注入颜色、动画时长与五个乘数 CSS 变量，customStyle 中可直接使用 calc(var(--pf) * 12px) 这类乘数写法
• 优化 sn-modal、sn-actionsheet 弹窗的内边距、按钮高度与间距等固定设计值统一随全局乘数缩放，调整字号或间距乘数时弹窗不再保持固定尺寸
• 修复 系统外观来回切换后可能出现的页面背景、卡片底色不跟随而仅文字跟随的问题，消除"脚本写颜色 + 组件渲染上色"两条通道不同步的隐患
• 修复 sn-topbar、sn-swipe-action 背景色改为直接引用主题 CSS 变量，切换主题时背景与文字同步更新
• 修复 sn-upload-media、sn-upload-media-unicloud 上传失败或超时后条目一直停留在「上传中」的问题：失败分支改为先落地条目状态、再中止任务与派发事件，任务结束时兜底校正未落地的状态，同一任务的失败事件只派发一次
• 修复 App 与 Web 运行时未提供全局 SourceError 时，构造错误对象抛异常并中断后续处理的问题：统一按运行时能力降级为普通 Error，上传失败时状态更新与 upload-error 事件恢复正常
• 修复 上传超时错误码与 sn-backtop 错误码撞号（上传超时改用 9010016），并补全错误码到错误信息的对照表，getErrMsg 返回的文案更准确

2.0.3（2026-10-18）

• 新增 SnStyleValue（外部样式值：样式字符串或样式对象）、SnFormData（表单数据）等公共类型并由插件对外导出，样式类属性统一使用这些具名类型，替代原有的 UTSJSONObject 写法（UTSJSONObject 仅保留在 utssdk/ 原生插件中，不影响既有传参方式）
• 新增 resolveColorValue 颜色解析：$ 简写或 var(--sn-*) 均解析为当前主题下的实际色值，供原生弹层等脱离页面 CSS 变量作用域的场景使用
• 新增 UI 形式 API（showToast / showModal / showActionsheet / showLoading / 权限提示样式）的颜色字段支持 $ 简写、尺寸字段支持 $ 动态值与纯数字，且尺寸字段放宽为 String | Number
• 优化 尺寸类属性全量统一走 resolveSize：支持 $ 动态尺寸与裸数字（含 sn-select / sn-drawer / sn-drawer-list / sn-keyboard / sn-float-board / sn-sidebar / sn-cell / sn-input / sn-input-field / sn-form-field / sn-textarea / sn-textarea-field / sn-tabbar-item / sn-tabs / sn-line / sn-menu / sn-view / sn-upload-media / sn-upload-media-unicloud），修复 width="$150"、width="150" 等写法输出非法 CSS 导致宽度失效的问题
• 修复 resolveSize 对无 $ 的纯数字字符串未补单位：border-radius="10" 现在正确解析为 10px，且不再误乘全局乘数
• 修复 sn-swipe-action 组件销毁或长列表回收后写内联样式触发空引用崩溃
• 优化 项目自有脚本由 uts 全面迁移为 ts（main / i18n、核心模块、组件内部工具、工具库与 Demo 页面，共 94 个文件），加快编译速度并统一类型体验；原 .uts 路径与导入后缀已同步调整，如你的工程中直接引用了这些内部模块，请改为 .ts

2.0.2（2026-10-11）

• 【重要】插件源码统一改用 <script lang="ts">，加快编译速度，推荐使用 HBuilderX Alpha 5.31 及以上版本
• 新增 毛玻璃导航栏：sn-topbar、sn-tabbar、sn-page 新增 blur / blurRadius / blurOpacity，sn-page 新增 topbarBgColor
• 新增 Tabbar 高度占位联动：sn-tabbar 新增 tabbarKey，配合新 Hook useTabbarHeights 让子页面读取固定导航栏实际高度，在滚动内容末尾放置占位（内容可经毛玻璃导航栏背后呈现）
• 新增 sn-select 新增专用选项类型 SnSelectItem（支持选项左右图标与选项级文字样式），data 由 SnDataItem[] 改为 SnSelectItem[]（兼容旧字段）；新增 leftIcon / rightIcon / leftIconColor / rightIconColor / leftIconSize / rightIconSize 属性
• 新增 sn-color-picker、sn-color-picker-view 新增 preset 与 extra 插槽，可替换「内置颜色」预设区或在其下方追加自定义内容
• 新增 sn-slider、sn-slider-double 新增 showGlow 属性，可关闭按下滑块时的拖拽光晕
• 新增 sn-tabbar 新增 customClass 属性与 changeToIndex 方法；sn-tabbar-item 新增 padding 属性（itemPadding 保留兼容）
• 新增 snui.topbarHeightResolved 只读属性，返回当前平台实际渲染的导航栏高度（Web 端为 topbarHeight + 8px）
• 新增 Demo 新增「颜色库」「日期库」「状态存储」API 页面，原「工具库」页面拆分为 23 个分组页面，并新增「乘数设计」页与「弹层登录」模板页
• 优化 导航栏高度体系调整：snui.topbarHeight 默认值由 88px 调整为 48px（六套内置风格同步）；sn-topbar 固定模式不再自动生成等高占位，高度语义改为导航栏内容区高度（statusBar 开启时向上覆盖状态栏并按实际高度占位），zIndex 默认值调整为 998
• 优化 弹层层级：sn-popup 打开时按栈内已有弹层自动抬升层级，sn-select、sn-drawer 移除固定层级，多个弹出层同时使用时不再互相遮挡
• 优化 点击命中区域：sn-input 的前后缀图标、清除按钮、密码切换与 sn-notice-bar 关闭按钮改为独立可点击容器，避免点击无效
• 优化 sn-color-picker 打开期间外部 v-model 变化会同步进草稿值；底部按钮改用 sn-button 自带文本渲染
• 优化 sn-text 的文本选择与最大行数在非 App 平台统一生效
• 优化 禁用态统一：sn-drag、sn-fullscreen、sn-swipe-action、sn-mention、sn-pagination、sn-upload-media、sn-upload-media-unicloud 等补 Web 端 cursor: not-allowed
• 优化 sn-popover 移除打开后的二次定位修正，弹出不再跳动
• 修复 sn-popup 固定根容器改为常驻，renderMode 只控制遮罩与内容的挂载方式，修复首次打开时容器尺寸未就绪导致的偶发不显示
• 修复 sn-upload-media 上传超时、失败与组件卸载时先落地条目状态再中止任务，修复文件一直停留在「上传中」
• 修复 sn-album 图片占位层改用条件渲染，并在数据重置时清空已加载标记，修复占位层残留
• 修复 sn-timer 重置与卸载统一走 pause()，修复定时器未清理
• 修复 sn-toast 图标被长文本压缩变形
• 修复 sn-clipper、sn-arc-progress、sn-arc-slider 等组件内部对象属性访问方式统一，避免部分平台取值异常
• 修复 i18n t() 的占位符替换在全平台统一实现

平台兼容性

uni-app x(5.31)

其他

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 或 蓝奏云（不限速，密码：abcd）

• 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>