UIKit
7.13.0
• Stepper组件
UIKit
7.13.0
Date Components
3.1.0
Navigation
3.3.8
Stepper
size
view
import {Stepper} from '@gravity-ui/uikit';
Stepper convey progress through numbered steps. It provides a wizard-like workflow.Steppers display progress through a sequence of logical and numbered steps.
§Example
<Stepper>
<Stepper.Item>Step 1</Stepper.Item>
<Stepper.Item>Step 2</Stepper.Item>
<Stepper.Item>Step 3</Stepper.Item>
<Stepper.Item>Step 4 with very long title</Stepper.Item>
</Stepper>§Interactive items
Use onUpdate and value props with custom state to manipulate steps
<Stepper value={0} onUpdate={(id) => alert(id)}>
<Stepper.Item>Step 1</Stepper.Item>
<Stepper.Item>Step 2</Stepper.Item>
<Stepper.Item>Step 3</Stepper.Item>
<Stepper.Item>Step 4 with very long title</Stepper.Item>
</Stepper>§Different views
<Stepper>
<Stepper.Item>Step 1</Stepper.Item>
<Stepper.Item view="error">Step 2</Stepper.Item>
<Stepper.Item view="error">Step 3</Stepper.Item>
<Stepper.Item view="success">Step 4</Stepper.Item>
</Stepper>§Different sizes
<Stepper size="l">
<Stepper.Item>Step 1</Stepper.Item>
<Stepper.Item>Step 2</Stepper.Item>
<Stepper.Item>Step 3</Stepper.Item>
<Stepper.Item>Step 4</Stepper.Item>
</Stepper>§Disabled steps
<Stepper>
<Stepper.Item>Step 1</Stepper.Item>
<Stepper.Item disabled>Step 2</Stepper.Item>
<Stepper.Item disabled>Step 3</Stepper.Item>
<Stepper.Item disabled>Step 4 with very long title</Stepper.Item>
</Stepper>§Custom icons
<Stepper>
<Stepper.Item icon={<Icon data={Gear} />}>Step 1</Stepper.Item>
<Stepper.Item icon={<Icon data={Rocket} />}>Step 2</Stepper.Item>
<Stepper.Item icon={<Icon data={Cloud} />}>Step 3</Stepper.Item>
<Stepper.Item icon={<Icon data={Hammer} />}>Step 4 with very long title</Stepper.Item>
</Stepper>§Custom step separator
- >
- >
- >
<Stepper separator=">">
<Stepper.Item>Step 1</Stepper.Item>
<Stepper.Item view="error">Step 2</Stepper.Item>
<Stepper.Item view="success">Step 3</Stepper.Item>
<Stepper.Item>Step 4 with very long title</Stepper.Item>
</Stepper>§Step with floating element
<Stepper>
<Tooltip content="fancy step with tooltip">
<Stepper.Item>Step 1</Stepper.Item>
</Tooltip>
<Stepper.Item view="error">Step 2</Stepper.Item>
<Stepper.Item view="success">Step 3</Stepper.Item>
<Stepper.Item>Step 4 with very long title</Stepper.Item>
</Stepper>§Properties
| Name | Description | Type | Default |
|---|---|---|---|
| children | Stepper items. | React.ReactElement<StepperItemProps> | |
| size | Set the Step size. | "s" "m" "l" | "s" |
| value | Current selected Step id. | number string | |
| onUpdate | function for change current Step. | Function | |
| qa | data-qa HTML attribute, used for testing. | string | |
| separator | Custom separator node. | React.ReactNode | |
| className | CSS class name for the Steps container. | string | |
| style | Sets the inline style for the Steps container. | CSSProperties | |
| aria-label | Defines a string value that labels the current element. | string | |
| aria-labelledby | Identifies the element(s) that label the current element. | string | |
| aria-describedby | Identifies the element(s) that describe the object. | string |
§StepperItemProps
| Name | Description | Type | Default |
|---|---|---|---|
| id | Set Step id. Index of array element as default. | string number | |
| view | Set Step view. | "idle" "error" "success" | "idle" |
| children | Step content. | React.Node | |
| disabled | Determines whether Step is disable. | boolean | |
| icon | Custom icon node. | SVGIconData | |
| onClick | Step click handler. | React.MouseEventHandler | |
| className | CSS class name for the element. | string |
§CSS API
| Name | Description |
|---|---|
--g-stepper-gap | Gap between step items and separator. |
--g-stepper-item-text-max-width | Step item text max-width. |