release: 1.16.9

[RylanBot]

🤔 这个 PR 的性质是？

• 日常 bug 修复
• 新特性提交
• 文档改进
• 演示代码改进
• 组件样式/交互改进
• CI/CD 改进
• 重构
• 代码风格优化
• 测试用例
• 分支合并
• 其他

🔗 相关 Issue

💡 需求背景和解决方案

📝 更新日志

• 本条 PR 不需要纳入 Changelog

tdesign-react

@tdesign-react/chat

☑️ 请求合并前的自查清单

⚠️ 请自检并全部勾选全部选项。⚠️

• 文档已补充或无须补充
• 代码演示已提供或无须提供
• TypeScript 定义已补充或无须补充
• Changelog 已提供或无须提供

[tdesign-bot]

🎉 发布 tdesign-react

🌈 1.16.9 2026-04-23

🚀 Features

• Cascader: 支持 valueType="full" 在不同层级节点的 value 相同的场景中使用 @RylanBot (#4145)
• RadioGroup: 新增 direction API，支持添加垂直排列特性 @liweijie0812 (#4214)

🐞 Bug Fixes

• Affix: 修复 offsetBottom 模式下容器滚出视口时 top 计算为负值的问题 @RylanBot (#4172)
• Cascader:
  • 修复单选模式下，showAllLevels={false} 与 valueType="full" 配合使用时，选中状态被清空的问题 @RylanBot (#4145)
  • 修复单选模式下，再次点击选中项，面板的选中状态异常的问题 @RylanBot (#4145)
• Form:
  • 修复 1.16.4 引入的逻辑导致单独使用 FormItem 时，初始化会产生 undefined 报错的问题 @RylanBot (#4207)
  • 修复 React 19 下 Fragment 包裹 FormItem 子元素时产生的警告 @RylanBot (#4212)
• RadioGroup: 修复 variant="primary-filled" 时，某些场景下首次高亮异常的问题 @RylanBot (#4081)
• Table: 修复存在 fixed 列时，吸顶表头和吸底表尾和表格不对齐的问题 @RylanBot (#4172)

📝 Documentation

• Configprovider: 添加全局配置 Plugin 函数使用文档 @HaixingOoO (#4218)

🚧 Others

• RadioGroup: 加强组件的泛型支持，便于 value 与 onChange 联动 @RylanBot (#4081)

[tdesign-bot]

🎉 Release tdesign-react

🌈 1.16.9 2026-04-23

🚀 Features

• Cascader: Supports using valueType="full" in scenarios where values across nested nodes are the same. @RylanBot (#4145)
• RadioGroup: Added direction API to enable vertical arrangement. @liweijie0812 (#4214)

🐞 Bug Fixes

• Affix: Fixed an issue where top became negative when the container scrolled out of view in offsetBottom mode. @RylanBot (#4172)
• Cascader:
  • Fixed an issue where, in single-selection mode, the selected state was cleared when showAllLevels={false} was used with valueType="full". @RylanBot (#4145)
  • Fixed an issue where re-clicking a selected item caused abnormal behavior regarding the selected state. @RylanBot (#4145)
• Form:
  • Fixed an error that occurred during initialization when using FormItem alone, due to logic introduced in version 1.16.4. @RylanBot (#4207)
  • Fixed a warning that appeared when using Fragment to wrap FormItem elements in React 19. @RylanBot (#4212)
• RadioGroup: Fixed an issue where initial highlighting didn’t work correctly in certain scenarios when variant="primary-filled" was used. @RylanBot (#4081)
• Table: Fixed an issue where the table header and footer weren’t aligned properly when there were fixed columns. @RylanBot (#4172)

📝 Documentation

• Configprovider: Added documentation for using the global configuration Plugin function. @HaixingOoO (#4218)

🚧 Others

• RadioGroup: Improved generic support for the component, making it easier to synchronize value and onChange events. @RylanBot (#4081)

[tdesign-bot]

TDesign Component Site Preview Open

Component	Preview
tdesign-react
@tdesign-react/chat

[github-actions]

Size Change: +1 B (0%)

Total Size: 916 kB

📦 View Changed

Filename	Size	Change
packages/tdesign-react/dist/tdesign.js	503 kB	+1 B (0%)

ℹ️ View Unchanged

Filename	Size
packages/tdesign-react/dist/reset.css	1.93 kB
packages/tdesign-react/dist/tdesign.css	60.1 kB
packages/tdesign-react/dist/tdesign.min.css	54.6 kB
packages/tdesign-react/dist/tdesign.min.js	296 kB

_{compressed-size-action}