61 lines
3.5 KiB
Markdown
61 lines
3.5 KiB
Markdown
---
|
|
category: Components
|
|
type: Data Display
|
|
title: Tour
|
|
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*8CC_Tbe3_e4AAAAAAAAAAAAADrJ8AQ/original
|
|
coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*nF6hQpM0XtEAAAAAAAAAAAAADrJ8AQ/original
|
|
tag: New
|
|
---
|
|
|
|
A popup component for guiding users through a product. Available since `4.0.0`.
|
|
|
|
## When To Use
|
|
|
|
Use when you want to guide users through a product.
|
|
|
|
## API
|
|
|
|
### Tour
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| arrow | Whether to show the arrow, including the configuration whether to point to the center of the element | `boolean`\|`{ pointAtCenter: boolean}` | `true` | |
|
|
| placement | Position of the guide card relative to the target element | `left` `leftTop` `leftBottom` `right` `rightTop` `rightBottom` `top` `topLeft` `topRight` `bottom` `bottomLeft` `bottomRight` | `bottom` | |
|
|
| mask | Whether to enable masking, change mask style and fill color by pass custom props | `boolean` \| `{ style?: CSSProperties; color?: string; }` | `true` | |
|
|
| type | Type, affects the background color and text color | `default` `primary` | `default` | |
|
|
| open | Open tour | `boolean` | - | |
|
|
| current(v-model) | What is the current step | `number` | - | |
|
|
| scrollIntoViewOptions | support pass custom scrollIntoView options | `boolean` \| `ScrollIntoViewOptions` | `true` | |
|
|
| indicatorsRender | custom indicator | `v-slot:indicatorsRender="{current, total}"` | - | |
|
|
| zIndex | Tour's zIndex | `number` | `1001` | |
|
|
|
|
### Tour events
|
|
|
|
| Events Name | Description | Arguments | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| close | Callback function on shutdown | `Function` | - | |
|
|
| finish | Callback function on finished | `Function` | - | |
|
|
| change | Callback when the step changes. Current is the previous step | `(current: number) => void` |
|
|
|
|
### TourStep
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| target | Get the element the guide card points to. Empty makes it show in center of screen | `() => HTMLElement` `HTMLElement` | - | |
|
|
| arrow | Whether to show the arrow, including the configuration whether to point to the center of the element | `boolean` `{ pointAtCenter: boolean}` | `true` | |
|
|
| cover | Displayed pictures or videos | `VueNode` | - | |
|
|
| title | title | `VueNode` | - | |
|
|
| description | description | `VueNode` | - | |
|
|
| placement | Position of the guide card relative to the target element | `left` `leftTop` `leftBottom` `right` `rightTop` `rightBottom` `top` `topLeft` `topRight` `bottom` `bottomLeft` `bottomRight` | `bottom` | |
|
|
| mask | Whether to enable masking, change mask style and fill color by pass custom props, the default follows the `mask` property of Tour | `boolean` \| `{ style?: CSSProperties; color?: string; }` | `true` | |
|
|
| type | Type, affects the background color and text color | `default` `primary` | `default` | |
|
|
| nextButtonProps | Properties of the Next button | `{ children: VueNode; onClick: Function }` | - | |
|
|
| prevButtonProps | Properties of the previous button | `{ children: VueNode; onClick: Function }` | - | |
|
|
| scrollIntoViewOptions | support pass custom scrollIntoView options, the default follows the `scrollIntoViewOptions` property of Tour | `boolean` \| `ScrollIntoViewOptions` | `true` | |
|
|
|
|
### TourStep events
|
|
|
|
| Events Name | Description | Arguments | Version |
|
|
| ----------- | ----------------------------- | ---------- | ------- | --- |
|
|
| close | Callback function on shutdown | `Function` | - | |
|