更新记录

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 时出现的卡顿问题
• 优化 文档体验

1.1.6（2024-11-24）

• 修复 导入插件时插件内部页面未完全注册的问题
• 修复 导出插件时错误地导入 sn-e-toast 插件的问题

1.1.5（2024-11-24）

• 重要 插件最低运行版本为 HBuilder X 4.33，如未适配暂勿升级
• 重要 移除 框架内置字体 MiSans ，插件体积减少 60%，如需继续使用此字体可自行下载并导入到项目中
• 重要 移除 sn-e-toast 插件，其所有 API 已迁移至 sn-native，如果原来已下载此插件，请手动删除
• 新增 sn-native 插件作为原生能力扩展库，原 sn-e-toast 及 sinle-ui 部分 API 迁移至 sn-native
• 新增 SnError 错误规范，SinleUI 框架的 API 及组件报错将逐渐规范化，返回 SnError 类型的错误信息。错误码与错误信息对应表详见。
• 调整 Utils 工具库 原 showToast 更名为 showToasty，其参数 config 类型更名为 SnToastyConfig
• 移除 Utils 工具库 share 分享及其参数相应类型，请使用官方 uni.shareWithSystem 代替
• 新增 Utils 工具库 showToast 全局轻提示。与 sn-toast 不同的是，它可以在任意位置调用，无需放置组件；强制防穿透。与 showToasty 不同的是，它的样式配置更加丰富。
• 新增 Utils 工具库 showActionsheet 全局操作菜单，与 sn-actionsheet 不同的是，它可以在任意位置调用，无需放置组件
• 新增 Utils 工具库 showModal 全局模态窗，与 sn-modal 不同的是，它可以在任意位置调用，无需放置组件
• 新增 Utils 工具库 previewImage 全局图片预览，目前仅支持单张图片预览，支持手势缩放、平移，支持长按唤出自定义菜单
• 新增 Utils 工具库 chooseMedia 选择媒体文件方法，支持图片、视频和混选、多选
• 新增 sn-perm-listener 权限申请监听组件，当前页面申请权限时自动弹出权限用途说明框
• 新增 sn-upload-media 属性 mode 增加 all 选项，支持视频图片混传，使用系统相册选择
• 新增 sn-upload-media 事件 file-chose 当媒体文件选择成功时都会触发，与 image-chose 和 video-chose 可以同时触发
• 新增 sn-upload-media-unicloud 属性 mode 增加 all 选项，支持视频图片混传，使用系统相册选择
• 新增 sn-upload-media-unicloud 事件 file-chose 当媒体文件选择成功时都会触发，与 image-chose 和 video-chose 可以同时触发
• 新增 sn-card 属性 titleLines 卡片标题最大显示行数
• 新增 sn-tabbar 属性 v-model:height 支持外部绑定 tabbar 占位高度
• 新增 sn-search 属性 focus 是否获得焦点
• 新增 sn-topbar 属性 backButtonIcon 返回按钮图标
• 新增 sn-grid-group 属性 gutter 子项间距
• 新增 sn-collapse-group 属性 note 、noteColor 、noteSize 支持自定义样式的说明文本
• 新增 sn-collapse-item 插槽 header ，支持自定义配置头部区域
• 新增 sn-menu-item 插槽 header 、body、footer，支持自定义配置各部分区域
• 修复 sn-menu-item 默认插槽不生效的问题
• 新增 sn-tabs 属性 aniTime 动画时长、mode 模式，新增推压动画
• 优化 sn-tabs 动画显示更流畅
• 新增 sn-view 事件 scale 和 roate ，主要为 Web 端提供缩放和旋转事件，与 App 端的 sn-e-gesture 对齐
• 新增 Demo 右上角 关于本应用 入口
• 重写 sn-notice-bar，解决了一些性能和显示问题
• 优化 sn-actionsheet 在宽屏设备上的显示效果
• 优化 sn-tabbar 最大插槽数增加至 10
• 修复 sn-e-scankit 多页面调用 scan 方法回调函数混淆的问题
• 优化 Demo 布局改为 Tabbar 式

平台兼容性

uni-app x(4.71)

特别说明

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

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

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

项目已开源

文档项目地址：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框架仅收费2元，适合个人项目开发。当然，如果您愿意为项目贡献，也欢迎提供代码、指出 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>