更新记录

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

打赏

如果你觉得本插件,解决了你的问题,赠人玫瑰,手留余香。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问