docs: Clarify column visibility toggle labels

[ckdwns9121]

What changed

• Updated the React column visibility guide to avoid rendering column.columnDef.header directly in a visibility toggle menu.
• Added a stable label-map example for column visibility controls.
• Added a note explaining that columnDef.header is a header render template and should be rendered with flexRender when rendering actual headers, while visibility menus should use stable text labels.

Why

column.columnDef.header can be a string or render template that needs header context. In a visibility menu we are rendering column objects, and hidden columns may not have an active header context. This caused confusion in #5751 when JSX/template headers were used as toggle labels.

Validation

• pnpm prettier --write docs/framework/react/guide/column-visibility.md
• pnpm test:docs

Related: #5751

Summary by CodeRabbit

• Documentation
  • Updated the React column visibility guide to use stable, column ID-based labels in visibility toggle menus.
  • Added guidance explaining that column header templates require context and may not be suitable for toggle labels.
  • Recommended defining custom text labels for consistent visibility controls.

[coderabbitai]

📝 Walkthrough

Walkthrough

The React column visibility guide now defines stable labels keyed by column ID, uses them in visibility toggle checkboxes, and explains why column.columnDef.header should not be used directly for toggle menu labels.

Changes

Column visibility documentation

Layer / File(s)	Summary
Stable labels for visibility toggles docs/framework/react/guide/column-visibility.md	The example adds an ID-keyed columnLabels map, uses it for checkbox text with an ID fallback, and documents the header render template constraint.

Estimated code review effort: 1 (Trivial) | ~2 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the docs update about using stable labels for column visibility toggles.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}