Tour 引导

分步功能引导，带全屏遮罩与目标高亮。

基础用法

开始引导

开始引导

高亮区域一

高亮区域二

示例代码

引导事件

步骤事件

开始引导尚未开始

高亮区域一

高亮区域二

示例代码

受控步骤与开关

open 与 current 均为受控属性：外部按钮 / JS 设置 open 启动引导，设置 current 直接跳到指定步骤（无需逐步点击）。

受控 open / current

开始引导（设置 open）跳到第 2 步（current=1）跳到第 3 步（current=2）结束（移除 open）

受控高亮区域一

受控高亮区域二

受控高亮区域三

示例代码

API

属性

属性	说明	类型	默认值
current	当前步骤索引	string	0
open	开始引导（布尔属性，存在即启动）	boolean	—
steps	步骤 JSON	TourStep[] | string	[]

事件

事件	说明
oas-cancel	跳过 / Esc 取消
oas-finish	最后一步点击「完成」
oas-step	步骤切换，detail: { index }

遮罩高亮目标，role="dialog" + aria-modal="true"；支持「上一步 / 下一步 / 跳过」与键盘 Esc。