开发预览 更新于 2026-05-10

Tour 新手引导

分步高亮关键 UI 元素 + 解释气泡,新功能上线时引导用户。

基础用法

steps 每一项 { target, title, description, placement }target 是 CSS 选择器,对应页面里需要被高亮的元素;placement 控制气泡相对目标的方位。

<CfTour v-model="open" :steps="steps" />
<CfTour open={open} onOpenChange={setOpen} steps={steps} />

API

属性类型默认值说明
stepsTourStep[]引导步骤列表
open / modelValueboolean受控显示状态
defaultOpen / defaultValuebooleanfalse非受控初始状态
currentnumber受控当前步索引
defaultCurrentnumber0非受控初始步

事件:onOpenChange(open) / onCurrentChange(n) / onFinish() / onClose()

TourStep

字段类型说明
targetstringCSS 选择器,定位高亮目标
titlestring气泡标题
descriptionstring气泡描述(可选)
placement'top' | 'bottom' | 'left' | 'right'气泡相对目标的方位,默认 'bottom'

反馈与讨论

Tour 新手引导 的讨论

0
0 / 600
一键发送
正在加载评论...