更新记录

1.2.5（2025-12-29）

新组件

• feat: 增加【toast】轻提示
• feat: 增加【gradient-text】渐变文本
• feat: 增加【use】hooks库

新功能

• feat: 【shared】增加getWindowInfo
• feat: 【sticky】增加抖音小程序支持
• feat: 【ruler】重构
• feat: 【icon】重构
• feat: 【text-ellipsis】重构
• feat: 【cell】增加cellGroup的css var变量

BUG 修复

1.2.4（2025-12-05）

新组件

• feat: 增加【lime-skeleton】骨架屏组件
• feat: 增加【lime-anchor】锚点导航组件

新功能

• feat: 【shared】增加arrayEqual、findLastIndex
• feat: 【picker】增加maskColors属性，用于设置上下遮罩的颜色
• feat: 【sidebar】重构

BUG 修复

1.2.3（2025-11-20）

新组件

• feat: 增加【lime-tts】文本转语音插件
• feat: 增加【lime-color-grab】图片取色组件
• feat: 增加【lime-storage】数据持久化插件
• feat: 增加【lime-bignumber】大数插件

  新功能

• feat:【lime-floating-panel】uniappx 增加移动阈值
• feat:【lime-request】uniappx data转成原始值

  BUG 修复

平台兼容性

uni-app(4.51)

uni-app x(4.61)

LimeUI

LimeUI 基于 Composition API 构建，是一个轻量高效、组件丰富、主题灵活的跨平台 UI 组件库。完美兼容 UniApp/UniAppX 生态，提供 65+ 免费组件、25+ 收费组件及 26+ 原生插件，支持 CSS 变量动态主题与暗黑模式，助您快速构建专业级跨端应用。

核心优势

• Setup 语法 - 采用 Composition API，代码简洁优雅，逻辑复用能力强
• 跨平台兼容 - 完美支持 UniApp/UniAppX 生态，一套代码多端运行
• 主题灵活 - 内置 CSS 变量系统，轻松实现主题定制与暗黑模式
• 按需引入 - 支持组件单独导入，有效减小应用体积
• 持续迭代 - 活跃维护更新，定期新增组件与功能特性

::: tip 使用提示 ✔ 所有组件支持按需引入
⚠ 维护量大，难免出现错误，有问题及时反馈
📩 反馈问题：插件市场评论区 → 加入开发者交流群

最佳实践
▸ 保持HBX为最新版本，因为组件可能会使用最新特性
▸ 保持基础组件为最新版本 :::

📚 文档中心

• 🚀 limeUI【站点1】
• 🌍 limeUI【站点2】
• 🔥 limeUI【站点3】

快速开始

安装方式

方式一：完整导入 在 插件市场 点击「试用」按钮，一键集成基础组件库

方式二：按需导入 访问组件详情页 → 点击「导入」获取组件独立包

方式三：GitCode 拉取 从 GitCode 拉取组件源码，按需放入项目 uni_modules 目录下（购买后联系作者获取地址）

📦 推荐方案：基础组件库 + 按需加载特定组件
⚡ 优势：有利于改善强迫症患者焦虑

使用方式

组件安装完成后，可直接在任意页面中使用对应的组件。若为新增组件，建议重新编译一次以确保组件正常加载。

授权说明

💡 每份授权都是对项目持续维护的支持，衷心感谢开发者的认可！

Vue2 兼容方案

组件使用了 composition-api，若在 Vue2 中使用请按官方教程配置：

// main.js
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

参考：vue-composition-api

原生组件配置

使用原生组件需要根据开发环境进行相应配置：

Gradle 版本配置

• Windows 系统：使用 Gradle 7.6.3
• Mac 系统：使用 Gradle 8.14.3

自定义基座要求

• Android 开发：Windows 系统必须使用自定义基座
• iOS 开发：
  • 有 Mac 设备：不需要自定义基座
  • 无 Mac 设备：需要自定义基座

::: warning 注意 原生组件涉及原生代码编译，请确保开发环境配置正确，否则可能导致编译失败或运行异常。 :::

组件概览

免费组件（65款）

以下组件将随库自动导入，支持 web/微信小程序/App/鸿蒙next 平台：

基础组件

• lime-icon - 图标组件 ⚠️ 依赖 lime-svg 插件
• lime-button - 按钮组件
• lime-popup - 弹窗组件
• lime-transition - 过渡动画
• lime-cell - 单元格
• lime-image - 图片组件
• lime-link - 超链接
• lime-space - 间距布局

表单组件

• lime-cascader - 级联选择器
• lime-checkbox - 复选框
• lime-radio - 单选框
• lime-search - 搜索框
• lime-stepper - 步进器
• lime-switch - 开关组件
• lime-input - 输入框
• lime-textarea - 多行文本框
• lime-upload - 文件上传
• lime-picker - 选择器组件
• lime-date-time-picker - 时间选择器
• lime-area - 省市区选择
• lime-keyboard - 虚拟键盘
• lime-code-input - 验证码输入框

反馈组件

• lime-loading - 加载动画
• lime-load-more - 加载更多
• lime-dialog - 弹出对话框
• lime-overlay - 遮罩层
• lime-action-sheet - 动作面板

展示组件

• lime-circle - 环形进度条
• lime-liquid - 水波进度球
• lime-count-down - 倒计时组件
• lime-empty - 空状态提示
• lime-tag - 标签组件
• lime-count-to - 数字滚动
• lime-badge - 徽标组件
• lime-avatar - 头像组件
• lime-highlight - 高亮文本
• lime-divider - 分割线

导航组件

• lime-sidebar - 侧边导航
• lime-tabbar - 标签栏
• lime-back-top - 回到顶部
• lime-navbar - 导航栏
• lime-segmented - 分段器
• lime-tabs - 标签页
• lime-pagination - 分页器

业务组件

• lime-date-strip - 日期横条
• lime-daily-punch - 打卡签到
• lime-collapse - 折叠面板
• lime-steps - 步骤条
• lime-notice-bar - 通知栏
• lime-scroll-x - 横向滚动
• lime-dateformat - 日期格式化
• lime-dialer - 大转盘

布局组件

• lime-layout - 布局
• lime-card - 卡片
• lime-grid - 宫格布局
• lime-swiper-dot - 轮播图指示点
• lime-footer - 页脚

其他组件

• lime-resize - 监听元素尺寸
• lime-swipe-cell - 滑动单元格
• lime-sorter - 排序按钮
• lime-fab - 浮动按钮
• lime-floating-panel - 浮动面板
• lime-popover - 气泡弹出框
• lime-text-ellipsis - 文本省略
• lime-read-more - 查看更多
• lime-config-provider - 全局配置

收费组件（25款）

原生组件（26款）

说明：具体兼容性以插件市场组件详情页为准

组件标识规范

为方便开发调试，采用标准化标签体系：

开发建议：参考演示标签的用法示例，实际开发使用正式组件标签

技术支持

遇到技术问题可通过以下方式获取支持：

1. 📝 插件市场评论区留言
2. 👥 评论区入口加入开发者交流群

捐助支持

如果您觉得组件库对您的开发工作有所帮助，欢迎通过下方二维码进行捐助。您的支持将助力项目持续优化与更新！

感谢您对开源项目的支持！💖

每一份捐助都将用于：

• 服务器与域名维护
• 组件库功能增强
• 开发者激励计划