Skip to content

docs(datatable): update ux docs#1470

Draft
panch1739 wants to merge 2 commits intomainfrom
docs/table
Draft

docs(datatable): update ux docs#1470
panch1739 wants to merge 2 commits intomainfrom
docs/table

Conversation

@panch1739
Copy link
Member

This PR updates docs to reflect the three different implementation for tables: bootstrap, ngx and ag grid.

@panch1739 panch1739 added documentation Improvements or additions to documentation ux Marks all UX related topics (UX team is working on or UX input is required) labels Feb 6, 2026
@panch1739 panch1739 added this to the 49.x milestone Feb 6, 2026
@panch1739
Copy link
Member Author

@timowolf whenever you have time, can you review this?

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request effectively restructures the documentation for tables by creating dedicated pages for Bootstrap tables, ngx-datatable, and AG Grid, along with a new overview page. This is a great improvement for clarity and organization. However, the datatable.md file was not fully cleaned up during this refactoring and still contains redundant information about Bootstrap tables and general comparisons. It would be beneficial to remove this legacy content to keep the file focused on ngx-datatable. I've added a few specific comments to address minor issues in the new documentation files.

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Comment on lines 28 to 43
Element provides two different approaches for the implementation of tables and data grids:

1. **Bootstrap Table** based on the standard HTML `table` for small tables showing mostly static data
2. **Datatable** (`<ngx-datatable>`) for large data sets while supporting various user interactions

There are various advantages and disadvantages to each approach depending on context and requirements.
Please check the capabilities and limitations of each approach and make sure to consider both
architectural as well as UX requirements in your decision.

Following some constraints and limitations when using the Bootstrap table approach:

- Header title is not "sticky" to stay on top when using vertical scroll bars
- Column width cannot be manually resized by the user
- No pagination support
- No inherent support for DOM and/or data virtualization as supported by ngx-datatable
- Performance issues with higher number of rows (>500), but this also depends on DOM complexity and hardware specs
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should remove this from here as its already covered above.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation ux Marks all UX related topics (UX team is working on or UX input is required)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants