mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-27 10:34:26 +08:00
612d5c0702
Co-authored-by: afc163 <afc163@gmail.com> Co-authored-by: KAROS\81948 <chenwenfan@harmonycloud.cn>
4.4 KiB
4.4 KiB
category | group | title | description | cover | coverDark | demo | tag | ||
---|---|---|---|---|---|---|---|---|---|
Components | Data Display | Tour | A popup component for guiding users through a product. | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*NMvqRZpuJfQAAAAAAAAAAAAADrJ8AQ/original | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*D70qQJJmzhgAAAAAAAAAAAAADrJ8AQ/original |
|
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
Custom highlighted area style
_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 |
gap | Control the radius of the highlighted area and the offset between highlighted area and the element. | { offset?: number | [number, number]; radius?: number } |
{ offset?: 6 ; radius?: 2 } |
5.0.0 (array type offset : 5.9.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 |