3.5 KiB
3.5 KiB
| category | type | title | cover | coverDark |
|---|---|---|---|---|
| Components | Data Display | Tour | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*8CC_Tbe3_e4AAAAAAAAAAAAADrJ8AQ/original | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*nF6hQpM0XtEAAAAAAAAAAAAADrJ8AQ/original |
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 |
- |