Tour 新手引导
分步高亮关键 UI 元素 + 解释气泡,新功能上线时引导用户。
基础用法
steps 每一项 { target, title, description, placement }。target 是 CSS 选择器,对应页面里需要被高亮的元素;placement 控制气泡相对目标的方位。
<CfTour v-model="open" :steps="steps" /> <CfTour open={open} onOpenChange={setOpen} steps={steps} /> API
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
steps | TourStep[] | — | 引导步骤列表 |
open / modelValue | boolean | — | 受控显示状态 |
defaultOpen / defaultValue | boolean | false | 非受控初始状态 |
current | number | — | 受控当前步索引 |
defaultCurrent | number | 0 | 非受控初始步 |
事件:onOpenChange(open) / onCurrentChange(n) / onFinish() / onClose()。
TourStep
| 字段 | 类型 | 说明 |
|---|---|---|
target | string | CSS 选择器,定位高亮目标 |
title | string | 气泡标题 |
description | string | 气泡描述(可选) |
placement | 'top' | 'bottom' | 'left' | 'right' | 气泡相对目标的方位,默认 'bottom' |
反馈与讨论
Tour 新手引导 的讨论