更新记录

0.1.4(2025-08-31) 下载此版本

  • chore: 更新文档

0.1.3(2025-05-28) 下载此版本

  • fix: uniappx web 镂空时颜色不生效的问题

0.1.1(2025-05-26) 下载此版本

  • fix: uniappx web 圆角时左右描边不显示的问题
查看更多

平台兼容性

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-stylelime-sharedlime-loadinglime-icon

文档链接

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

安装方法

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

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

代码演示

按钮类型

按钮支持 defaultprimarysuccesswarningdanger 五种类型,默认为 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>

按钮变体

按钮支持 solidoutlinedashedlighttext 五种变体,默认为 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>

按钮尺寸

按钮支持 largemediumsmallmini 四种尺寸,默认为 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>

按钮形状

按钮支持 circleroundsquarerectangle 四种形状,默认为 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协议