3.5 KiB
3.5 KiB
category | type | title | cover | coverDark | tag |
---|---|---|---|---|---|
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 | 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 |
- |