Vue实现一个“蛇形”步骤条

前言

在现代Web应用中，步骤条（Step Progression）作为一种常见的UI组件，广泛应用于表单提交、任务进度以及多步骤操作等场景。为了提升用户体验，设计师往往会采用更加直观和有趣的方式展示步骤进度。今天，我们将通过 Vue 实现一个"蛇形"步骤图组件，这种独特的设计方式不仅能清晰地表达步骤的完成状态，还能给用户带来更加流畅和动态的交互体验。

前几天在做一个需求时就需要写一个步骤图组件，大致原型如下：

看到这个，内心无一点波澜，直接去项目配套 Ant Desin Vue 组件库中找对应组件拿来改改就 ojbk 了。

But，后端同事告诉我业务场景后发现还有操作空间，因为 UI 组件的 Step 步骤条不太符合当前业务，里面所有步骤都是连续的，但是当前业务场景是可以跳过其中一些步骤项，于是打算自己写一个，最后根据后端返回的数据来决定步骤项是否执行了。

customStep（V1）

customStep.vue 完整代码：

<template>
    <div class="custom-step">
        <div v-for="(item, index) in stepList" :key="index" class="step-item">
            <div class="item-content">
                <div class="step-title" @click="handleStepClick(index)">
                    <div class="step-num" :class="{ 'step-num-finished': item.status === 'finished' }">{{ index + 1 }}
                    </div>
                    <div class="setp-txt" :class="{ 'step-txt-finished': item.status === 'finished' }">{{ item.title }}
                    </div>
                </div>
                <div class="split-line" v-if="!item.isLast" :class="{ 'split-line-finished': isFinished(index) }"></div>
            </div>
        </div>
    </div>
</template>

<script setup>
import { ref, computed } from 'vue'

const props = defineProps({
    stepList: {
        type: Array,
        default: () => []
    }
})

// 步骤列表
// const stepList = ref([
//     { title: '确定意向', status: 'finished', isLast: false },
//     { title: '对接洽谈', status: 'finished', isLast: false },
//     { title: '项目报价', status: 'unfinished', isLast: false },
//     { title: '投标对比', status: 'unfinished', isLast: false },
//     { title: '合同拟定', status: 'unfinished', isLast: false },
//     { title: '转化完成', status: 'finished', isLast: false },
//     { title: '转化完成1', status: 'finished', isLast: false },
//     { title: '转化完成2', status: 'finished', isLast: true },
// ])

const isFinished = computed(() => index => {
    const prevStep = props.stepList[index];
    const nextStep = props.stepList[index + 1];
    return prevStep.status === 'finished' && nextStep.status === 'finished';
})

const emit = defineEmits(['stepClick'])
const handleStepClick = index => {
    emit('stepClick', index)
}
</script>

<style lang="less" scoped>
.custom-step {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    row-gap: 20px;
    width: 100%;
    padding: 0 30px;

    .step-item {
        width: calc(100% / 6);

        .item-content {
            box-sizing: border-box;
            display: flex;
            align-items: center;
        }

        .step-title {
            width: 80px;
            text-align: center;
            font-weight: 600;
            color: rgb(153, 153, 166);
            cursor: pointer;

            .step-num {
                box-sizing: content-box;
                width: 35px;
                margin: 0 auto;
                line-height: 35px;
                font-size: 16px;
                border: 3px solid #e3e8ec;
                border-radius: 100%;
            }

            .setp-txt {
                margin-top: 10px;
            }

            .step-num-finished {
                color: rgb(26, 188, 156);
                border: 3px solid rgb(26, 188, 156);
            }

            .step-txt-finished {
                color: rgb(26, 188, 156);
            }
        }

        .split-line {
            width: calc(100% - 80px);
            height: 3px;
            margin-top: -25px;
            background-color: #e3e8ec;
            border-radius: 5px;
        }

        .split-line-finished {
            background-color: rgb(26, 188, 156);
        }
    }
}
</style>

最后效果如下：

页面初始渲染步骤，然后可以点击某个步骤项，进行业务操作后刷新页面重新渲染步骤条，这样可以根据业务需求跳过某些步骤项。

But，还有事，我这固定了一行显示6个步骤项，超过6个会换行，但是显示就有一点瑕疵，因为正常元素布局都是从左到右，所以超过6个步骤项就会这样显示：

1 -> 2 -> 3 -> 4 -> 5 -> 6 ->

7 -> 8 -> ...

产品给我说这样看着不太连贯，想实现一个类似 "S" 形的，看着会连贯一些，后面找了个例子改了改，算是符合当前需求了。

customStep（V2）

customStep_.vue 完整代码：

