vue 表格组件 vxe-table 自定义树表格连接线的样式类型和线颜色

树表格连接线用于直观表达父子层级。vxe-table 通过 treeConfig.showLine 开启连接线后，还可以进一步自定义线型（实线 / 虚线 / 点线）和颜色。颜色有两种设置方式：treeConfig.lineColor 组件级配置，以及 CSS 变量 --vxe-ui-table-tree-node-line-color 全局设置。两者作用范围不同，可组合使用。

vxe-table 如何修改树表格连接线的样式类型？

在 treeConfig 中设置 showLine: true 开启连接线，再通过 lineType 指定线型。支持 'solid'（实线）、'dashed'（虚线）、'dotted'（点线）。

  • 生效前提：
    • treeConfig.showLine 必须为 true，否则 lineType 不生效。
    • 表格需启用树形结构，树节点列设置 treeNode: true。
    • transform: true 时，数据以平铺数组提供，通过 rowField 与 parentField 建立父子关系。
      预期结果：树节点连接线由默认实线变为指定线型，展开、收起时线条样式保持一致。

vxe-table 如何修改树表格连接线的颜色？

有两种方式。方式一，在 treeConfig 中设置 lineColor，仅作用于当前表格；方式二，通过 CSS 变量 --vxe-ui-table-tree-node-line-color 设置，可全局生效或按类名局部生效。

两种方式的区别：

方式 配置位置 作用范围 适用场景
treeConfig.lineColor 表格配置 当前表格实例 单个表格需要独立颜色
CSS 变量 --vxe-ui-table-tree-node-line-color 样式文件 / 组件 style 变量作用域内所有表格 全局统一主题色，或按容器批量

treeConfig.lineColor 是组件级配置，通常优先于 CSS 变量。若两者同时设置，以组件配置为准；具体行为以实际版本为准。

修改连接线样式

通过配置 tree-config.lineType 来设置连接线的样式类型，支持实线/虚线/点线

image

image

<template>
  <div>
    <vxe-grid v-bind="gridOptions"></vxe-grid>
  </div>
</template>

<script setup>
import { reactive } from 'vue'

const gridOptions = reactive({
  showOverflow: true,
  border: 'outer',
  stripe: true,
  rowConfig: {
    useKey: true
  },
  columnConfig: {
    resizable: true
  },
  checkboxConfig: {
    labelField: 'name'
  },
  treeConfig: {
    transform: true,
    showLine: true,
    lineType: 'dashed'
  },
  columns: [
    { type: 'checkbox', treeNode: true },
    { field: 'size', title: 'Size' },
    { field: 'type', title: 'Type' },
    { field: 'date', title: 'Date' }
  ],
  data: [
    { id: 1e4, parentId: null, name: 'Test1', type: 'mp3', size: 1024, date: '2020-08-01' },
    { id: 10050, parentId: null, name: 'Test2', type: 'mp4', size: 0, date: '2021-04-01' },
    { id: 24300, parentId: 10050, name: 'Test3', type: 'avi', size: 1024, date: '2020-03-01' },
    { id: 20045, parentId: 24300, name: 'Test4', type: 'html', size: 600, date: '2021-04-01' },
    { id: 10053, parentId: 24300, name: 'Test5', type: 'avi', size: 0, date: '2021-04-01' },
    { id: 24330, parentId: 10053, name: 'Test6', type: 'txt', size: 25, date: '2021-10-01' },
    { id: 21011, parentId: 10053, name: 'Test7', type: 'pdf', size: 512, date: '2020-01-01' },
    { id: 22200, parentId: 10053, name: 'Test8', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23666, parentId: null, name: 'Test9', type: 'xlsx', size: 2048, date: '2020-11-01' },
    { id: 23677, parentId: 23666, name: 'Test10', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23671, parentId: 23677, name: 'Test11', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23672, parentId: 23677, name: 'Test12', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23688, parentId: 23666, name: 'Test13', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23681, parentId: 23688, name: 'Test14', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23682, parentId: 23688, name: 'Test15', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 24555, parentId: null, name: 'Test16', type: 'avi', size: 224, date: '2020-10-01' },
    { id: 24566, parentId: 24555, name: 'Test17', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 24577, parentId: 24555, name: 'Test18', type: 'js', size: 1024, date: '2021-06-01' }
  ]
})
</script>

