You need to enable JavaScript to run this app. Java Swing JTable如何在表格左侧添加行表头(垂直表头)
优惠活动
大模型
产品
解决方案
定价
更多

Java Swing JTable如何在表格左侧添加行表头(垂直表头)

Swing表格实现左侧垂直行表头的方案

原生JTable仅内置了顶部水平方向的列表头支持,没有自带左侧垂直行表头的功能,实现起来不需要复杂的自定义布局,直接借助JScrollPane预留的行表头视口区域就能完成。

实现原理

配套的JScrollPane本身划分了四个独立的视口区域,每个区域的布局和滚动行为都是自动适配的:

  • 顶部视口:默认关联JTable自带的水平列表头,会和主表格的水平滚动条同步移动
  • 左侧视口:专门预留用来放置垂直行表头,会自动和主表格的垂直滚动条同步滚动,位置刚好紧贴主表格左侧边缘
  • 中间视口:承载主表格的核心内容单元格
  • 边缘视口:可自由放置侧边自定义组件

只要把渲染行标签的组件绑定到左侧视口,就能实现垂直行表头的效果,完全不需要手动计算行位置、监听滚动事件对齐。

原代码的小问题

你当前编写的代码存在一个维度错配的隐患:初始化表格时传入的列标题数组长度为n(也就是表格行数),虽然当前代码里n和m取值相同没有触发运行报错,但实际列标题的数组长度必须和表格的列数严格相等,后续调整行列数量时很容易出现数组越界问题。

可直接运行的完整实现

import javax.swing.*;
import java.awt.*;

public class Table {
    public static void main(String[] args) {
        int rowCount = 5;
        int columnCount = 5;

        // 初始化表格二维数据
        String[][] tableData = new String[rowCount][columnCount];
        // 水平列标题
        String[] horizontalHeader = new String[columnCount];
        // 垂直行标题
        String[] verticalHeader = new String[rowCount];

        // 填充两类表头内容
        for (int i = 0; i < columnCount; i++) {
            horizontalHeader[i] = "column" + i;
        }
        for (int i = 0; i < rowCount; i++) {
            verticalHeader[i] = "row" + i;
        }

        // 填充表格单元格
        for (int i = 0; i < rowCount; i++) {
            for (int j = 0; j < columnCount; j++) {
                tableData[i][j] = "value";
            }
        }

        JFrame frame = new JFrame("Table");
        JTable table = new JTable(tableData, horizontalHeader);
        // 统一设置行高,保证和行表头组件完全对齐
        table.setRowHeight(25);
        JScrollPane scrollPane = new JScrollPane(table);

        // 构建左侧垂直行表头组件
        JList<String> rowHeaderComponent = new JList<>(verticalHeader);
        // 设置行表头固定宽度
        rowHeaderComponent.setFixedCellWidth(60);
        // 行高和主表格保持一致,逐行精准对齐
        rowHeaderComponent.setFixedCellHeight(table.getRowHeight());
        // 调整样式和原生表格表头视觉统一
        rowHeaderComponent.setBackground(new Color(235, 235, 235));
        rowHeaderComponent.setBorder(UIManager.getBorder("TableHeader.border"));

        // 将行表头组件绑定到滚动窗格的左侧行表头视口
        scrollPane.setRowHeaderView(rowHeaderComponent);

        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.add(scrollPane, BorderLayout.CENTER);
        frame.setSize(500, 500);
        frame.setVisible(true);
    }
}

最终效果

运行上述代码后:

  • 顶部会正常展示已经配置完成的水平列表头
  • 表格左侧会出现独立的行表头栏,逐行展示自定义的垂直行标签
  • 滚动表格内容时,左侧行表头会和单元格完全同步移动,没有错位
  • 行表头的边框、背景色和系统原生表头风格一致,不会有突兀的视觉差异

内容的提问来源于stack exchange,提问作者user6485971

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 12:24:05