Guide
分步高亮界面上的目标元素,适合做首次使用的功能导览。
主要 Props
| 属性 | 默认值 | 说明 |
|---|---|---|
steps |
必填 | GuideStep 列表,目标 ID 必须唯一 |
open / default_open |
非受控 / 否 | 受控打开状态与非受控初始状态 |
step / default_step |
非受控 / 0 |
受控步骤索引与非受控初始步骤 |
labels |
当前语言 | 覆盖上一步、下一步、跳过和完成文案 |
style |
默认样式 | 面板宽高估值、高亮边距、侧边距和遮罩颜色 |
allow_target_interaction |
false |
是否允许点击穿过高亮区域触达原目标 |
on_open_change |
无 | 打开状态变化 |
on_step_change |
无 | 上一步或下一步后的索引 |
on_skip / on_finish |
无 | 跳过与完成回调 |
GuideStep::side 设置首选方向;空间不足时组件会自动翻转。内置操作文案跟随 arkit_i18n::I18nContext,默认支持英文和简体中文,也可以通过 GuideLabels 完整覆盖。