mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-05 05:28:20 +08:00
4ecc0d7f95
* docs: optimize overview svg * docs: update * docs: dark
4.1 KiB
4.1 KiB
category | group | title | cover | coverDark | demo | tag | ||
---|---|---|---|---|---|---|---|---|
Components | Data Display | Tour | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*NMvqRZpuJfQAAAAAAAAAAAAADrJ8AQ/original | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*D70qQJJmzhgAAAAAAAAAAAAADrJ8AQ/original |
|
New |
A popup component for guiding users through a product. Available since 5.0.0
.
When To Use
Use when you want to guide users through a product.
Examples
Basic
Non-modal
Placement
Custom mask style
Custom indicator
_InternalPanelDoNotUseOrYouWillBeFired
API
Common props ref:Common props
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 |
|
closeIcon | Customize close icon | React.ReactNode |
true |
5.9.0 |
disabledInteraction | Disable interaction on highlighted area. | boolean |
false |
5.13.0 |
placement | Position of the guide card relative to the target element | center left leftTop leftBottom right rightTop rightBottom top topLeft topRight bottom bottomLeft bottomRight |
bottom |
|
onClose | Callback function on shutdown | Function |
- | |
mask | Whether to enable masking, change mask style and fill color by pass custom props | boolean | { style?: React.CSSProperties; color?: string; } |
true |
|
type | Type, affects the background color and text color | default primary |
default |
|
open | Open tour | boolean |
- | |
onChange | Callback when the step changes. Current is the previous step | (current: number) => void |
- | |
current | What is the current step | number |
- | |
scrollIntoViewOptions | support pass custom scrollIntoView options | boolean | ScrollIntoViewOptions |
true |
5.2.0 |
indicatorsRender | custom indicator | (current: number, total: number) => ReactNode |
- | 5.2.0 |
zIndex | Tour's zIndex | number | 1001 | 5.3.0 |
getPopupContainer | Set the rendering node of Tour floating layer | (node: HTMLElement) => HTMLElement |
body | 5.12.0 |
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 |
|
closeIcon | Customize close icon | React.ReactNode |
true |
5.9.0 |
cover | Displayed pictures or videos | ReactNode |
- | |
title | title | ReactNode |
- | |
description | description | ReactNode |
- | |
placement | Position of the guide card relative to the target element | center left leftTop leftBottom right rightTop rightBottom top topLeft topRight bottom bottomLeft bottomRight |
bottom |
|
onClose | Callback function on shutdown | Function |
- | |
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?: React.CSSProperties; color?: string; } |
true |
|
type | Type, affects the background color and text color | default primary |
default |
|
nextButtonProps | Properties of the Next button | { children: ReactNode; onClick: Function } |
- | |
prevButtonProps | Properties of the previous button | { children: ReactNode; onClick: Function } |
- | |
scrollIntoViewOptions | support pass custom scrollIntoView options, the default follows the scrollIntoViewOptions property of Tour |
boolean | ScrollIntoViewOptions |
true |
5.2.0 |