Advanced Table Expand Collapse All Documentation

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

@@ -144,6 +144,7 @@ Sticky headers keep column labels visible while scrolling, aiding navigation in
 
 ![](/assets/components/table/advanced-table/advanced-table-sticky-header.png)  
 
+
 ### Expandable rows
 
 Expandable rows let users show or hide more content without navigating away from the table. The expanded content should align with the header labels, even if the parent row includes minimal data.
@@ -167,7 +168,54 @@ Avoid using different density settings for parent and child rows.
 
 !!!
 
+### Expand/Collapse All Control
+
+#### Button Behavior
+
+The button expands first unless all rows have already been expanded, and then it switches to Collapse All. 
+- Manual expanding/collapsing does not change the button state.
+- If users collapse rows individually, the button stays Expand All until all rows are collapsed.
+
+#### Interactions
+
+#### Default State
+
+The table can load with any combination of expanded or collapsed rows.
+The button reflects the initial state:
+- Expand All if any rows are collapsed.
+- Collapse All if all rows are expanded.
+
+#### Expanding All Rows
+
+Clicking Expand All expands everything, including nested rows.
+- The button updates to Collapse All.
+
+#### Mixed State
+
+Some rows are expanded while others are collapsed.
+The button stays Expand All, as its following action will expand all collapsed rows.
+- Clicking Expand All in this state expands everything and updates the button to Collapse All.
+Expanding from a Mixed State
+- Clicking Expand All expands all rows, including manually collapsed ones.
+- The button updates to Collapse All.
+
+#### Button States
+
+The button updates based on the current expansion state of the table:
+
+- Expand All will display when all rows are collapsed.
+
+![](/assets/components/table/advanced-table/expandable-rows-collapsed-state.png)
+
+- Collapse All will display when all rows are expanded.
+
+![](/assets/components/table/advanced-table/expandable-rows-expanded-state.png)  
+
+- Mixed State displays when some, but not all, rows are expanded.
 
+![](/assets/components/table/advanced-table/expandable-rows-mixed-state.png) 
+<Doc::ImageCaption @text="The mixed state provides a visual cue that expansion states vary within the table. Selecting the button in this state expands all rows.
+"/> -->
 ### Striping 
 
 !!! Info