@gfazioli/mantine-split-pane

中文文档
4.1.20发布于 2026/11/09MITTypeScriptESM + CJS零依赖近 30 天下载 2.7万

A Mantine 9 React component for resizable split pane layouts with 7 resizer variants, context-based prop inheritance, responsive orientation, and dynamic pane generation.

原始使用文档
文档目录9 节
  1. Overview
  2. Features
  3. Split vs Mantine core Splitter
  4. Installation
  5. Usage
  6. Auto Resizers
  7. Snap Points
  8. Dynamic Panes
  9. Sponsor

Mantine Split Pane Component

Mantine Split Pane

mantine-split-pane at a glance, refreshed daily: commits, releases, stars, issues and pull requests, a year of commit activity, the weekly rhythm, languages, latest commits and releases, contributors
Made with glancecard · refreshed daily

Overview

A Mantine 9 React component for resizable split pane layouts with 7 resizer variants, context-based prop inheritance, responsive orientation, and dynamic pane generation.

This component is created on top of the Mantine library. It requires Mantine 9.x and React 19.

[!note]

→ Demo and Documentation → Youtube Video → More Mantine Components

Features

  • Separate Split.Pane (content) and Split.Resizer (drag handle) architecture
  • 7 resizer variants: default, filled, outline, transparent, gradient, dotted, dashed
  • Initial sizes in pixels or percentages with min/max constraints
  • grow property to let specific panes expand to fill available space
  • Horizontal and vertical orientation, including responsive breakpoints
  • Context-based prop inheritance: resizer props set on Split cascade to all children
  • Per-resizer overrides for full control
  • Snap points for common pane sizes during drag and keyboard resizing
  • autoResizers mode to automatically insert resizers between panes
  • Split.Dynamic helper to generate panes from a configuration array
  • Resize lifecycle events (onResizeStart, onResizing, onResizeEnd) on both pane and resizer — fired on drag, keyboard resize, and double-click reset
  • Custom content inside Split.Resizer for drag-affordance icons, labels, or fully bespoke handles
  • Keyboard accessible: focusable resizer with configurable step and shiftStep
  • Container resize tracking with drag ratio preservation

Split vs Mantine core Splitter

Since v9.3, Mantine core ships its own Splitter component. The basics overlap, but the two make different trade-offs:

  • Fully customizable resizer — Split.Resizer is a standalone component with 7 variants, gradients, hover states, knob, custom cursors and custom content; core's Splitter renders a separator line with a grip icon
  • Snap points — panes snap to predefined sizes while dragging or resizing with the keyboard (snapPoints, onSnap); not available in core
  • CSS-unit sizing — pane sizes and constraints accept px, %, rem (initialWidth, minWidth, ...), while core works with percentages that must sum to 100
  • Responsive everything — orientation, pane sizes, min/max and snap points accept Mantine breakpoint maps; core's orientation and sizes are plain values
  • Config-driven layouts — Split.Dynamic generates panes and resizers from a PaneConfig[] array

Core's Splitter shines for simple proportional layouts and ships collapsible panes plus the headless use-splitter hook. See the full comparison in the documentation.

Installation

npm install @gfazioli/mantine-split-pane

or

yarn add @gfazioli/mantine-split-pane

After installation import package styles at the root of your application:

import '@gfazioli/mantine-split-pane/styles.css';

Usage

import { Split } from '@gfazioli/mantine-split-pane';
import { Paper } from '@mantine/core';

function Demo() {
  return (
    <Split>
      <Split.Pane>
        <Paper withBorder w="100%" mih="100%">
          <h1>Pane 1</h1>
        </Paper>
      </Split.Pane>

      <Split.Resizer />

      <Split.Pane>
        <Paper withBorder>
          <h1>Pane 2</h1>
        </Paper>
      </Split.Pane>
    </Split>
  );
}

Auto Resizers

Use the autoResizers prop to automatically insert resizers between panes:

import { Split } from '@gfazioli/mantine-split-pane';
import { Paper } from '@mantine/core';

function Demo() {
  return (
    <Split autoResizers>
      <Split.Pane>
        <Paper withBorder w="100%" mih="100%">
          <h1>Pane 1</h1>
        </Paper>
      </Split.Pane>

      <Split.Pane>
        <Paper withBorder>
          <h1>Pane 2</h1>
        </Paper>
      </Split.Pane>

      <Split.Pane>
        <Paper withBorder>
          <h1>Pane 3</h1>
        </Paper>
      </Split.Pane>
    </Split>
  );
}

