`AdvancedTable` - Column reordering - Docs #3194

zamoore · 2025-09-16T22:19:14Z

📌 Summary

If merged, this PR adds eng docs for the advanced table column reorder feature.

🔗 External links

Jira ticket: HDS-XXX
Figma file: [if it applies]

👀 Component checklist

Percy was checked for any visual regression
A changelog entry was added via Changesets if needed (see templates here)

💬 Please consider using conventional comments when reviewing this PR.

📋 PCI review checklist

If applicable, I've documented a plan to revert these changes if they require more than reverting the pull request.
If applicable, I've worked with GRC to document the impact of any changes to security controls.
Examples of changes to controls include access controls, encryption, logging, etc.
If applicable, I've worked with GRC to ensure compliance due to a significant change to the in-scope PCI environment.
Examples include changes to operating systems, ports, protocols, services, cryptography-related components, PII processing code, etc.

vercel · 2025-09-16T22:19:18Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
hds-showcase	Ready	Preview	Oct 3, 2025 11:17am
hds-website	Ready	Preview	Oct 3, 2025 11:17am

jorytindall · 2025-09-21T23:16:00Z

I forgot I had already added the guidelines docs for this in the old PR. I'll let some other designers provide some feedback, but this is looking solid already!

shleewhite · 2025-09-29T19:24:38Z

website/docs/components/table/advanced-table/partials/code/how-to-use.md

+
+!!! Info
+
+Reorderable columns are not supported in instances of the Advanced Table that have nested rows.


Suggested change

Reorderable columns are not supported in instances of the Advanced Table that have nested rows.

Reorderable columns are not supported in instances of the Advanced Table that have nested rows or pinnable columns.

I followed @dchyun 's suggestion for this with "sticky" rather than "pinned". Any opinions on which one is better? Probably doesn't matter a ton.

website/docs/components/table/advanced-table/partials/guidelines/guidelines.md

jorytindall · 2025-09-26T22:54:12Z

website/docs/components/table/advanced-table/partials/code/component-api.md

+    <br /><br />
+    When called, this function receives one positional argument:
+    <ul>
+    <li>an array of reordered column keys (e.g., ['name', 'age', 'height']).</li>


Not a problem to solve in this PR, but I'm now noticing that <li>'s nested inside of these Property blocks have a larger font size than the body text and it looks a off visually.

website/docs/components/table/advanced-table/partials/code/component-api.md

website/docs/components/table/advanced-table/partials/code/how-to-use.md

heatherlarsen

@jorytindall I added a couple of notes about the guidelines tab.

website/docs/components/table/advanced-table/partials/guidelines/guidelines.md

dchyun

Changes to the content look all good to me. Just a couple questions about more content to add in other places.

website/docs/components/table/advanced-table/partials/guidelines/guidelines.md

Co-authored-by: Jory Tindall <[email protected]> Co-authored-by: shleewhite <[email protected]>

hashibot-hds added the docs-website Content updates to the documentation website label Sep 16, 2025

vercel bot deployed to Preview – hds-showcase September 16, 2025 22:20 View deployment

zamoore mentioned this pull request Sep 16, 2025

AdvancedTable column reorder docs #3133

Closed

5 tasks

vercel bot deployed to Preview – hds-showcase September 16, 2025 22:22 View deployment

vercel bot deployed to Preview – hds-website September 16, 2025 22:26 View deployment

zamoore force-pushed the zamoore/AdvancedTable/column-reordering-2__docs-p2 branch from 9f273df to ce8265a Compare September 26, 2025 17:10

vercel bot deployed to Preview – hds-showcase September 26, 2025 17:12 View deployment

zamoore marked this pull request as ready for review September 26, 2025 17:13

zamoore requested review from a team as code owners September 26, 2025 17:13

vercel bot deployed to Preview – hds-showcase September 26, 2025 17:14 View deployment

vercel bot deployed to Preview – hds-website September 26, 2025 17:18 View deployment

vercel bot deployed to Preview – hds-showcase September 26, 2025 23:02 View deployment

vercel bot deployed to Preview – hds-website September 26, 2025 23:04 View deployment

shleewhite reviewed Sep 29, 2025

View reviewed changes

jorytindall reviewed Sep 29, 2025

View reviewed changes

dchyun reviewed Sep 29, 2025

View reviewed changes

vercel bot deployed to Preview – hds-showcase September 29, 2025 20:28 View deployment

vercel bot deployed to Preview – hds-website September 29, 2025 20:30 View deployment

heatherlarsen reviewed Sep 29, 2025

