菜单 · 组件

最后更新:2026年8月12日

组件

分步高亮界面元素,做功能导览。

Guide

分步高亮界面上的目标元素,适合做首次使用的功能导览。

主要 Props

属性默认值说明
steps必填GuideStep 列表,目标 ID 必须唯一
open / default_open非受控 / 否受控打开状态与非受控初始状态
step / default_step非受控 / 0受控步骤索引与非受控初始步骤
labels当前语言覆盖上一步、下一步、跳过和完成文案
style默认样式面板宽高估值、高亮边距、侧边距和遮罩颜色
allow_target_interactionfalse是否允许点击穿过高亮区域触达原目标
on_open_change打开状态变化
on_step_change上一步或下一步后的索引
on_skip / on_finish跳过与完成回调

GuideStep::side 设置首选方向;空间不足时组件会自动翻转。内置操作文案跟随 arkit_i18n::I18nContext,默认支持英文和简体中文,也可以通过 GuideLabels 完整覆盖。