Splitter 分割器 beta
将区域水平或垂直分割,并可以自由拖动以调整各区域的大小。
基础用法
最基础用法,如果没有传递默认大小,它将自动等分。
垂直布局
使用垂直布局。
可收起
通过配置 collapsible 提供快速收缩能力。你可以使用 min 属性来防止折叠后通过拖动展开。
禁用拖拽
当其中任意面板禁用了 resizable 时,将禁用拖拽。
面板大小
v-model:size 可以获取面板大小。
延迟更新 2.11.0
开启 lazy 时,面板大小在拖拽过程中不会实时更新,而是在拖拽结束后才更新。
Splitter API
Splitter 属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| layout | 分割器的布局方向 | 枚举 | horizontal |
| lazy 2.11.0 | 是否开启延迟更新模式 | boolean | false |
Splitter 事件
| 名称 | 描述 | type |
|---|---|---|
| resize-start | 开始调整面板大小时触发,index 是拖动条的索引 | Function |
| 调整大小 | 调整面板大小时触发,index 是拖动条的索引 | Function |
| resize-end | 面板调整大小结束时触发,index 是拖动条的索引 | Function |
| collapse 2.10.3 | 面板折叠时触发,index 是拖动条的索引 | Function |
SplitterPanel API
SplitterPanel 属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| size / v-model:size | 面板的大小(像素或百分比) | string / number | - |
| min | 面板的最小尺寸(像素或百分比) | string / number | - |
| max | 面板的最大尺寸(像素或百分比) | string / number | - |
| resizable | 面板是否可以调整大小 | boolean | true |
| collapsible | 面板是否可以收起 | boolean | false |
SplitterPanel 事件
| 名称 | 描述 | type |
|---|---|---|
| update:size | 面板大小改变时触发 | Function |
SplitterPanel 插槽
| 名称 | 描述 |
|---|---|
| default | 面板的默认内容 |
| start-collapsible | 自定义起始端收起按钮的内容 |
| end-collapsible | 自定义末尾端收起按钮的内容 |
SplitterPanel 暴露的方法
| 名称 | 描述 | 类型 |
|---|---|---|
| splitterPanelRef 2.11.9 | SplitterPanel HTML 元素 | object |