Skip to content

LimeButton 按钮组件

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

插件依赖:lime-stylelime-sharedlime-loadinglime-icon

文档链接

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

安装方法

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

注意🔔

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

代码演示

按钮类型

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

按钮变体

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

按钮尺寸

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

按钮形状

按钮支持 circleroundsquarerectangle 四种形状,默认为 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-按钮文字尺寸

支持与赞赏

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

支付宝赞助微信赞助

源代码

组件源码