Skip to content

ColumnSettingPanel 列设置面板

xy-column-setting-panel 用来承接列表列显隐控制,让“全选、重置、手动勾选”收在一个稳定侧栏里。

基础用法

它适合挂在表格工具栏右侧,作为列配置面板的最小承载体。

列设置
当前启用列
name、owner、status

当前定位

  • 负责列勾选、重置和全选等基础交互。
  • 适合为 ProTable 或业务表格提供轻量列配置入口。

当前边界

  • 当前不处理列顺序拖拽、持久化和复杂权限裁剪。
  • 真正的列定义和表格重绘仍由外层表格组件负责。

ColumnSettingPanel API

ColumnSettingPanel Attributes

属性说明类型默认值
title面板标题string'列设置'
description标题下方的补充说明,为空时不渲染string''
columns列配置项,每项含 key / label,可选 descriptiondisabledColumnSettingPanelColumn[][]
model-value当前勾选的列 key 集合,支持 v-modelstring[][]

ColumnSettingPanel Events

事件名说明参数
update:modelValue勾选集合变化时派发(勾选或全选)(value: string[]) => void
change勾选集合变化时派发(value: string[]) => void
reset点击「重置」时派发,重置结果为未被 disabled 的全部列(value: string[]) => void