自定义线颜色

支持多种方式，通过 css 变量 --vxe-ui-table-tree-node-line-color 来全局设置；还可以通过 tree-config.lineColor 来设置连接线颜色

image

<template>
  <div>
    <vxe-grid class="my-table" v-bind="gridOptions"></vxe-grid>
  </div>
</template>

<script setup>
import { ref, reactive } from 'vue'

const gridOptions = reactive({
  showOverflow: true,
  border: 'outer',
  rowConfig: {
    useKey: true
  },
  columnConfig: {
    resizable: true
  },
  treeConfig: {
    transform: true,
    showLine: true
  },
  columns: [
    { field: 'name', title: 'Name', treeNode: true },
    { field: 'size', title: 'Size' },
    { field: 'type', title: 'Type' },
    { field: 'date', title: 'Date' }
  ],
  data: [
    { id: 1e4, parentId: null, name: 'Test1', type: 'mp3', size: 1024, date: '2020-08-01' },
    { id: 10050, parentId: null, name: 'Test2', type: 'mp4', size: 0, date: '2021-04-01' },
    { id: 24300, parentId: 10050, name: 'Test3', type: 'avi', size: 1024, date: '2020-03-01' },
    { id: 20045, parentId: 24300, name: 'Test4', type: 'html', size: 600, date: '2021-04-01' },
    { id: 10053, parentId: 24300, name: 'Test5', type: 'avi', size: 0, date: '2021-04-01' },
    { id: 24330, parentId: 10053, name: 'Test6', type: 'txt', size: 25, date: '2021-10-01' },
    { id: 21011, parentId: 10053, name: 'Test7', type: 'pdf', size: 512, date: '2020-01-01' },
    { id: 22200, parentId: 10053, name: 'Test8', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23666, parentId: null, name: 'Test9', type: 'xlsx', size: 2048, date: '2020-11-01' },
    { id: 23677, parentId: 23666, name: 'Test10', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23671, parentId: 23677, name: 'Test11', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23672, parentId: 23677, name: 'Test12', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23688, parentId: 23666, name: 'Test13', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23681, parentId: 23688, name: 'Test14', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 23682, parentId: 23688, name: 'Test15', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 24555, parentId: null, name: 'Test16', type: 'avi', size: 224, date: '2020-10-01' },
    { id: 24566, parentId: 24555, name: 'Test17', type: 'js', size: 1024, date: '2021-06-01' },
    { id: 24577, parentId: 24555, name: 'Test18', type: 'js', size: 1024, date: '2021-06-01' }
  ]
})
</script>

<style>
.my-table {
  --vxe-ui-table-tree-node-line-color: #FF0000;
}
</style>

通过 treeConfig.lineColor 设置颜色

若只需单个表格使用特定颜色，直接在树配置中设置更直接：

treeConfig: {
  transform: true,
  showLine: true,
  lineColor: '#FF0000' // 仅作用于当前表格
}

效果一样，但配置写在表格配置内，不依赖外部样式。

关键配置参数

配置项 类型 默认值 说明
treeConfig.showLine Boolean false 是否显示连接线，总开关
treeConfig.lineType String 'solid' 线型：'solid' 实线 / 'dashed' 虚线 / 'dotted' 点线
treeConfig.lineColor String 主题默认 连接线颜色，仅作用于当前表格
--vxe-ui-table-tree-node-line-color CSS 变量 主题默认 连接线颜色，作用于变量作用域内所有表格
treeConfig.showRootLine Boolean false 是否显示根节点连接线
列 treeNode Boolean false 标记树节点列，连接线在此列渲染
treeConfig.transform Boolean false 平铺数据转树形结构
treeConfig.rowField String — 行主键字段
treeConfig.parentField String — 父级字段，null 表示根节点

线型与颜色的组合建议

场景 推荐 lineType 推荐颜色方式
默认浅色主题 solid 主题默认，或 lineColor 略深于背景
深色主题 solid CSS 变量全局设置浅色线条，保证对比度
强调层级但希望弱化线条 dashed 与文字同色系、较低透明度
打印或高对比度场景 solid 深色，如 #333333
多表格主题隔离 任意 类名 + CSS 变量，按容器批量控制

https://vxetable.cn

posted @ 2026-11-13 17:34  独行者r2  阅读(8)  评论(0)    收藏  举报