2022-04-11 11:13:16 +08:00
|
|
|
---
|
|
|
|
|
category: Components
|
2022-11-09 12:28:04 +08:00
|
|
|
group: Data Display
|
2022-04-11 11:13:16 +08:00
|
|
|
title: Segmented
|
|
|
|
|
cover: https://gw.alipayobjects.com/zos/bmw-prod/a3ff040f-24ba-43e0-92e9-c845df1612ad.svg
|
2022-11-09 12:28:04 +08:00
|
|
|
demo:
|
|
|
|
|
cols: 2
|
2022-04-11 11:13:16 +08:00
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Segmented Controls. This component is available since `antd@4.20.0`.
|
|
|
|
|
|
|
|
|
|
## When To Use
|
|
|
|
|
|
|
|
|
|
- When displaying multiple options and user can select a single option;
|
|
|
|
|
- When switching the selected option, the content of the associated area changes.
|
|
|
|
|
|
2022-11-09 12:28:04 +08:00
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
<code src="./demo/basic.tsx">Basic</code>
|
|
|
|
|
<code src="./demo/block.tsx">Block Segmented</code>
|
|
|
|
|
<code src="./demo/disabled.tsx">Basic</code>
|
|
|
|
|
<code src="./demo/controlled.tsx">Controlled mode</code>
|
|
|
|
|
<code src="./demo/custom.tsx">Custom Render</code>
|
|
|
|
|
<code src="./demo/dynamic.tsx">Dynamic</code>
|
|
|
|
|
<code src="./demo/size.tsx">Three sizes of Segmented</code>
|
|
|
|
|
<code src="./demo/with-icon.tsx">With Icon</code>
|
|
|
|
|
<code src="./demo/icon-only.tsx">With Icon only</code>
|
|
|
|
|
<code src="./demo/controlled-two.tsx" debug>Controlled Synced mode</code>
|
|
|
|
|
<code src="./demo/size-consistent.tsx" debug>Consistent height</code>
|
|
|
|
|
|
2022-04-11 11:13:16 +08:00
|
|
|
## API
|
|
|
|
|
|
|
|
|
|
> This component is available since `antd@4.20.0`
|
|
|
|
|
|
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| block | Option to fit width to its parent\'s width | boolean | false | |
|
|
|
|
|
| defaultValue | Default selected value | string \| number | | |
|
|
|
|
|
| disabled | Disable all segments | boolean | false | |
|
2022-04-23 21:00:05 +08:00
|
|
|
| onChange | The callback function that is triggered when the state changes | function(value: string \| number) | | |
|
2022-06-09 21:39:35 +08:00
|
|
|
| options | Set children optional | string\[] \| number\[] \| Array<{ label: ReactNode value: string icon? ReactNode disabled?: boolean className?: string }> | [] | |
|
2022-04-11 11:13:16 +08:00
|
|
|
| size | The size of the Segmented. | `large` \| `middle` \| `small` | - | |
|
|
|
|
|
| value | Currently selected value | string \| number | | |
|
