# SplitPaneLayout

**Repository Path**: abbasspace/split-pane-layout

## Basic Information

- **Project Name**: SplitPaneLayout
- **Description**: 用于分割屏幕为上下或左右两部分的布局，支持自定义分割线、自定义分割线拖动区域
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-25
- **Last Updated**: 2026-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: View, layout

## README

# SplitPaneLayout

#### 介绍
用于分割屏幕为上下或左右两部分的布局，自带了类似安卓原生系统的分屏分割线，详情看截图

- 分割线
    - 自定义分割线
    - 自定义分割线拖动区域

- 分割线位置
    - 初始分割线位置
    - 百分比、精确的分割线位置

- 长宽限定
    - 百分比、精确长宽最低限定

| 竖屏预览 | 横屏预览 |
|------|------|
|   ![screenshot](screenshot/Screenshot_2026-01-25-03-41-16-52_8404d83032a5bd9be7f35d2d25879a97.jpg)   |   ![screenshot](screenshot/Screenshot_2026-01-25-03-41-26-99_8404d83032a5bd9be7f35d2d25879a97.jpg)   |

2026-1-25 合并了原有项目的pull request代码，pull request修复了以下部分：   
-   以编程方式创建布局时，子布局无法获得焦点。#18
- 以编程方式创建布局时，SplitPaneLayout 没有默认属性。#19
- 如果子对象可点击，则 splitterTouchSlop 不起作用。#21
- 如果 splitPaneLayout 只占据屏幕的一部分，则根据其百分比计算出的分割器位置不正确#22
- 当分割器可绘制对象放置在边界处时，它会部分隐藏。#23

其中比较重要的有 #21，它修复了处于复杂布局如NestedScrollView嵌套等子View消费触摸事件时，分割线触摸失效及很难触摸的问题

#### 使用说明

```xml
    <com.mobidevelop.spl.widget.SplitPaneLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:spl="http://schemas.android.com/apk/res-auto"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        spl:orientation="vertical"
        spl:splitterSize="12dip"
        spl:splitterPosition="33%"
        spl:splitterBackground="@drawable/splitter_bg_v"
        >
        <TextView
            android:layout_width="fill_parent"
            android:layout_height="wrap_content"
            android:text="Child1" />
        <TextView
            android:layout_width="fill_parent"
            android:layout_height="wrap_content"
            android:text="Child2" />
    </com.mobidevelop.spl.widget.SplitPaneLayout>
```
**注意**: 此 SplitPaneLayout **必须** 含有两个子View.     
不建议SplitPaneLayout作为根View，它没有实现onApplyWindowInsets方法，即使实现，子View的Insets可能很丑陋，最好是套一层FrameLayout或者ConstraintLayout

#### 源仓库

https://github.com/MobiDevelop/android-split-pane-layout/blob/master

此仓库是基于源仓库的功能扩展，如分割的视图精确最低长宽、百分比的视图最低长宽比例、拖拽范围等


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)