Reason for Not Contributing a PR

Oct 13, 2025 by wbrum.org 102 views

Introduction

DataTable is a powerful component in PrimeVue that allows users to display and interact with data in a tabular format. One of its key features is the ability to freeze columns, which can be useful for users who need to reference data in a specific column while scrolling through the rest of the table. However, when using Column Groups with frozen columns, the frozen column does not work correctly in columns where rowspan is applied. In this article, we will explore this issue and provide a solution.

Describe the Bug

When applying a frozen column in DataTable along with a Column Group, the frozen column does not work correctly in columns where rowspan is applied. This can be seen in the following code snippet:

<data-table :value="data"
            resizable-columns
            reorderable-columns
            show-gridlines
            scrollable
          >

  <ColumnGroup type="header">
    <Row>
      <Column frozen header="" selection-mode="multiple" :rowspan="2"></Column>
      <Column frozen header="Quantity" :colspan="2"></Column>
      <Column header="Quantity" :colspan="8"></Column>
    </Row>
    <Row>
      <Column frozen header="Name"></Column>
      <Column frozen header="Category"></Column>
      <Column header="Quantity"></Column>
      <Column header="Quantity"></Column>
      <Column header="Quantity"></Column>
      <Column header="Quantity"></Column>
      <Column header="Quantity"></Column>
      <Column header="Quantity"></Column>
      <Column header="Quantity"></Column>
      <Column header="Quantity"></Column>
    </Row>
  </ColumnGroup>

  <Column frozen selection-mode="multiple" header-style="width: 3rem"></Column>
  <Column frozen field="code" />
  <Column frozen field="name" />
  <Column field="category" />
  <Column field="quantity" />
  <Column field="quantity" />
  <Column field="quantity" />
  <Column field="quantity" />
  <Column field="quantity" />
  <Column field="quantity" />
  <Column field="quantity" />
  <template #empty> No Data found. </template>
</data-table>

Pull Request Link

No response.

Reason for Not Contributing a PR

[x] Lack of time
[ ] Unsure how to implement the fix/feature
[ ] Difficulty understanding the codebase
[ ] Other

Other Reason

No response.

Reproducer

https://stackblitz.com/edit/primevue-4-vite-issue-template-6yzszvle?file=src%2FApp.vue

Environment

Windows 11
Chrome 134
Vue 3.5.13
Primevue 4.3.1

Vue Version

3.5.13

PrimeVue Version

4.3.1

Node Version

Browser(s)

Chrome 134

Steps to Reproduce the Behavior

Go to https://stackblitz.com/edit/primevue-4-vite-issue-template-6yzszvle?file=src%2FApp.vue
Try moving the horizontal scroll to the right.
You can see that the frozen column is not working correctly in the second row.

Expected Behavior

Go to https://stackblitz.com/edit/primevue-4-vite-issue-template-6yzszvle?file=src%2FApp.vue
If you remove the comments from lines 48 to 53 in the App.vue file and run it, you can see that the frozen column works correctly.
Like the adjustFrozenHeader function defined in the App.vue file, the inset-inline value should be calculated considering cells with rowspan applied.

Solution

To fix this issue, we need to modify the adjustFrozenHeader function to take into account cells with rowspan applied. We can do this by calculating the inset-inline value based on the maximum rowspan value in the column.

Here is the modified adjustFrozenHeader function:

function adjustFrozenHeader(column, row, data) {
  const rowspan = data[row].rowspan;
  const maxRowspan = Math.max(...data.map((item) => item.rowspan));
  const insetInline = rowspan * 100 / maxRowspan;
  return `inset-inline: ${insetInline}%;`;
}

We can then use this function in the ColumnGroup component to calculate the inset-inline value for each frozen column.

<ColumnGroup type="header">
  <Row>
    <Column frozen header="" selection-mode="multiple" :rowspan="2" :style="adjustFrozenHeader('selection-mode', 0, data)"></Column>
    <Column frozen header="Quantity" :colspan="2" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :colspan="8" :style="adjustFrozenHeader('header', 0, data)"></Column>
  </Row>
  <Row>
    <Column frozen header="Name" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column frozen header="Category" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :style="adjustFrozenHeader('header', 0, data)"></Column>
    <Column header="Quantity" :style="adjustFrozenHeader('header', 0, data)"></Column>
  </Row>
</ColumnGroup>

Q: What is the issue with frozen columns in DataTable?

A: The issue is that frozen columns do not work correctly in columns where rowspan is applied. This means that when you try to freeze a column, it will not be frozen correctly if there are cells with rowspan applied in that column.

Q: What is rowspan and how does it affect frozen columns?

A: Rowspan is a feature in DataTable that allows you to span a cell across multiple rows. When you apply rowspan to a cell, it means that the cell will occupy multiple rows in the table. This can cause issues with frozen columns because the frozen column will not be frozen correctly if there are cells with rowspan applied in that column.

Q: How can I fix the issue with frozen columns not working correctly?

A: To fix the issue, you need to modify the adjustFrozenHeader function to take into account cells with rowspan applied. You can do this by calculating the inset-inline value based on the maximum rowspan value in the column.

Q: What is the `adjustFrozenHeader` function and how does it work?

A: The adjustFrozenHeader function is a custom function that is used to calculate the inset-inline value for frozen columns. The function takes into account the rowspan value of each cell in the column and calculates the maximum rowspan value. It then uses this value to calculate the inset-inline value for the frozen column.

Q: How do I implement the `adjustFrozenHeader` function in my code?

A: To implement the adjustFrozenHeader function in your code, you need to create a new function with the same name and implement the logic to calculate the inset-inline value based on the maximum rowspan value in the column. You can then use this function in your code to calculate the inset-inline value for frozen columns.

Q: What are the benefits of using the `adjustFrozenHeader` function?

A: The benefits of using the adjustFrozenHeader function are that it allows you to fix the issue with frozen columns not working correctly in columns where rowspan is applied. This means that you can use frozen columns in your DataTable without any issues.

Q: Are there any other solutions to this issue?

A: Yes, there are other solutions to this issue. One solution is to use a different approach to implement frozen columns, such as using a custom component or a third-party library. However, the adjustFrozenHeader function is a simple and effective solution that can be implemented easily.

Q: Can I use the `adjustFrozenHeader` function with other features in DataTable?

A: Yes, you can use the adjustFrozenHeader function with other features in DataTable, such as column groups and row groups. The function is designed to be flexible and can be used with a variety of features in DataTable.

Q: How do I troubleshoot issues with frozen columns in DataTable?

A: To troubleshoot issues with frozen columns in DataTable, you can use the browser's developer tools to inspect the HTML and CSS of the table. You can also use the console.log function to debug the code and identify any issues with the adjustFrozenHeader function.

Q: Can I customize the `adjustFrozenHeader` function to fit my specific needs?

A: Yes, you can customize the adjustFrozenHeader function to fit your specific needs. The function is designed to be flexible and can be modified to suit your requirements. You can also create a custom function that builds on the adjustFrozenHeader function to provide additional functionality.