<template>
    <div class="container">
        <div v-for="(item, index) in stepList" class="grid-item" :key="index">
            <div class="step" :class="{ 'step-finished': item.status === 'finished' }" @click="handleStepClick(index)">
                {{ item.title }}</div>
        </div>
    </div>
</template>

<script setup>
import { ref } from 'vue';

const props = defineProps({
    stepList: {
        type: Array,
        default: () => []
    }
})

// 步骤列表
// const stepList = ref([
//     { title: '确定意向', status: 'finished' },
//     { title: '对接洽谈', status: 'finished' },
//     { title: '项目报价', status: 'unfinished' },
//     { title: '投标对比', status: 'unfinished' },
//     { title: '合同拟定', status: 'unfinished' },
//     { title: '转化完成', status: 'finished' },
//     { title: '制定方案', status: 'unfinished' },
//     { title: '合同签订', status: 'finished' },
//     { title: '合同跟踪', status: 'finished' },
//     { title: '合同回款', status: 'unfinished' },
//     { title: '项目交付', status: 'unfinished' },
//     { title: '项目验收', status: 'unfinished' },
//     { title: '项目结束', status: 'unfinished' },
// ])

const emit = defineEmits(['stepClick'])
const handleStepClick = index => {
    emit('stepClick', index)
}

</script>

<style lang="less" scoped>
@colNum: 6; // 单行排列的步骤项个数（2、3、4、5、6、...） 
@colEven: @colNum * 2; // 两行元素数
@lineWidth: 35px; // 步骤间连线长度
@rowDistance: 50px; // 行间距
@colDistance: @lineWidth; // 列间距
@arrowSize: 6px; // 箭头大小
@stepColor: #9e9e9e; // 步骤颜色

.container {
    width: 100%;
    display: grid;
    padding: 30px 0;
    grid-template-columns: repeat(@colNum, 1fr);
    gap: @rowDistance @colDistance;
}

.grid-item {
    position: relative;
    display: flex;
    align-items: center;
    justify-content: center;
    cursor: pointer;

    &::before {
        position: absolute;
        content: '';
        right: -@lineWidth;
        width: @lineWidth;
        height: 0;
        border-top: 1px dashed @stepColor;
    }

    &::after {
        content: '';
        position: absolute;
        right: (-@colDistance / 2);
        transform: translateX(50%);
        border-top: (@arrowSize / 1.4) solid transparent;
        border-left: @arrowSize solid @stepColor;
        border-bottom: (@arrowSize / 1.4) solid transparent;
    }

    // 给每行最后一个步骤（除最后一行）添加向下的连接箭头
    &:nth-child(@{colNum}n) {

        &:not(:last-child) {
            .step {
                &::before {
                    content: '';
                    position: absolute;
                    left: 50%;
                    bottom: -(@rowDistance / 2);
                    height: @lineWidth;
                    border-left: 1px dashed @stepColor;
                    transform: translate(-50%, 50%);
                }

                &::after {
                    content: '';
                    position: absolute;
                    left: 50%;
                    bottom: -(@rowDistance / 2);
                    border-top: @arrowSize solid @stepColor;
                    border-left: (@arrowSize / 1.4) solid transparent;
                    border-right: (@arrowSize / 1.4) solid transparent;
                    transform: translate(-50%, 50%);
                }
            }
        }
    }

    each(range(@colEven), {
        &:nth-child(@{colEven}n+@{value}) {
            @isEvenLine: boolean(@value > @colNum);
            @modNum: mod(@value, @colEven); // 余数 1、2、3、4、5、0

            /** 偶数行旋转箭头，步骤倒序排列（使用transform交换位置） */
            & when (@isEvenLine) {
                @transN: (@colNum + 1 + @colEven - @value - @value);
                transform: translateX(calc(@transN * 100% + @transN * @colDistance));

                &::after {
                    transform: translateX(50%) rotate(180deg) !important; // 旋转箭头
                }
            }

            // 最右排(n & n + 1 位)隐藏多余的箭头（如果container设置了overflow:hidden 则不用处理）
            & when (@modNum=@colNum), (@modNum=@colNum+1) {
                &::before, &::after {
                    display: none;
                }
            }

            // 最后一个步骤在奇数行 需要隐藏连线箭头
            & when not (@isEvenLine) {
                &:last-child {
                    &::before, &::after {
                        display: none;
                    }
                }
            }
        }
    })
}

.step {
    position: relative;
    width: 100px;
    line-height: 40px;
    font-size: 16px;
    text-align: center;
    border-radius: 5px;
    color: #9e9e9e;
    border: 2px solid #9e9e9e;
}

.step-finished {
    background-color: #4caf50;
    color: #fff;
    border: 2px solid #4caf50;
}
</style>

两种对比效果：

大功告成！！！