Skip to content

LimeButton 按钮组件 ​

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

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

文档链接 ​

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

安装方法 ​

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

注意🔔

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

代码演示 ​

按钮类型 ​

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

html
<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。

html
<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。

html
<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。

html
<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 属性来设置按钮的颜色。

html
<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 属性来设置按钮的加载状态,加载状态下按钮不可点击。

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

禁用状态 ​

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

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

图标按钮 ​

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

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

快速预览 ​

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

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

插件标签说明 ​

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

Vue2使用说明 ​

main.js中添加以下代码:

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

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

API文档 ​

Props 属性说明 ​

属性名说明类型默认值
type按钮类型stringdefault
variant按钮变体string-
disabled是否禁用booleanfalse
loading是否显示加载状态booleanfalse
size按钮尺寸stringmedium
shape按钮形状stringrectangle
icon图标名称string-
iconSize图标大小string-
block是否为块级元素booleanfalse
ghost是否为幽灵按钮booleanfalse
content按钮文本内容string-
color按钮颜色string-
radius按钮圆角string-
fontSize文字大小string-
textColor文字颜色string-
formType表单提交类型string-
openType微信开放能力string-
hoverClass按下去的样式类string-
hoverStopPropagation是否阻止祖先节点出现点击态booleanfalse
hoverStartTime按住后多久出现点击态number20
hoverStayTime手指松开后点击态保留时间number70
lang返回用户信息的语言stringen
sessionFrom会话来源string-
sendMessageTitle会话内消息卡片标题string-
sendMessagePath会话内消息卡片跳转路径string-
sendMessageImg会话内消息卡片图片string-
appParameter打开APP时传递的参数string-
showMessageCard是否显示会话内消息卡片booleanfalse
gap图标与文本的间距string-
lId按钮IDstring-
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-radius6rpx按钮边框圆角
--l-button-border-width1px按钮边框宽度
--l-button-disabled-opacity0.6禁用状态的透明度
--l-button-solid-text-colorwhite实心按钮的文字颜色
--l-button-default-color$text-color-1默认按钮的颜色
--l-button-default-hover-colorrgba(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-height56rpx迷你尺寸按钮的高度
--l-button-small-height64rpx小尺寸按钮的高度
--l-button-medium-height80rpx中尺寸按钮的高度
--l-button-large-height96rpx大尺寸按钮的高度
--l-button-button-padding-按钮内边距
--l-button-icon-size-按钮图标尺寸
--l-button-font-size-按钮文字尺寸

支持与赞赏 ​

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

支付宝赞助微信赞助

源代码 ​

组件源码