Skip to content

Split 分割线

使用
import { KSplit } from "@ksware/ksw-ux";

用于分割面板内容。

基础用法

使用v-model指定初始分割比例。

横纵方向

使用direction指定分割线方向。

容器类型

使用component指定容器类型。

自定义初始化比例

在不使用v-model指定初始分割比例,可使用defaultSize设置面板初始分割比例。

嵌套

限制拖动范围

使用minmax限制拖动范围。

禁用拖动

使用disabled禁止拖动

自定义分割线

使用triggerIcon自定义分割线图标。

隐藏图标

使用showTrigger隐藏分割线图标。

API

Props

参数名描述类型默认值
v-model / modelValue绑定左右面板比例(目前只支持px和0-1之间的数字,不支持rem以及百分比等单位)number | string-
default-size初始左右面板比例(目前只支持px和0-1之间的数字,不支持rem以及百分比等单位)number | string0.5
component面板容器string'div'
direction分割线方向'horizontal' | 'vertical''horizontal'
min左侧面板最小宽度boolean-
max左侧面板最大宽度boolean-
disabled是否禁用booleanfalse
trigger-icon分割线图标string | Component-
show-trigger是否显示分割线图标booleantrue
pane1-class左侧面板类名string-
pane2-class右侧面板类名string-
pane1-style左侧面板样式CSSProperties-
pane2-style右侧面板样式CSSProperties-

Events

事件名描述类型
move-start分割线开始拖动时触发Function
moving分割线拖动中触发Function
move-end分割线结束拖动时触发Function

Slots

插槽名描述参数
first左侧面板内容-
second右侧面板内容-
trigger分割线-
trigger-icon分割线图标-

贡献者

布局切换

调整 VitePress 的布局样式,以适配不同的阅读习惯和屏幕环境。

全部展开
使侧边栏和内容区域占据整个屏幕的全部宽度。
全部展开,但侧边栏宽度可调
侧边栏宽度可调,但内容区域宽度不变,调整后的侧边栏将可以占据整个屏幕的最大宽度。
全部展开,且侧边栏和内容区域宽度均可调
侧边栏宽度可调,但内容区域宽度不变,调整后的侧边栏将可以占据整个屏幕的最大宽度。
原始宽度
原始的 VitePress 默认布局宽度

页面最大宽度

调整 VitePress 布局中页面的宽度,以适配不同的阅读习惯和屏幕环境。

调整页面最大宽度
一个可调整的滑块,用于选择和自定义页面最大宽度。

内容最大宽度

调整 VitePress 布局中内容区域的宽度,以适配不同的阅读习惯和屏幕环境。

调整内容最大宽度
一个可调整的滑块,用于选择和自定义内容最大宽度。

聚光灯

支持在正文中高亮当前鼠标悬停的行和元素,以优化阅读和专注困难的用户的阅读体验。

ON开启
开启聚光灯。
OFF关闭
关闭聚光灯。

聚光灯样式

调整聚光灯的样式。

置于底部
在当前鼠标悬停的元素下方添加一个纯色背景以突出显示当前鼠标悬停的位置。
置于侧边
在当前鼠标悬停的元素旁边添加一条固定的纯色线以突出显示当前鼠标悬停的位置。