2024-09-09 19:23:25 +08:00
|
|
|
|
---
|
|
|
|
|
|
category: Components
|
|
|
|
|
|
group: 布局
|
|
|
|
|
|
title: Splitter
|
|
|
|
|
|
subtitle: 分隔面板
|
|
|
|
|
|
description: 分割面板用于隔离区域，展示多个内容。
|
|
|
|
|
|
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*mQmMTYq6OjYAAAAAAAAAAAAADrJ8AQ/original
|
|
|
|
|
|
coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*7v4GTo2Ely8AAAAAAAAAAAAADrJ8AQ/original
|
|
|
|
|
|
demo:
|
|
|
|
|
|
cols: 1
|
|
|
|
|
|
tag: 5.21.0
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 何时使用
|
|
|
|
|
|
|
|
|
|
|
|
需要展示多个内容，并且希望用户可以自由调整每个内容的大小。
|
|
|
|
|
|
|
|
|
|
|
|
- Splitter 组件需要通过子元素计算面板大小，因而其子元素仅支持 `Splitter.Panel`。
|
|
|
|
|
|
|
|
|
|
|
|
## 代码演示
|
|
|
|
|
|
|
|
|
|
|
|
<!-- prettier-ignore -->
|
|
|
|
|
|
<code src="./demo/size.tsx">基本用法</code>
|
|
|
|
|
|
<code src="./demo/control.tsx">受控模式</code>
|
|
|
|
|
|
<code src="./demo/vertical.tsx">垂直方向</code>
|
|
|
|
|
|
<code src="./demo/collapsible.tsx">可折叠</code>
|
|
|
|
|
|
<code src="./demo/multiple.tsx">多面板</code>
|
|
|
|
|
|
<code src="./demo/group.tsx">复杂组合</code>
|
|
|
|
|
|
<code src="./demo/debug.tsx" debug>调试</code>
|
|
|
|
|
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
|
|
|
|
|
|
通用属性参考：[通用属性](/docs/react/common-props)
|
|
|
|
|
|
|
|
|
|
|
|
### Splitter
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
|
| ------------- | ---------------- | --------------------------- | ------------ | ---- |
|
|
|
|
|
|
| layout | 布局方向 | `horizontal` \| `vertical` | `horizontal` | - |
|
|
|
|
|
|
| onResizeStart | 开始拖拽之前回调 | `(sizes: number[]) => void` | - | - |
|
|
|
|
|
|
| onResize | 面板大小变化回调 | `(sizes: number[]) => void` | - | - |
|
|
|
|
|
|
| onResizeEnd | 拖拽结束回调 | `(sizes: number[]) => void` | - | - |
|
|
|
|
|
|
|
|
|
|
|
|
### Panel
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
2024-09-11 00:03:02 +08:00
|
|
|
|
| defaultSize | 初始面板大小，支持数字 px 或者文字 '百分比%' 类型 | `number \| string` | - | - |
|
2024-09-09 19:23:25 +08:00
|
|
|
|
| min | 最小阈值，支持数字 px 或者文字 '百分比%' 类型 | `number \| string` | - | - |
|
|
|
|
|
|
| max | 最大阈值，支持数字 px 或者文字 '百分比%' 类型 | `number \| string` | - | - |
|
|
|
|
|
|
| size | 受控面板大小，支持数字 px 或者文字 '百分比%' 类型 | `number \| string` | - | - |
|
|
|
|
|
|
| collapsible | 快速折叠 | `boolean \| { start?: boolean; end?: boolean }` | `false` | - |
|
|
|
|
|
|
| resizable | 是否开启拖拽伸缩 | `boolean` | `true` | - |
|
|
|
|
|
|
|
|
|
|
|
|
## 主题变量（Design Token）
|
|
|
|
|
|
|
|
|
|
|
|
<ComponentTokenTable component='Splitter'></ComponentTokenTable>
|
