LimeUI+1.2.0

主题

LimeBadge 徽标组件 ​

一个功能丰富的徽标组件，用于展示数字提示、红点提示等。支持自定义位置、颜色、内容等多种配置，可用于消息提醒、数量展示等多种场景。组件提供了丰富的自定义选项，可以满足各种徽标展示需求。

插件依赖：lime-shared、lime-style

文档链接 ​

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

安装方法 ​

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

代码演示 ​

基础用法 ​

最简单的徽标组件用法，只需要设置内容即可。

html
<l-badge content="5">
  <view class="box"></view>
</l-badge>

红点徽标 ​

不需要显示具体数字，只显示一个小红点。

html
<l-badge dot>
  <view class="box"></view>
</l-badge>

最大值 ​

当数值超过最大值时，会显示为最大值+。

html
<l-badge content="99" :max="99">
  <view class="box"></view>
</l-badge>

自定义颜色 ​

设置徽标的背景颜色。

html
<l-badge content="5" color="#1989fa">
  <view class="box"></view>
</l-badge>

自定义位置 ​

徽标支持四个不同的位置：左上角、右上角、左下角、右下角。

html
<l-badge content="5" position="top-left">
  <view class="box"></view>
</l-badge>

<l-badge content="5" position="top-right">
  <view class="box"></view>
</l-badge>

<l-badge content="5" position="bottom-left">
  <view class="box"></view>
</l-badge>

<l-badge content="5" position="bottom-right">
  <view class="box"></view>
</l-badge>

自定义偏移 ​

通过offset属性设置徽标的偏移量，数组的两项分别代表水平和垂直方向的偏移量。

html
<l-badge content="5" :offset="[10, 10]">
  <view class="box"></view>
</l-badge>

独立展示 ​

徽标可以不依附于其他元素，单独展示。

html
<l-badge content="5" />

显示零值 ​

默认情况下，当content为0时不会显示徽标，设置show-zero属性可以强制显示零值。

html
<l-badge content="0" show-zero>
  <view class="box"></view>
</l-badge>

快速预览 ​

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

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

插件标签说明 ​

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

Vue2使用说明 ​

main.js中添加以下代码：

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

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

API文档 ​

Props 属性说明 ​

属性名说明类型默认值
content徽标内容number | string-
dot是否显示为小红点booleanfalse
max最大值，超过最大值会显示 {max}+number-
color徽标背景颜色string-
offset设置徽标的偏移量，数组的两项分别代表水平和垂直方向的偏移量[number | string, number | string]-
showZero当content为0时，是否显示徽标booleanfalse
position徽标位置，可选值为 top-left、top-right、bottom-left、bottom-rightstring'top-right'

Slots 插槽 ​

名称说明
default徽标包裹的子元素
content自定义徽标内容

主题定制 ​

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

变量名称默认值描述
--l-badge-size16px徽标大小
--l-badge-colorwhite徽标文字颜色
--l-badge-padding0 3px徽标内边距
--l-badge-font-size12px徽标字体大小
--l-badge-font-weightbold徽标字体粗细
--l-badge-border-width1px徽标边框宽度
--l-badge-border-colorwhite徽标边框颜色
--l-badge-background$error-color徽标背景色
--l-badge-dot-color$error-color小红点颜色
--l-badge-dot-size8px小红点大小
--l-badge-font-apple-system-font, helvetica neue, arial, sans-serif徽标字体
--l-badge-border-radius999px徽标圆角大小

支持与赞赏 ​

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

支付宝赞助微信赞助

源代码 ​

组件源码