Snap Points

Use snapPoints and snapTolerance to snap a resizer to common pane sizes in pixels while dragging or using the keyboard:

import { Split } from '@gfazioli/mantine-split-pane';
import { Paper } from '@mantine/core';

function Demo() {
  return (
    <Split autoResizers snapPoints={[200, 400, 600]} snapTolerance={20}>
      <Split.Pane initialWidth={240}>
        <Paper withBorder w="100%" mih="100%">
          <h1>Pane 1</h1>
        </Paper>
      </Split.Pane>

      <Split.Pane initialWidth={320}>
        <Paper withBorder w="100%" mih="100%">
          <h1>Pane 2</h1>
        </Paper>
      </Split.Pane>

      <Split.Pane grow>
        <Paper withBorder w="100%" mih="100%">
          <h1>Pane 3</h1>
        </Paper>
      </Split.Pane>
    </Split>
  );
}

snapPoints and snapTolerance are also available on Split.Resizer for per-divider overrides. With autoResizers, the generated resizers inherit these values from Split.

Dynamic Panes

You can also use Split.Dynamic to create panes from a configuration array:

import { Split, PaneConfig } from '@gfazioli/mantine-split-pane';
import { Paper } from '@mantine/core';

function Demo() {
  const panes: PaneConfig[] = [
    {
      id: 'sidebar',
      initialWidth: 200,
      minWidth: 150,
      content: (
        <Paper withBorder w="100%" h="100%">
          <h1>Sidebar</h1>
        </Paper>
      ),
    },
    {
      id: 'main',
      grow: true,
      content: (
        <Paper withBorder w="100%" h="100%">
          <h1>Main Content</h1>
        </Paper>
      ),
    },
  ];

  return (
    <Split>
      {Split.Dynamic({ panes })}
    </Split>
  );
}

Sponsor

Your support helps me:

  • Keep the project actively maintained with timely bug fixes and security updates
  • Add new features, improve performance, and refine the developer experience
  • Expand test coverage and documentation for smoother adoption
  • Ensure long-term sustainability without relying on ad hoc free time
  • Prioritize community requests and roadmap items that matter most

Open source thrives when those who benefit can give back—even a small monthly contribution makes a real difference. Sponsorships help cover maintenance time, infrastructure, and the countless invisible tasks that keep a project healthy.

Your help truly matters.

💚 Become a sponsor today and help me keep this project reliable, up-to-date, and growing for everyone.


https://github.com/user-attachments/assets/2e45af2b-60c7-4cb3-9b9a-6cf0e710af1c

版本与发布记录

@gfazioli/mantine-split-pane 共发布 93 个版本,首次发布于 2024/02/28;过去 12 个月发布了 43 个版本。

版本发布日期距今
4.1.20latest2026/11/096 天前
4.1.192026/11/069 天前
4.1.182026/10/2621 天前
4.1.172026/10/2224 天前
4.1.162026/10/131 个月前
4.1.152026/10/101 个月前

关于 @gfazioli/mantine-split-pane 的常见问题

@gfazioli/mantine-split-pane 是什么?

A Mantine 9 React component for resizable split pane layouts with 7 resizer variants, context-based prop inheritance, responsive orientation, and dynamic pane generation.

如何安装 @gfazioli/mantine-split-pane?

在项目目录运行 npm install @gfazioli/mantine-split-pane,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.x || ^19.x)、react-dom(^18.x || ^19.x)、@mantine/core(>=9.0.0)、@mantine/hooks(>=9.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gfazioli/mantine-split-pane 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gfazioli/mantine-split-pane 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gfazioli/mantine-split-pane 可以商用吗?

@gfazioli/mantine-split-pane 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gfazioli/mantine-split-pane 的下载量有多少?

根据 npm 官方下载统计,@gfazioli/mantine-split-pane 在 2026/10/17 – 2026/11/15 这 30 天内被下载 27,007 次,日均约 900 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gfazioli/mantine-split-pane 还在维护吗?

最新版本 4.1.20 发布于 2026/11/09(6 天前);至今共发布 93 个版本,其中过去 12 个月发布了 43 个;首次发布于 2024/02/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。