Tour 漫游导览
用于引导用户了解产品的弹出组件。当你想要引导用户了解产品时使用。
基础用法
最基本的使用
非模态
使用 :mask="false" 使导览变为非模态。同时建议配合 type="primary" 使用以强调引导本身。
位置
更改引导相对于目标的位置,共有 12 种位置可选。当 target 为空时,引导将显示在屏幕中心。
自定义遮罩样式
自定义遮罩样式。
自定义指示器
自定义指示器。
目标
target 支持多种参数传递类型。自 2.5.2 起支持字符串和函数类型。
Tour API
提示
具有相同名称的 tour-step 组件配置优先级更高
Tour 属性
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| append-to | TourContent 追加到哪个元素 | CSSSelector / HTMLElement | body |
| show-arrow | 是否显示箭头 | boolean | true |
| placement | 引导卡片相对于目标元素的位置 | 枚举 | bottom |
| content-style | 内容的自定义样式 | CSSProperties | — |
| mask | 是否启用遮罩,可以通过传递自定义属性来更改遮罩样式和填充颜色 | boolean | Object | true |
| gap | 遮罩与目标之间的透明间隙 | TourGap | Object |
| type | 类型,影响背景颜色和文字颜色 | default | primary | default |
| model-value / v-model | 开启导览 | boolean | false |
| current / v-model:current | 当前是哪一步 | number | 0 |
| scroll-into-view-options | 支持传递自定义的 scrollIntoView 选项 | boolean | ScrollIntoViewOptions | Object |
| z-index | Tour 的 zIndex | number | 2001 |
| show-close | 是否显示关闭按钮 | boolean | true |
| close-icon | 自定义关闭图标,默认为 Close | string | Component | — |
| close-on-press-escape | 是否可以通过按 ESC 键关闭对话框 | boolean | true |
| target-area-clickable | 在使用遮罩时,目标元素是否可以点击 | boolean | true |
Tour 插槽
| 名称 | 描述 | 类型 |
|---|---|---|
| default | tourStep 组件列表 | — |
| indicators | 自定义指示器 | object |
Tour 事件
| 名称 | 描述 | 类型 |
|---|---|---|
| 关闭 | 关闭时的回调函数 | Function |
| finish | 完成时的回调函数 | Function |
| change | 步骤变化时的回调 | Function |
TourStep API
TourStep 属性
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| target | 获取引导卡片指向的元素。为空时显示在屏幕中央。自 2.5.2 起支持字符串和函数类型。字符串类型为 document.querySelector 的选择器。 | HTMLElement | string | Function | — |
| show-arrow | 是否显示箭头 | boolean | — |
| title | title | string | — |
| description | description | string | — |
| placement | 引导卡片相对于目标元素的位置 | 枚举 | bottom |
| content-style | 内容的自定义样式 | CSSProperties | — |
| mask | 是否启用遮罩,可以通过传递自定义属性来更改遮罩样式和填充颜色 | boolean | Object | — |
| type | 类型,影响背景颜色和文字颜色 | default | primary | default |
| next-button-props | “下一步”按钮的属性 | Object | — |
| prev-button-props | “上一步”按钮的属性 | Object | — |
| scroll-into-view-options | 支持传递自定义的 scrollIntoView 选项,默认遵循 Tour 的 scrollIntoViewOptions 属性 | boolean | ScrollIntoViewOptions | — |
| show-close | 是否显示关闭按钮 | boolean | — |
| close-icon | 自定义关闭图标,默认为 Close | string | Component | — |
TourStep 插槽
| 名称 | 描述 |
|---|---|
| default | 自定义描述内容 |
| header | 自定义头部内容 |
TourStep 事件
| 名称 | 描述 | 参数 |
|---|---|---|
| 关闭 | 关闭时的回调函数 | Function |