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 | leftleftTopleftBottomrightrightToprightBottomtoptopLefttopRightbottombottomLeftbottomRight | 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 | defaultprimary | 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 | () => HTMLElementHTMLElement | - | |
| 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 | leftleftTopleftBottomrightrightToprightBottomtoptopLefttopRightbottombottomLeftbottomRight | bottom | |
| mask | Whether to enable masking, change mask style and fill color by pass custom props, the default follows the maskproperty of Tour | boolean|{ style?: CSSProperties; color?: string; } | true | |
| type | Type, affects the background color and text color | defaultprimary | 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 scrollIntoViewOptionsproperty of Tour | boolean|ScrollIntoViewOptions | true | 
TourStep events
| Events Name | Description | Arguments | Version | |
|---|---|---|---|---|
| close | Callback function on shutdown | Function | - |