tdesign-react@1.16.2

🌈 1.16.2 2025-12-30

🐞 Bug Fixes

• Popup:
  • 修复 1.16.0 版本的重构导致开启 'trigger='hover' 且外部元素动态更新时，弹窗意外被关闭的问题 @RylanBot (#4046)
  • 修复 1.16.0 版本的重构导致弹窗在某些场景下位置不稳定的问题 @xiaody (#4046)
  • 完善 1.16.0 版本中关于空间不足时箭头偏移的优化方案 @RylanBot (#4042)
• Select:
  • 修复 valueDisplay 的 onClose 回调函数读取到 undefined 的问题 @RSS1102 (#4047)
  • 修复 1.15.7 版本后，开启 multiple 时，不在 options 里的 value 无法渲染的问题 @RylanBot (#4037)
  • 修复开启 filterable 后，选项变化但键盘导航高亮项未更新的问题 @RylanBot (#4037)

---

🐞 Bug Fixes

• Popup:
  • Fixed an issue where the popup would unexpectedly close when 'trigger='hover' was enabled and external elements were dynamically updated, due to the restructuring in version 1.16.0 @RylanBot (#4046)
  • Fixed an issue where the position of the popup became unstable in certain scenarios after the restructuring in version 1.16.0 @xiaody (#4046)
  • Improved the optimization for arrow offset when there is not enough space, implemented in version 1.16.0 @RylanBot (#4042)
• Select:
  • Fixed an issue where the onClose callback function of valueDisplay would receive undefined as a value @RSS1102 (#4047)
  • Fixed an issue where values that were not included in the options list could not be rendered when the multiple option was enabled after version 1.15.7 @RylanBot (#4037)
  • Fixed an issue where, after the filterable option was enabled, the highlighted items in the keyboard navigation would not update even when the options changed @RylanBot (#4037)

1.16.1

🌈 1.16.1 2025-12-22

🐞 Bug Fixes

• Textarea: 修复使用 defaultValue 或 readonly 产生的警告问题 @RylanBot (#4019)
• Text: 修复读取到 undefined 产生的报错问题 @RylanBot (#4020)
• Guide: 修复在某些场景下可能读取到 null 而产生的报错问题 @RylanBot (#4027)
• Popup:
  • 修复 1.16.0 版本的重构导致 SSR 环境下产生的报错问题 @RylanBot (#4026)
  • 修复 1.16.0 版本的重构导致嵌套场景下，内层弹窗无法正常关闭的问题 @RylanBot (#4023)

🚧 Others

• 修复 1.16.0 版本打包产物中有不存在的 sourceMap 引用而产生的警告 @RylanBot (#4022)
• TagInput: 移除 1.16.0 版本引入的多余日志 @RylanBot (#4021)

1.16.0

🌈 1.16.0 2025-12-15

🚨 Breaking Changes

• MessagePlugin: 移除消息容器的 id='tdesign-message-container--${placement}'，之前依赖该属性的业务注意此变更 ⚠️ @RylanBot (#3820)

🚀 Features

• 支持 readonly 的组件新增 API readOnly，与 readonly 效果一致。原有的 readonly 会被保留，未来版本将废弃，建议及时更换 ⚠️ @RylanBot (#3955)
• 支持 .dark 类名，丰富切换深色模式的方式 @liweijie0812 (common#2355)
• Dialog: 优化渲染阶段，避免子元素计算异常的问题，此前有在 Dialog 内进行复杂内容渲染的请注意此变更 ⚠️ @HaixingOoO (#3705)
• Form: 保留原始 HTML 效果，当输入框按下 Enter 键自动触发 submit 事件，如果需要拦截该行为，可以给输入框绑定 onEnter={(e)=>e.preventDefault()} ，此前有依赖此内置特性请注意此变更 ⚠️
• MessagePlugin: 新增开启和关闭时的动画效果 @RylanBot (#3820)
• Textarea: 支持 count API，用于自定义计数元素的渲染 @RylanBot (#4003)
• ImageViewer:
  • 新增默认 trigger 渲染 ，默认为当前使用的图片作为默认 trigger，降低组件的使用复杂度，具体参考相关示例改动 @wonkzhang (#3819)
  • 优化下载跨域图片时的格式处理和压缩比例 @RylanBot (#3919)
  • 支持直接下载同域图片，避免二次转换导致体积增大和动图失效等问题 @RylanBot (#3919)

🐞 Bug Fixes

• Textarea: 更正 status 对应的初始值与 class 名为 default，内部 class 进行了相应调整，之前有覆盖 tips 类名请注意此变更 ⚠️ @RylanBot (#4007)
• Avatar: 修复样式与设计稿不一致的问题 @liweijie0812 (common#2364)
• ConfigProvider: 修复 tag.closeIcon 不生效的问题 @RylanBot (#4004)
• Form: 修复初始化表单值时引入多余组件，导致未使用组件也被打包的问题 @RylanBot (#3965)
• Menu: 修复菜单选项默认边距和图标大小的问题 @liweijie0812 (common#2369)
• Select: 优化键盘操作过程中再次进行回车操作的使用体验 @uyarn (#3989)
• Tree: 修复子节点为自定义的 Input 等元素时，选中文本的高亮样式被隐藏的问题 @RylanBot (common#2370)
• MessagePlugin: @RylanBot (#3820)
  • 修复自定义 attach 后，后续其它全局消息也被绑定到该节点中的异常
  • 修复 closeAll 无法关闭所有消息的异常
• EnhancedTable: 修复子节点收缩时，表头全选状态异常的问题 @liweijie0812 (#3988)
• Table:
  • 修复多级表头场景下，editable 单元格编辑后数据没有同步的问题 @RylanBot (#3982)
  • 修复 onChange 的 context.currentData 在过滤场景下缺失的问题 @RylanBot (#3982)
  • 修复由于表格宽度计算时机不稳定，导致表头无法对齐、空状态不居中等问题 @RylanBot (#3972)
• Popup:
  • 修复空间不足时，箭头偏移的问题 @RylanBot (#3980)
  • 将容器的位置统一设为 absolute，修复部分场景下定位异常的问题 @RylanBot (#3916)
  • 修复 triggerElement 类型为字符串时未正确作为元素选择器解析的问题 @RylanBot (#3940)
  • 修复 children 为不支持 ref 穿透的封装组件时，弹窗无法正常出现的问题 @RylanBot (#3940)
• PopupPlugin: 修复 classPrefix 不生效的问题 @RylanBot (#3940)

1.15.9

🌈 1.15.9 2025-11-28

🚀 Features

• Cascader: 支持当 valueMode 为 all 或者 parentFirst 时，在 filterable 选项中显示非叶子节点 @lifeiFront (#3964)
• Popup: 新增多个组件实例方法，getOverlay 用于获取浮层元素，getOverlayState 用于获取浮层悬浮状态，getPopper 用于获取当前组件 popper 实例，update 用于更新浮层内容 @RSS1102 (#3925)
• Select: 支持通过键盘进行选项操作 @uyarn (#3969)
• Swiper: 支持 cardScale API，用于控制卡片的缩放比例 @RylanBot (#3978)

🐞 Bug Fixes

• Cascader: 修复 reserveKeyword 不生效的问题 @RylanBot (#3984)
• Description: 修复无边框模式下 itemLayout='vertical' 的间距问题 @mikasayw (common#2321)
• Table: 表格内容未渲染时，设置 dragSort 相关拖动事件报错的问题 @lifeiFront (#3958)
• Title: 添加兜底机制，避免错误使用 level 导致页面直接白屏的问题 @RylanBot (#3975)
• Select: 修复使用 backspace 键删除标签时，没有触发 onRemove 的问题 @RylanBot (#3961)
• Slider: 修复浮点误差导致的滑块位置异常问题 @RylanBot (#3947)
• Swiper: 修复受控模式下 current 初始化错误的问题 @HaixingOoO (#3959)
• Upload: 修复不支持文件数组上传的问题 @GATING (common#2078)
• Calendar: @shumuuu (#3938)
  • 修复当 range 为同一年内时，终止月份之后的月份选项没有正常禁用的问题
  • 修复年份选项错误地使用了月份选项禁用范围判定逻辑的问题
• Form: 修复 readonly 属性在不同组件中的兼容问题 @RylanBot (#3986)
• Form: @RylanBot (#3957)
  • 修复嵌套三层及以上的 FormList 相关方法失效的问题
  • 修复 reset 时没有触发 onValueChange 的问题
  • 修复初始化调用 setFieldsValue 时没有触发 onValuesChange 的问题
  • 修复非动态表单场景下，name 为数字或含有数字时 setFieldValues 失败的问题
  • 优化 key 的生成，更新值与当前表单值相同时不刷新元素
• Tree:
  • 修复过滤节点被意外禁用的问题 @RylanBot (#3984)
  • 修复 setData 没有自动触发 UI 刷新的问题 @RylanBot (common#2283)
• TreeSelect: @RylanBot (#3984)
  • 修复过滤节点的父节点也可以被选中的问题
  • 修复 blur 时，输入框内容没有清空的问题

🚧 Others

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

1.15.8

🌈 1.15.8 2025-11-04

🚀 Features

• Popup: 添加 onOverlayClick 事件以支持内容面板点击触发 @RSS1102 (#3927)
• CheckboxGroup: 支持 readonly API @RylanBot (#3885)
• Form: @RylanBot (#3885)
  • 支持 readonly API
  • 支持 FormRule.pattern 的类型为 string

🐞 Bug Fixes

• Select: 修复 1.15.7 版本中全选功能在分组模式下功能异常的问题 @uyarn (#3941)
• Form: 修复嵌套 FormList 无法使用 setFields 更新表单的问题 @RylanBot (#3930)
• CheckboxGroup: 修复被设为 disabled 的选项会被 checkAll 篡改状态的问题 @RylanBot (#3885)
• SubMenu: 修复自定义 popupProps 的 visible 和 onVisibleChange 不生效的问题 @RylanBot (#3912)
• DatePicker: 修复同时开启 enableTimePicker 与 needConfirm={false} 时，选择日期后未选时间就关闭弹窗的问题 @RylanBot (#3860)
• DateRangePicker: 修复同时开启 enableTimePicker 与 needConfirm={false} 时，仍需手动确认的问题 @achideal (#3860)
• Progress: 修复开启 theme='plump' 时，自定义 label 被隐藏的问题 @RylanBot (#3931)
• RadioGroup: @RylanBot
  • 修复子元素动态更新时，高亮异常的问题 (#3922)
  • 修复设置 value 为空时，高亮块没有消失的问题 (#3944)
• Tree: @RylanBot
  • 修复没开启 checkable 且 checkStrictly={false} 时，禁用父节点后，子节点依旧能被高亮的问题 (#3828)
  • 修复存在 disabled 节点时，点击半选状态的父节点无法取消全中的问题 (#3828)
  • 修复点击父节点进行全选时，disabled 节点的选中状态被篡改的问题 (#3828)
  • 修复点击 operation 区域时将该行节点 active 的异常 (#3889)

🚧 Others

• Form: 优化 getValidateMessage 方法底层的逻辑 @RylanBot (#3930)

1.15.7

🌈 1.15.7 2025-10-24

🚀 Features

• Divider: 支持 size 控制间距大小 @HaixingOoO (#3893)

🐞 Bug Fixes

• TreeSelect: 修复删除不在 data 中的选项时产生的报错 @RylanBot (#3886)
• EnhancedTable: 修复拖拽后动态关闭 dragSort，行无法正常展开的异常 @RylanBot (#3896)
• Menu: 避免在菜单折叠时隐藏 span 包裹的图标 @QuentinHsu(common#2303)
• Textarea: 修复内容超长情况下，设置 autosize 没有完整自动撑开高度，存在有滚动条的问题 @engvuchen (#3856)
• RadioGroup: 修复键盘操作时读取到 null 产生的报错 @RylanBot (#3906)
• Loading: 修复 delay 不生效的问题 @RylanBot (#3859)
• Form:
  • 修复错误消息 max 和 min 英文翻译错误 @liweijie0812(common#2304)
  • 修复嵌套 FormList 无法使用 add 正确新增表单的问题 @RylanBot (#3881)
• Select: @RylanBot (#3879)
  • 修复开启 multiple 时，disabled 的选项依旧能被删除的问题
  • 修复 disabled 且被选中的选项会被 checkAll 修改状态的问题
  • 修复存在 disabled 项时，checkAll 可选框的 checked 与 indeterminate 状态不合理的问题
• VirtualScroll: @RylanBot (#3878)
  • 修复数据在非虚拟滚动和虚拟滚动的 threshold 切换时，无法正确刷新的问题
  • 修复没开启 scroll={{type:'virtual'}}，也启动了相关计算的问题

1.15.6

🌈 1.15.6 2025-10-10

🐞 Bug Fixes

• VirtualScroll: 修复引入虚拟滚动的组件在使用子组件配合异步请求场景的组件告警问题 @uyarn (#3876)

1.15.5

🌈 1.15.5 2025-10-05

🐞 Bug Fixes

• Watermark: 修复 1.15.2 版本 SSR 场景下使用的问题 @Wesley-0808(#3873)
• Descriptions: 修复无边框模式下的边距问题 @liweijie0812 (#3873)

1.15.4

🌈 1.15.4 2025-10-01

🚀 Features

• ImageViewer: 支持 trigger 传入图片 index 参数，trigger 的 open 方法参数可能与绑定的元素触发事件存在类型差异情况，若遇到此问题请改成 ()=> open() 类似匿名函数使用 @betavs (#3827)

🐞 Bug Fixes

• Swiper: 修复在移动端中点击导航条后自动播放失效的问题 @uyarn (#3862)
• List: 移除 1.15.2 版本引入的冗余代码造成开启虚拟滚动时初始化卡顿的问题 @RylanBot (#3863)
• Select: 移除 1.15.2 版本引入的冗余代码造成开启虚拟滚动时初始化卡顿的问题 @RylanBot (#3863)

1.15.3

🌈 1.15.3 2025-09-29

🐞 Bug Fixes

• Select: 修复 OptionGroup 的 style 与 className 没有生效的问题 @uyarn (#3855)