don't map values to same label

ni · Mar 21, 2024 · f28069c · f28069c
1 parent 4c2e9f8
commit f28069c
Show file tree

Hide file tree

Showing 2 changed files with 2 additions and 0 deletions.
diff --git a/...s/nimble-components/src/table-column/enum-text/tests/table-column-enum-text.mdx b/...s/nimble-components/src/table-column/enum-text/tests/table-column-enum-text.mdx
@@ -20,6 +20,7 @@ The <Tag name={tableColumnEnumTextTag}/> column renders string, number, or boole
 ### Best Practices
 
 -   Provide a mapping for every expected record value. Because grouping is performed on the record value, non-mapped record values can result in multiple groups without group labels.
+-   Avoid having multiple values that map to the same label because grouping and sorting is done on the record value rather than the mapped label.
 
 ### Blazor Usage
 

diff --git a/packages/nimble-components/src/table-column/icon/tests/table-column-icon.mdx b/packages/nimble-components/src/table-column/icon/tests/table-column-icon.mdx
@@ -23,6 +23,7 @@ The <Tag name={tableColumnIconTag}/> column renders string, number, or boolean v
 
 -   Provide a mapping for every expected record value. Because grouping is performed on the record value, non-mapped record values can result in multiple groups without group labels.
     -   To improve grouping behavior of values that don't correspond to icons, explicitly map those values to an `undefined` icon.
+-   Avoid having multiple values that map to the same label because grouping and sorting is done on the record value rather than the mapped label.
 
 ### Blazor Usage