更新记录
0.0.1(2024-11-17) 下载此版本
- init
平台兼容性
Vue2 | Vue3 |
---|---|
× | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 4.32 app-vue app-uvue | × | √ | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 |
---|---|---|---|
× | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | × | × | × | × |
lime-steps 步骤条
- 用于任务步骤展示或任务进度展示,让用户了解当前的操作在整体流程中的位置
- 插件依赖
lime-style
,lime-shared
,lime-icon
,lime-svg
不喜勿下
安装
在插件市场导入,首次导入可能需要重新编辑
代码演示
基础
current
属性表示当前步骤的索引,从 0 起计。
<l-steps :current="current" @change="change">
<l-step title="买家下单" content="辅助信息"></l-step>
<l-step title="商家接单" content="辅助信息"></l-step>
<l-step title="买家提货" content="辅助信息"></l-step>
<l-step title="交易完成" content="辅助信息"></l-step>
</l-steps>
const current = ref(1);
const change = (value : number) => {
current.value = value;
}
图标
通过 icon
属性设置图标。
<l-steps :current="current" @change="change">
<l-step icon="cart" title="买家下单" content="辅助信息"></l-step>
<l-step icon="cart" title="商家接单" content="辅助信息"></l-step>
<l-step icon="cart" title="买家提货" content="辅助信息"></l-step>
<l-step icon="cart" title="交易完成" content="辅助信息"></l-step>
</l-steps>
图标
通过 type
属性设置dot
可以小圆点的简略模式。
<l-steps :current="current" type="dot" @change="change">
<l-step icon="cart" title="买家下单" content="辅助信息"></l-step>
<l-step icon="cart" title="商家接单" content="辅助信息"></l-step>
<l-step icon="cart" title="买家提货" content="辅助信息"></l-step>
<l-step icon="cart" title="交易完成" content="辅助信息"></l-step>
</l-steps>
状态
通过status
属性设置状态, 共支持 4 种状态:未完成(wait
)、已完成(finish
)、进行中(process
)、错误(error
)。
<l-steps :current="current" @change="change">
<l-step icon="cart" title="买家下单" content="辅助信息"></l-step>
<l-step icon="cart" title="商家接单" content="辅助信息" status="error"></l-step>
<l-step icon="cart" title="买家提货" content="辅助信息"></l-step>
<l-step icon="cart" title="交易完成" content="辅助信息"></l-step>
</l-steps>
自定义样式
通过activeColor
属性设置当前激活色,finishBgColor
可以设置完成的背景色。
<l-steps :current="current" @change="change" activeColor="#FFB400" finishBgColor="rgba(255, 180, 0, 0.1)">
<l-step icon="cart" title="买家下单" content="辅助信息"></l-step>
<l-step icon="cart" title="商家接单" content="辅助信息"></l-step>
<l-step icon="cart" title="买家提货" content="辅助信息"></l-step>
<l-step icon="cart" title="交易完成" content="辅助信息"></l-step>
</l-steps>
竖向步骤条
可以通过设置 layout
属性来改变步骤条的显示方向。
<l-steps :current="current" @change="change" layout="vertical" >
<l-step icon="cart" title="买家下单" content="辅助信息"></l-step>
<l-step icon="cart" title="商家接单" content="辅助信息"></l-step>
<l-step icon="cart" title="买家提货" content="辅助信息"></l-step>
<l-step icon="cart" title="交易完成" content="辅助信息"></l-step>
</l-steps>
竖向自定义内容
可以通过 extra
插槽可自定义额外内容。
<l-steps :current="current" @change="change" layout="vertical" >
<l-step icon="cart" title="买家下单" content="辅助信息"></l-step>
<l-step icon="cart" title="商家接单" content="辅助信息">
<template #extra>
<view>
<image
src="https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*P0S-QIRUbsUAAAAAAAAAAABkARQnAQ"
alt="图标"
style="width: 100%;"
mode="widthFix"/>
</view>
</template>
</l-step>
<l-step icon="cart" title="买家提货" content="辅助信息"></l-step>
<l-step icon="cart" title="交易完成" content="辅助信息"></l-step>
</l-steps>
查看示例
- 导入后直接使用这个标签查看演示效果
// 代码位于 uni_modules/lime-steps/compoents/lime-steps
<lime-steps />
插件标签
- 默认 l-steps 为 component
- 默认 l-step 为 component
- 默认 lime-steps 为 demo
关于vue2的使用方式
- 插件使用了
composition-api
, 如果你希望在vue2中使用请按官方的教程vue-composition-api配置 - 关键代码是: 在main.js中 在vue2部分加上这一段即可.
// vue2
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)
API
Steps Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
v-model | 当前步骤对应的索引值 | number | 0 |
current | 当前步骤对应的索引值 | number | 0 |
status | 用于控制 current 指向的步骤条的状态。可选项:wait/process/finish/error |
string | process |
layout | 步骤条方向,有两种:横向和纵向。可选项:horizontal/vertical | string | horizontal |
readonly | 只读状态 | boolean | false |
type | 步骤条风格。可选项:default/dot | string | default |
activeColor | 当前步骤和已完成步骤的颜色 | string | `` |
waitColor | 未激活步骤的颜色 | string | `` |
waitBgColor | 未激活步骤的背景颜色 | string | - |
finishBgColor | 已完成步骤的背景颜色 | string | - |
Step Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
content | 步骤描述 | string | - |
icon | 图标,默认显示内置图标 | string | - |
title | 标题 | string | `` |
status | 当前步骤的状态:默认状态(未开始)、进行中状态、完成状态、错误状态。可选项:wait/process/finish/error | boolean | wait |
Steps Events
事件名 | 说明 | 回调参数 |
---|---|---|
change | 当前步骤发生变化时触发 | index: number |
Step Slots
名称 | 说明 | 值 |
---|---|---|
icon | 图标 | status |
title | 标题 | - |
content | 步骤描述 | - |
extra | 额外 | - |
主题定制
样式变量
组件提供了下列 CSS 变量,可用于自定义样式)。uvue app无效。
名称 | 默认值 | 描述 |
---|---|---|
--l-step-dot-size: | 16rpx | - |
--l-step-circle-size: | 44rpx | - |
--l-step-circle-font-size: | 28rpx | - |
--l-step-circle-icon-size: | 32rpx | - |
--l-step-description-color: | $text-color-3 | - |
--l-step-wait-circle-bg-color: | $gray-1 | - |
--l-step-wait-circle-color: | $text-color-3 | - |
--l-step-wait-title-color: | $text-color-3 | - |
--l-step-wait-icon-color: | $text-color-3 | - |
--l-step-wait-dot-border-color: | $gray-4 | - |
--l-step-process-circle-color: | white | - |
--l-step-process-circle-bg-color: | $primary-color | - |
--l-step-process-title-color: | $primary-color | - |
--l-step-process-icon-color: | $primary-color | - |
--l-step-process-dot-border-color: | $primary-color | - |
--l-step-finish-circle-color: | $primary-color | - |
--l-step-finish-circle-bg-color: | $primary-color-1 | - |
--l-step-finish-title-color: | $primary-color-1 | - |
--l-step-finish-icon-color: | $primary-color | - |
--l-step-finish-dot-border-color: | $primary-color | - |
--l-step-error-circle-color: | $error-color | - |
--l-step-error-circle-bg-color: | $error-color-1 | - |
--l-step-error-title-color: | $error-color-1 | - |
--l-step-error-icon-color: | $error-color | - |
--l-step-error-dot-border-color: | $error-color | - |
--l-step-line-color: | $gray-4 | - |
--l-step-finish-line-color: | $primary-color | - |
常见问题
插件包含一下lime-svg为收费插件。如果你不需要svg,可以在lime-icon里注释掉,lime-svg为APP原生插件,收费为1元,源码为5元。如果你需要svg,可以考虑一下购买。
// lime-icon/components/l-icon.uvue 第4行 注释掉即可。
<!-- <l-svg class="l-icon" :class="classes" :style="styles" :color="color" :src="iconUrl" v-else :web="web" @error="imageError" @load="imageload" @click="$emit('click')"></l-svg> -->
打赏
如果你觉得本插件,解决了你的问题,赠人玫瑰,手留余香。