View reviewed changes

vercel bot deployed to Preview – hds-showcase September 29, 2025 23:12 View deployment

vercel bot deployed to Preview – hds-website September 29, 2025 23:14 View deployment

vercel bot deployed to Preview – hds-showcase September 29, 2025 23:16 View deployment

vercel bot deployed to Preview – hds-website September 29, 2025 23:18 View deployment

alex-ju added this to the [email protected] milestone Sep 30, 2025

dchyun reviewed Sep 30, 2025

View reviewed changes

website/docs/components/table/advanced-table/partials/guidelines/guidelines.md Show resolved Hide resolved

website/docs/components/table/advanced-table/partials/guidelines/guidelines.md Show resolved Hide resolved

LilithJames-HDS requested changes Sep 30, 2025

View reviewed changes

website/docs/components/table/advanced-table/partials/guidelines/guidelines.md Show resolved Hide resolved

hashibot-hds added the showcase label Sep 30, 2025

zamoore and others added 8 commits October 1, 2025 13:55

added missing arg

5ae128a

Updated Figma link

274eb48

Updated alt text for images

6feb493

Restructuring content and applying feedback

271f7a6

Cleanup of usage, component API, and added reorderable example

7a3e887

updated accessibility section

97051f0

Added drag handle states, update reorder accessibility images

66f8564

Update images, cleanup states and anatomy

abc5ca2

heatherlarsen previously approved these changes Oct 1, 2025

View reviewed changes

dchyun dismissed heatherlarsen’s stale review via abc5ca2 October 1, 2025 19:42

dchyun force-pushed the zamoore/AdvancedTable/column-reordering-2__docs-p2 branch from a182bc1 to abc5ca2 Compare October 1, 2025 19:42

hashibot-hds removed the showcase label Oct 1, 2025

dchyun requested review from heatherlarsen and LilithJames-HDS October 1, 2025 19:43

vercel bot deployed to Preview – hds-showcase October 1, 2025 19:44 View deployment

vercel bot deployed to Preview – hds-website October 1, 2025 19:46 View deployment

jorytindall previously approved these changes Oct 1, 2025

View reviewed changes

shleewhite previously approved these changes Oct 2, 2025

View reviewed changes

heatherlarsen previously approved these changes Oct 2, 2025

View reviewed changes

chore: add default to reorder message text arg in docs

1ec0afa

shleewhite dismissed stale reviews from heatherlarsen, jorytindall, and themself via 1ec0afa October 3, 2025 11:13

vercel bot deployed to Preview – hds-showcase October 3, 2025 11:14 View deployment

vercel bot deployed to Preview – hds-website October 3, 2025 11:17 View deployment

shleewhite approved these changes Oct 3, 2025

View reviewed changes

didoo approved these changes Oct 3, 2025

View reviewed changes

shleewhite merged commit 1f06d45 into main Oct 3, 2025
11 checks passed

shleewhite deleted the zamoore/AdvancedTable/column-reordering-2__docs-p2 branch October 3, 2025 11:26

zamoore added a commit that referenced this pull request Oct 3, 2025

AdvancedTable - Column reordering - Docs (#3194)

02b7c16

Co-authored-by: Jory Tindall <[email protected]> Co-authored-by: shleewhite <[email protected]>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

`AdvancedTable` - Column reordering - Docs #3194

`AdvancedTable` - Column reordering - Docs #3194

Uh oh!

zamoore commented Sep 16, 2025

Uh oh!

vercel bot commented Sep 16, 2025 •

edited

Loading

Uh oh!

jorytindall commented Sep 21, 2025

Uh oh!

shleewhite Sep 29, 2025

Uh oh!

jorytindall Sep 29, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jorytindall Sep 26, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

heatherlarsen left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dchyun left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!


		!!! Info

		Reorderable columns are not supported in instances of the Advanced Table that have nested rows.

AdvancedTable - Column reordering - Docs #3194

AdvancedTable - Column reordering - Docs #3194

Uh oh!

Conversation

zamoore commented Sep 16, 2025

📌 Summary

🔗 External links

👀 Component checklist

Uh oh!

vercel bot commented Sep 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jorytindall commented Sep 21, 2025

Uh oh!

shleewhite Sep 29, 2025

Choose a reason for hiding this comment

Uh oh!

jorytindall Sep 29, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jorytindall Sep 26, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

heatherlarsen left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dchyun left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

`AdvancedTable` - Column reordering - Docs #3194

`AdvancedTable` - Column reordering - Docs #3194

vercel bot commented Sep 16, 2025 •

edited

Loading