更新记录

0.2.7(2025-12-26) 下载此版本

  • fix: 修复uniappx 微信小程序 textColor对图标不生效

0.2.6(2025-12-09) 下载此版本

  • fix: 修复类型问题

0.2.5(2025-12-02) 下载此版本

  • fix: 修复radius在uniappx app端不生效的问题
查看更多

平台兼容性

uni-app(4.73)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ √ √ √ - 5.0 √ √
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
√ - - - - - - - - - - -

uni-app x(4.76)

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

其他

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

lime-button 按钮组件

一个功能丰富的按钮组件,用于开始一个即时操作。支持多种类型、样式、状态和尺寸,可用于表单提交、页面跳转、信息确认等多种场景。组件提供了丰富的自定义选项,可以满足各种复杂的交互设计需求。

插件依赖:lime-style、lime-shared、lime-loading、lime-icon

文档链接

📚 组件详细文档请访问以下站点:

安装方法

  1. 在uni-app插件市场中搜索并导入lime-button
  2. 导入后可能需要重新编译项目
  3. 在页面中使用l-button组件

::: tip 注意🔔 本插件依赖的【lime-svg】是原生插件,如果购买(收费为6元)则需要自定义基座,才能使用, 若不需要删除即可 :::

代码演示

按钮类型

按钮支持 default、primary、success、warning、danger 五种类型,默认为 default。

<l-button type="primary">品牌色</l-button>
<l-button type="success">成功色</l-button>
<l-button type="warning">警告色</l-button>
<l-button type="danger">危险色</l-button>
<l-button>通用色</l-button>

按钮变体

按钮支持 solid、outline、dashed、light、text 五种变体,默认为 solid。

<l-button type="primary">默认按钮</l-button>
<l-button type="primary" variant="outline">镂空按钮</l-button> 
<l-button type="primary" variant="light">高亮按钮</l-button>
<l-button type="primary" variant="text">文本按钮</l-button>

按钮尺寸

按钮支持 large、medium、small、mini 四种尺寸,默认为 medium。

<l-button type="primary" size="large" block>通栏按钮</l-button>
<l-button type="primary" size="large">大按钮</l-button>
<l-button type="warning" size="medium">中按钮</l-button>
<l-button type="primary" size="small">小按钮</l-button>
<l-button type="success" size="mini">迷你按钮</l-button>

按钮形状

按钮支持 circle、round、square、rectangle 四种形状,默认为 rectangle。

<l-button type="primary" shape="circle">圆形</l-button>
<l-button type="primary" shape="round">圆角矩形</l-button>
<l-button type="primary" shape="square">正方形</l-button>
<l-button type="primary">长方形</l-button>

自定义颜色

通过 color 属性来设置按钮的颜色。

<l-button color="#7232dd">单色按钮</l-button>
<l-button color="#7232dd" variant="outline">镂空按钮</l-button>
<l-button color="linear-gradient(to right, rgb(255, 96, 52), rgb(238, 10, 36))">渐变按钮</l-button>

加载状态

通过 loading 属性来设置按钮的加载状态,加载状态下按钮不可点击。

<l-button :loading="true" type="primary">加载中</l-button> 

禁用状态

通过 disabled 属性来禁用按钮,禁用状态下按钮不可点击。

<l-button :disabled="true" type="primary">禁用按钮</l-button>

图标按钮

通过 icon 属性设置按钮图标,可以搭配文字一起使用。

<l-button icon="home" type="primary">首页</l-button>
<l-button icon="plus" shape="circle" type="primary"></l-button>

快速预览

导入插件后,可以直接使用以下标签查看演示效果:

<!-- 代码位于 uni_modules/lime-button/components/lime-button -->
<lime-button />

插件标签说明

标签名 说明
l-button 组件标签
lime-button 演示标签

Vue2使用说明

main.js中添加以下代码:

// vue2项目中使用
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

详细配置请参考官方文档:Vue Composition API

API文档

Props 属性说明

属性名 说明 类型 默认值
type 按钮类型 string default
variant 按钮变体 string -
disabled 是否禁用 boolean false
loading 是否显示加载状态 boolean false
size 按钮尺寸 string medium
shape 按钮形状 string rectangle
icon 图标名称 string -
iconSize 图标大小 string -
block 是否为块级元素 boolean false
ghost 是否为幽灵按钮 boolean false
content 按钮文本内容 string -
color 按钮颜色 string -
radius 按钮圆角 string -
fontSize 文字大小 string -
textColor 文字颜色 string -
formType 表单提交类型 string -
openType 微信开放能力 string -
hoverClass 按下去的样式类 string -
hoverStopPropagation 是否阻止祖先节点出现点击态 boolean false
hoverStartTime 按住后多久出现点击态 number 20
hoverStayTime 手指松开后点击态保留时间 number 70
lang 返回用户信息的语言 string en
sessionFrom 会话来源 string -
sendMessageTitle 会话内消息卡片标题 string -
sendMessagePath 会话内消息卡片跳转路径 string -
sendMessageImg 会话内消息卡片图片 string -
appParameter 打开APP时传递的参数 string -
showMessageCard 是否显示会话内消息卡片 boolean false
gap 图标与文本的间距 string -
lId 按钮ID string -
lStyle 自定义样式 string -

