logoAnt Design

⌘ K
  • Design
  • Development
  • Components
  • Blog
  • Resources
5.25.0
  • Components Overview
  • General
    • Button
    • FloatButton
      5.0.0
    • Icon
    • Typography
  • Layout
    • Divider
    • Flex
      5.10.0
    • Grid
    • Layout
    • Space
    • Splitter
      5.21.0
  • Navigation
    • Anchor
    • Breadcrumb
    • Dropdown
    • Menu
    • Pagination
    • Steps
    • Tabs
  • Data Entry
    • AutoComplete
    • Cascader
    • Checkbox
    • ColorPicker
      5.5.0
    • DatePicker
    • Form
    • Input
    • InputNumber
    • Mentions
    • Radio
    • Rate
    • Select
    • Slider
    • Switch
    • TimePicker
    • Transfer
    • TreeSelect
    • Upload
  • Data Display
    • Avatar
    • Badge
    • Calendar
    • Card
    • Carousel
    • Collapse
    • Descriptions
    • Empty
    • Image
    • List
    • Popover
    • QRCode
      5.1.0
    • Segmented
    • Statistic
    • Table
    • Tag
    • Timeline
    • Tooltip
    • Tour
      5.0.0
    • Tree
  • Feedback
    • Alert
    • Drawer
    • Message
    • Modal
    • Notification
    • Popconfirm
    • Progress
    • Result
    • Skeleton
    • Spin
    • Watermark
      5.1.0
  • Other
    • Affix
    • App
      5.1.0
    • ConfigProvider
    • Util
      5.13.0

Splitter

Split panels to isolate
Importimport { Splitter } from "antd";
Sourcecomponents/splitter
Docs
Edit this pageChangelog
Versionsupported since 5.21.0

Resources

Ant Design X
Ant Design Charts
Ant Design Pro
Pro Components
Ant Design Mobile
Ant Design Mini
Ant Design Web3
Ant Design Landing-Landing Templates
Scaffolds-Scaffold Market
Umi-React Application Framework
dumi-Component doc generator
qiankun-Micro-Frontends Framework
Ant Motion-Motion Solution
China Mirror 🇨🇳

Community

Awesome Ant Design
Medium
Twitter
yuque logoAnt Design in YuQue
Ant Design in Zhihu
Experience Cloud Blog
seeconf logoSEE Conf-Experience Tech Conference

Help

GitHub
Change Log
FAQ
Bug Report
Issues
Discussions
StackOverflow
SegmentFault

Ant XTech logoMore Products

yuque logoYuQue-Document Collaboration Platform
AntV logoAntV-Data Visualization
Egg logoEgg-Enterprise Node.js Framework
Kitchen logoKitchen-Sketch Toolkit
Galacean logoGalacean-Interactive Graphics Solution
xtech logoAnt Financial Experience Tech
Theme Editor
Made with ❤ by
Ant Group and Ant Design Community
loading

When To Use

Can be used to separate areas horizontally or vertically. When you need to freely drag and adjust the size of each area. When you need to specify the maximum and minimum width and height of an area.

Examples

API

Common props ref:Common props

The Splitter component needs to calculate the panel size through its child elements, so its child elements only support Splitter.Panel.

Splitter

PropertyDescriptionTypeDefaultVersion
layoutLayout directionhorizontal | verticalhorizontal-
onResizeStartCallback before dragging starts(sizes: number[]) => void--
onResizePanel size change callback(sizes: number[]) => void--
onResizeEndDrag end callback(sizes: number[]) => void--
lazyLazy modebooleanfalse5.23.0

Panel

PropertyDescriptionTypeDefaultVersion
defaultSizeInitial panel size support number for px or 'percent%' usagenumber | string--
minMinimum threshold support number for px or 'percent%' usagenumber | string--
maxMaximum threshold support number for px or 'percent%' usagenumber | string--
sizeControlled panel size support number for px or 'percent%' usagenumber | string--
collapsibleQuick foldingboolean | { start?: boolean; end?: boolean }false-
resizableWhether to enable drag and dropbooleantrue-

Design Token

Component TokenHow to use?
Token NameDescriptionTypeDefault Value
splitBarDraggableSizeDrag and drop the identity element sizenumber20
splitBarSizeDrag the element sizenumber2
splitTriggerSizeDrag and drop trigger area sizenumber6
Global TokenHow to use?
Basic

Initialize panel size, panel size limit.

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Control mode

Control the size of the splitter. When one of the panels disables resizable, dragging will be disabled.

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Vertical

Use vertical layout.

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Collapsible

Set collapsible to enable collapse. Can through min to limit dragging to expand when collapsed.

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Multiple panels

Multiple panels.

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Complex combination

Complex combination panel, quick folding, prohibited from changing size

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Lazy

Lazy mode, dragging does not update the size immediately, but updates when released.

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
5.23.0
First
Second
First
Second
First
Second
First
Second
First
Second
Panel 1
Panel 2
Panel 3
Left
Top
Bottom
First
Second
First
Second