type 可选值

值 说明
default 默认按钮
primary 主要按钮
success 成功按钮
warning 警告按钮
danger 危险按钮

variant 可选值

值 说明
solid 实心按钮
outline 描边按钮
dashed 虚线按钮
text 文本按钮
light 浅色按钮

size 可选值

值 说明
mini 迷你尺寸
small 小尺寸
medium 中等尺寸
large 大尺寸

shape 可选值

值 说明
rectangle 长方形
square 正方形
round 圆角矩形
circle 圆形

Events 事件

事件名 说明 回调参数
click 点击按钮时触发 event: Event
getuserinfo 用户点击该按钮时,会返回获取到的用户信息 event: UniEvent
contact 客服消息回调 event: UniEvent
getphonenumber 获取用户手机号回调 event: UniEvent
error 当使用开放能力时,发生错误的回调 event: UniEvent
opensetting 在打开授权设置页后回调 event: UniEvent
launchapp 打开APP成功的回调 event: UniEvent
chooseavatar 获取用户头像回调 event: UniEvent
agreeprivacyauthorization 用户同意隐私协议事件回调 event: UniEvent

Slots 插槽

名称 说明
default 按钮内容

主题定制

组件提供了以下CSS变量,可用于自定义样式:

变量名称 默认值 描述
--l-button-border-radius 6rpx 按钮边框圆角
--l-button-border-width 1px 按钮边框宽度
--l-button-disabled-opacity 0.6 禁用状态的透明度
--l-button-solid-text-color white 实心按钮的文字颜色
--l-button-default-color $text-color-1 默认按钮的颜色
--l-button-default-hover-color rgba(0,0,0,1) 默认按钮悬停时的颜色
--l-button-default-light-color $gray-2 默认按钮浅色模式的颜色
--l-button-default-light-hover-color $gray-3 默认按钮浅色模式悬停时的颜色
--l-button-default-border-color $gray-5 默认按钮的边框颜色
--l-button-primary-color $primary-color 主要按钮的颜色
--l-button-primary-hover-color $primary-color-7 主要按钮悬停时的颜色
--l-button-primary-light-color $primary-color-1 主要按钮浅色模式的颜色
--l-button-primary-light-hover-color $primary-color-2 主要按钮浅色模式悬停时的颜色
--l-button-primary-border-color $primary-color 主要按钮的边框颜色
--l-button-danger-color $danger-color 危险按钮的颜色
--l-button-danger-hover-color $danger-color-7 危险按钮悬停时的颜色
--l-button-danger-light-color $danger-color-1 危险按钮浅色模式的颜色
--l-button-danger-light-hover-color $danger-color-2 危险按钮浅色模式悬停时的颜色
--l-button-danger-border-color $danger-color 危险按钮的边框颜色
--l-button-warning-color $warning-color 警告按钮的颜色
--l-button-warning-hover-color $warning-color-7 警告按钮悬停时的颜色
--l-button-warning-light-color $warning-color-1 警告按钮浅色模式的颜色
--l-button-warning-light-hover-color $warning-color-2 警告按钮浅色模式悬停时的颜色
--l-button-warning-border-color $warning-color 警告按钮的边框颜色
--l-button-success-color $success-color 成功按钮的颜色
--l-button-success-hover-color $success-color-7 成功按钮悬停时的颜色
--l-button-success-light-color $success-color-1 成功按钮浅色模式的颜色
--l-button-success-light-hover-color $success-color-2 成功按钮浅色模式悬停时的颜色
--l-button-success-border-color $success-color 成功按钮的边框颜色
--l-button-mini-height 56rpx 迷你尺寸按钮的高度
--l-button-small-height 64rpx 小尺寸按钮的高度
--l-button-medium-height 80rpx 中尺寸按钮的高度
--l-button-large-height 96rpx 大尺寸按钮的高度
--l-button-button-padding - 按钮内边距
--l-button-icon-size - 按钮图标尺寸
--l-button-font-size - 按钮文字尺寸

支持与赞赏

如果你觉得本插件解决了你的问题,可以考虑支持作者:

支付宝赞助 微信赞助

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议