Releases: Tencent/tdesign
TDesign Weekly Release (Feb 2nd 2026)
React for Mobile 发布 0.21.2
🌈 0.21.2 2026-02-10
🚀 Features
Icon: 新增 217 个与人工智能、文档、徽标和文件相关的图标 @uyarn(#872)Cascader: @anlyyao (#865)- 新增
overlayProps、header和middleContent属性 - pick 事件新增
label和level参数,其中level表示选中项所在层级深度,index为选项中的索引
- 新增
Search:
🐞 Bug Fixes
Popup: 修复在Firefox浏览器中的闪烁问题 @anlyyao (#874)Search: 修复通过CSS Vars修改图标大小无效 @liweijie0812 (#878)Upload: 修复capture属性无效,并补充boolean类型 @anlyyao (#875)
详情见: https://github.com/Tencent/tdesign-mobile-react/releases/tag/0.21.2
TDesign Weekly Release (Feb 1st 2026)
Vue3 for Web 发布 tdesign-vue-next@1.18.2
🌈 1.18.2 2026-02-05
🐞 Bug Fixes
DateRangePicker: 修复1.18.1版本needConfirm为 false 时,修改被还原的问题 @liweijie0812 (#6410)
详情见: https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.18.2
Vue3 for Web 发布 tdesign-vue-next@1.18.1
🌈 1.18.1 2026-02-04
🚀 Features
DatePicker:- 新增
onClear清空按钮点击时触发事件 @Wesley-0808 (#6316) presets支持自定义渲染,用于配置精确时分秒等预设场景 @uyarn (#6316)- 新增
disableTimeAPI,用于配置时间选择器中被禁用的时间 @Wesley-0808 (#6316) - 新增
range和panelActiveDateAPI,用于支持定义日期选择范围,具体使用请参考示例 @Wesley-0808 (#6316)
- 新增
DateRangePicker:disabledAPI 新增支持数组类型,用于单独禁用开始日期或结束日期 @uyarn (#6390)- 新增
range和panelActiveDateAPI,用于支持定义日期选择范围,具体使用请参考示例 @Wesley-0808 (#6316)
Icon: 新增 217 个与人工智能、文档、徽标和文件相关的图标 @RADWIMPS426 @uyarn (#6367)Menu: 支持菜单面板在空间不足时的自动反转 @RSS1102 (#6392)RangeInput:disabled支持数组形式配置,用于单独禁用左区间或右区间 @RSS1102 (#5648)
🐞 Bug Fixes
Cascader: 修复 useCascaderContext 传递 disabled 失效问题 @liweijie0812 (#6332)DateRangePicker: 修复needConfirm为 false,点击预设无效的问题 @liweijie0812 (#6388)Drawer: 优化开启sizeDraggable功能时,调整当前抽屉尺寸后没有实时计算的问题 @yrc2333 (#6328)InputNumber: 修复大数计算前导零被错误清除的问题 @Liumingxun (common#2394)Menu: 修复侧边导航菜单收起时,内容为插槽方式 Tooltip 无法生效的问题 @liweijie0812 (#6341)Table: 修复远程分页场景下全选逻辑错误,在1.18.0版本的问题 @RSS1102 (#6393)Transfer: 修复disabled为数组时功能不生效的问题 @RSS1102 (#5648)
📝 Documentation
Dialog: 补充与嵌套弹窗相关使用问题的文档 @engvuchen (#5847)
详情见: https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.18.1
Miniprogram for WeChat 发布 tdesign-miniprogram@1.12.3
🌈 1.12.3 2026-02-03
🚀 Features
ActionSheet: 为items子项的icon字段新增object类型,支持透传到TIcon组件 @anlyyao (#4251)Button: 新增activity-type,entrance-path和need-show-entrance属性 @anlyyao (#4220)ChatActionbar: 支持长按展示 @mimaoxiao (#4071)Icon: 新增 217 个与人工智能、文档、徽标和文件相关的图标 @uyarn (#4207)Search: 为change事件新增trigger参数,表示触发源 @anlyyao (#4223)
🐞 Bug Fixes
ChatContent: 修复英文单词在换行时被截断的问题 @mimaoxiao (#4226)Popup: 修复duration参数无效的问题 @novlan1 (#4201)
详情见: https://github.com/Tencent/tdesign-miniprogram/releases/tag/tdesign-miniprogram@1.12.3
UniApp for Mobile 发布 @tdesign/uniapp@0.7.1
🌈 0.7.1 2026-02-04
🚀 Features
ActionSheet: 为items子项的icon字段新增object类型,支持透传到TIcon组件 @novlan1 (#4255)Button: 新增activity-type,entrance-path和need-show-entrance属性 @novlan1 (#4255)Icon: 新增 217 个与人工智能、文档、徽标和文件相关的图标 @novlan1 (#4255)Search: 为change事件新增trigger参数,表示触发源 @novlan1 (#4255)
详情见: https://github.com/Tencent/tdesign-miniprogram/releases/tag/@tdesign/uniapp@0.7.1
TDesign Weekly Release (Jan 4th 2026)
React for Web 发布 tdesign-react@1.16.5
🌈 1.16.5 2026-01-28
🚀 Features
Dialog: 增强dialogClassName属性以支持多种格式 @RSS1102 (#4096)Icon: 新增 217 个与人工智能、文档、徽标和文件相关的图标 @uyarn (#4097)ImageViewer: 添加innerClassName,内容部分的类名,支持多种格式 @RSS1102 (#4087)
🐞 Bug Fixes
Cascader: 修复在弹出层可见期间,滚动位置被意外更新的问题 @RylanBot (#4094)Dialog: 修复1.16.4版本导致点击蒙层时,onOverlayClick和onClose无法触发的问题 @RylanBot (#4098)ImageViewer: 修复className和style属性失效的问题 @RSS1102 (#4087)Popup:Typography: 修复开启ellipsis时,将一个完整英文单词切割放在两行的问题 @RylanBot (#3997)
🚧 Others
详情见: https://github.com/Tencent/tdesign-react/releases/tag/tdesign-react@1.16.5
Vue3 for Mobile 发布 1.13.0
🌈 1.13.0 2026-01-23
🚨 Breaking Changes
🚀 Features
ActionSheet: 新增ActionSheetPlugin导出,提供独立的函数式调用API@anlyyao (#2122)Icon: 新增 217 个与人工智能、文档、徽标和文件相关的图标 @uyarn(#2131)Search: 新增cursorColor属性 @anlyyao (#2116)Badge: @anlyyao (#2114)shape属性新增ribbon-right/ribbon-left/triangle-right/triangle-left可选项,其中ribbon与ribbon-right等效- 优化
ribbon实现,改用background: linear-gradient(),移除伪元素相关样式
🐞 Bug Fixes
Sticky: 修复container为Vue Ref对象时报错 @anlyyao (#2130)Upload: 移除默认值'',增强capture类型,解决移动端只能调用摄像头的问题 @anlyyao (#2132)ActionSheet: @anlyyao (#2122)- 修复按需引入时组件和函数式调用混用导致表现不一致的问题
- 修复函数式调用时控制台告警
详情见: https://github.com/Tencent/tdesign-mobile-vue/releases/tag/1.13.0
UniApp for Mobile 发布 @tdesign/uniapp@0.7.0
🌈 0.7.0 2026-01-30
🚀 Features
ActionSheet:item属性补充description字段 @novlan1 (#4201)Badge:Calendar: 新增allowSameDay属性,允许type='range'场景的起止时间相同 @novlan1 (#4201)Cascader:CollapsePanel: 新增--td-collapse-disabled-color和--td-collapse-left-icon-color,用于自定义禁用态颜色和左侧图标颜色 @novlan1 (#4201)ImageViewer: 新增image-props属性 @novlan1 (#4201)Navbar: 新增placeholder属性,默认值为false;新增zIndex属性,默认值为1@novlan1 (#4201)Picker:Popover:QRCode: 组件新增init(),用于外部调用,重新绘制二维码 @novlan1 (#4201)Search:SidebarItem:TabBar: 新增placeholder属性,默认值为false;新增zIndex属性,默认值为1@novlan1 (#4201)
🐞 Bug Fixes
ActionSheet:BackTop: 修复文本字重错误 @novlan1 (#4201)Badge: 修复count插槽异常 @novlan1 (#4201)Calendar:Checkbox: 修复icon属性使用svg资源时在iOS上不显示 @novlan1 (#4201)CollapsePanel:ColorPicker: 修复组件深色模式背景、边框、文本色错误 @novlan1 (#4201)DateTimePicker: 修复插槽名重复导致的控制台告警 @novlan1 (#4201)DropdownItem: 修复在iOS 26中弹窗定位不准 @novlan1 (#4201)Fab: 修复yBounds未传值时,控制台报错问题 @novlan1 (#4201)Grid: 修复column小于 4 或大于 4 时,文本字号大小错误 @novlan1 (#4201)Message: 修复error主题图标错误 @novlan1 (#4201)Picker:Popup: 修复duration参数无效的问题 @novlan1 (#4201)Progress:Slider: 修复受控 + 双游标滑块模式下陷入死循环的问题 @novlan1 (#4201)SwipeCell: 消除IntersectionObserver is using slowest path警告 @novlan1 (#4201)TabBar: 修复子项背景色叠加的问题 @novlan1 (#4201)Tabs: 消除IntersectionObserver is using slowest path警告 @novlan1 (#4201)Toast:Upload:- 修复企业微信/桌面端环境中部分机型无法唤起上传 @novlan1 ([#4201](https://github.com/Tencent/tdesign-miniprogram/pull...
TDesign Weekly Release (Jan 3rd 2026)
Vue2 for Web 发布 1.14.5
🌈 1.14.5 2026-01-21
🐞 Bug Fixes
Table: 修复远程分页场景下,全选逻辑错误引起展示异常的问题 @RSS1102 (#3801)Menu: 修复在 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#3797)Menu: 修复1.14.2后 menu-item 绝对定位样式丢失导致层级设置不生效的问题 @RSS1102 (#3804)Select: 修复在 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#3797)TreeSelect: 修复在 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#3797)Cascader: 修复在 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#3797)Table: 优化存在固定表头或表尾场景滚动后表格位置异常的问题 @uyarn (#3805)
详情见: https://github.com/Tencent/tdesign-vue/releases/tag/1.14.5
React for Web 发布 tdesign-react@1.16.4
🌈 1.16.4 2026-01-16
🚀 Features
DatePicker:presets支持 ReactNode,用于完全自定义渲染 @uyarn (#4089)Dialog: @RylanBot (#3950)- 支持
mode="full-screen"的弹窗 - 支持
draggable在mode="modeless"生效
- 支持
Form: 支持getFieldsValue和getFieldValue返回未渲染的数值 @RylanBot (#4050)
🐞 Bug Fixes
Cascader:- 修复在弹出层可见期间,滚动位置被意外更新的问题 @RylanBot (#4062)
- 优化 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#4056)
Dialog:Form:FormList: @RylanBot (#4005)- 修复子节点存在另一个 Form 时,部分 API 异常的问题
- 修复结合
shouldUpdate使用时,initialData不生效的问题 - 修复
add过程中缺乏拷贝从而污染用户原始数据的问题 @RylanBot
InputNumber: 修复大数计算前导零被错误清除的问题 @Liumingxun (common#2394)Menu: 优化 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#4056)Popup:Select:- 修复
tagInputProps.tagProps不生效的问题 @RylanBot (#4070) - 优化 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#4056)
- 修复
SelectInput: @RylanBot (#4070)- 修复
1.16.0版本的修复导致点击closable图标时无法清除选项的问题 - 修复传入
tagInputProps.tagProps.onClose时,onTagChange不生效的问题
- 修复
Text: 修复在关闭copyable的Tooltip时,元素未同步隐藏的问题 @RylanBot (#4067)Textarea: 修复count计算逻辑没有遵循maxcharacter或maxlength的问题 @RylanBot (#4088)TreeSelect: 优化 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#4056)
🚧 Others
Form: 调整useForm返回实例的 TS 类型,避免内部变量的暴露 @RylanBot (#4050)Message: 新增组件的displayName@TidySongS (#4074)
详情见: https://github.com/Tencent/tdesign-react/releases/tag/tdesign-react@1.16.4
Miniprogram for WeChat 发布 tdesign-miniprogram@1.12.2
🌈 1.12.2 2026-01-21
🚀 Features
Cascader: 新增middle-content插槽,用于自定义中间区域内容 @anlyyao (#4194)CollapsePanel: 新增--td-collapse-disabled-color和--td-collapse-left-icon-color,用于自定义禁用态颜色和左侧图标颜色 @anlyyao @liweijie0812 (#4185)Popover: 新增--td-popover-[theme]-color和--td-popover-[theme]-bg-color系列CSS Vars@Wesley-0808 (#4169)QRCode: 组件新增init(),用于外部调用,重新绘制二维码 @anlyyao (#4174)SideBarItem: 完善激活项的前缀和后缀元素显示逻辑 @anlyyao (#4175)Slider: 修复受控 + 双游标滑块模式下陷入死循环的问题 @Boomkaa (#4170)
🐞 Bug Fixes
ChatList: 修复scrollToBottom在reverse为false时,滑动的方向错误 @zydemail (#4191)CollapsePanel:- 修复深色模式下面板右侧图标颜色错误 @liweijie0812 (#4185)
- 修复左侧图标颜色错误,默认主题色,支持使用
css vars自定义 @anlyyao @liweijie0812 (#4185)
Picker: 修复popupProps.showOverlay无效 @anlyyao (#4203)Popover: 修复控制台告警问题 @Wesley-0808 (#4169)Upload: 修复拖拽结束后拖拽元素zIndex异常 @anlyyao (#4199)
详情见: https://github.com/Tencent/tdesign-miniprogram/releases/tag/tdesign-miniprogram@1.12.2
Flutter for Mobile 发布 0.2.7
🌈 0.2.7 2026-01-21
🚀 Features
TDInput: TDInput密文模式下支持粘贴 @jflin19990707 (#827)TDDropdownMenu: TDDropdownMenu的arrowIcon颜色可自定义 @jflin19990707 (#831)TDInput: TDInput高度自适应 @jflin19990707 (#840)TDCalendar: 允许月历控件在拖动后返回当前月份,用于延迟加载月份改变数据 @rxnh8256 (#816)TDActionSheetItem: 支持设置cell描述信息的能力 @leenc123 (#811)TDBottomTabBar: tabbar新增indicatorAnimation动画属性 @journeyding (#848)
🐞 Bug Fixes
TDPopup: 底部弹出popup重绘问题 @jflin19990707 (#826)TDropdownMenu: TDropdownMenu分组菜单多选模式下的返回值bug @jflin19990707 (#828)TDTable: TDTable中TDTableCol的索引BUG @jflin19990707 (#830)TDTreeSelect: 树形选择器异步数据更新后能重新渲染;二级菜单文字过长处理一下;TDSelectOption中的value改为dynamic类型 @jflin19990707 (#834)TDToast: TDToast过长溢出问题 @jflin19990707 (#839)TDDropdownItem: TDDropdownItem不兼容TDMultiCascader @jflin19990707 (#846)TDCalendar: 自定义日期单元格组件移除padding,使之沾满并覆盖默认选中样式从而实现自定义选中以及当前日期的样式问题,并增加日期锚点属性来实现自动滚动到锚点位置 @leenc123 (#808)DropdownMenu: 修复 item 的 label 过长时导致显示不完全的 bug @edram (#823)TDRadio、TDCheckbox: 单选框、多选框多列展示问题 @jflin19990707 (#841)TDNavBar: 优化标题栏返回图标 支持暗黑模式 @sinianbao (#844)
🚧 Others
详情见: https://github.com/Tencent/tdesign-flutter/releases/tag/0.2.7
TDesign Weekly Release (Jan 2nd 2026)
Vue3 for Web 发布 tdesign-vue-next@1.18.0
🌈 1.18.0 2026-01-08
🚀 Features
DialogPlugin: 支持接收 ConfigProvider 的全局配置,如自定义前缀 @Wesley-0808 @uyarn @Copilot (#6212)DrawerPlugin: 支持接收 ConfigProvider 的全局配置,如自定义前缀 @Wesley-0808 @uyarn @Copilot (#6212)Form: 自定义校验方法validator新增context回调参数,包括formData和name用于 JSON Schema 等生成式表单场景 @uyarn (#6321)LoadingPlugin: 支持接收 ConfigProvider 的全局配置,如自定义前缀 @Wesley-0808 @uyarn @Copilot (#6212)MessagePlugin: 支持接收 ConfigProvider 的全局配置,如自定义前缀 @Wesley-0808 @uyarn @Copilot (#6212)NotificationPlugin:- 新增
className和styleAPI,支持自定义通知框类、内联样式 @Wesley-0808 (#6307) - 支持接收 ConfigProvider 的全局配置,如自定义前缀 @Wesley-0808 @uyarn @Copilot (#6212)
- 新增
TagInput: 修复横向滚动模式下增删选项滚动条位置异常的问题 @liweijie0812 @Copilot (#6213)Upload: 新增支持 .ai、.ps、.eps 等支持的文件类型 @uyarn (common#2374) (#6324)Calendar:rangeAPI 支持单独设置开始范围或结束范围 @shumuuu (#6211)
🐞 Bug Fixes
Cascader: 修复在 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#6312)EnhancedTable: 修复行选中收缩后, 表格头全选状态异常的问题 @Copilot (#6208)Image: 修复 loading 和 error 状态下的字体大小问题 @Nero978 @RADWIMPS426 (common#2383)ImageViewer:- 修复不支持 trigger 配置无触发器的场景使用的问题 @uyarn (#6302)
- 修复无法使用插槽自定义预览标题的问题 @betavs (#6277)
- 优化开启
close-on-overlay时,缩小图片后新增的空白区域无法正常关闭预览的问题 @QuentinHsu (#6235) - 修正
zIndex默认值为 3000,此前为错误的 2600,如有涉及层级覆盖请注意此变更⚠️ @liweijie0812 (#6128)
List: 修复 ListItem 的默认边距和多余底部分割线问题 @Nero978 @liweijie0812 (common#2386) (common#2382) (#6324)Menu: 修复在 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#6312)Select: 修复在 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#6312)Slider: 修复v-model修改数组单个元素时响应式失效的问题 @RSS1102 (#6313)Swiper: 修复type='card'时,宽度计算不稳定的问题 @RylanBot (#6185)Table: 修复列配置弹窗打开时不触发回调事件的问题 @tuzixiangs (#6174)Tabs: 修复当宽度增加到足以适合所有标签时,滚动状态不会取消的问题 @Wesley-0808 @Copilot (#6293)Textarea: 修复无法直接通过 height 配置高度的问题 @engvuchen (#6040)Tooltip: 修复Tooltip配合Textarea使用在空内容下的错误 @engvuchen (#6040)TreeSelect: 修复在 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#6312)HeadMenu: 修复使用 JSX 动态渲染 MenuItem 时控制台警告的问题 @Copilot (#6221)Popup: 修复页面缩放后 onScrollToBottom 事件无法触发的问题 @Copilot (#6205)Table:TreeSelect: 修复label插槽不生效的问题 @RSS1102 (#6294)Upload: 修复1.17.4自定义上传按钮但未定义点击事件时,点击按钮无效的问题 @Wesley-0808 (#6280)
详情见: https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.18.0
TDesign Weekly Release (Jan 1st 2026)
React for Web 发布 tdesign-react@1.16.3
🌈 1.16.3 2026-01-04
🐞 Bug Fixes
Dialog: 修复1.16.0的优化导致无法使用esc键关闭嵌套对话框的问题 @RylanBot (#4030)Popup: @RylanBot (#4057)- 修复
1.16.0版本的重构导致trigger为 SVG 等元素时弹出层无法出现的问题 - 修复
1.16.0版本的重构导致trigger被disabled依旧能触发弹出层的问题
- 修复
详情见: https://github.com/Tencent/tdesign-react/releases/tag/tdesign-react@1.16.3
TDesign Weekly Release (Dec 4th 2025)
Vue2 for Web 发布 1.14.4
🌈 1.14.4 2025-12-26
🐞 Bug Fixes
详情见: https://github.com/Tencent/tdesign-vue/releases/tag/1.14.4
Vue2 for Web 发布 1.14.3
🌈 1.14.3 2025-12-23
🚀 Features
ImageViewer:- 优化下载跨域图片时的格式处理和压缩比例 @RylanBot (common#2311)
- 支持直接下载同域图片,避免二次转换导致体积增大和动图失效等问题 @RylanBot (common#2311)
Popup: 新增onOverlayClick事件,支持内容面板点击时触发 @RSS1102 (#3752)
🐞 Bug Fixes
Avatar: 修复样式与设计稿不一致的问题 @liweijie0812 (common#2364)Menu: 修复菜单选项默认边距和图标大小的问题 @liweijie0812 (common#2369)Table: 修复行选中收缩后,表格头全选状态异常的问题 @liweijie0812 (#3771)Upload: 修复不支持文件数组上传的问题 @GATING (common#2078)Upload: 修复theme为image-flow的告警问题 @uyarn (#3782)
详情见: https://github.com/Tencent/tdesign-vue/releases/tag/1.14.3
React for Web 发布 tdesign-react@1.16.2
🌈 1.16.2 2025-12-30
🐞 Bug Fixes
Popup:Select:
详情见: https://github.com/Tencent/tdesign-react/releases/tag/tdesign-react@1.16.2
React for Web 发布 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:
🚧 Others
- 修复
1.16.0版本打包产物中有不存在的sourceMap引用而产生的警告 @RylanBot (#4022) TagInput: 移除1.16.0版本引入的多余日志 @RylanBot (#4021)
详情见: https://github.com/Tencent/tdesign-react/releases/tag/1.16.1
Miniprogram for WeChat 发布 1.12.1
🌈 1.12.1 2025-12-31
🚀 Features
Navbar: 新增placeholder属性,默认值为false;新增zIndex属性,默认值为1@anlyyao (#4116)TabBar: 新增placeholder属性,默认值为false;新增zIndex属性,默认值为1@anlyyao (#4116)Badge: @anlyyao (#4137)shape属性新增ribbon-right/ribbon-left/triangle-right/triangle-left可选项,其中ribbon与ribbon-right等效- 优化
ribbon实现,改用background: linear-gradient(),移除伪元素相关样式
Popover: 新增fixedAPI,适用于触发元素为fixed场景。⚠️ 当触发元素为fixed时,除了需要显示指定fixed属性为true,还需在触发元素层添加t-popover-wrapper--fixed类,用于定位触发元素。@Wesley-0808 (#4114)Search: @anlyyao (#4150)- 确保点击清空按钮后,组件内容清空但保持聚焦
- 新增
cursor-color属性
🐞 Bug Fixes
ChatContent: 修复角色为system时文本颜色错误 @anlyyao (#4112)Toast: 修复Toast嵌套调用时close回调陷入循环的问题 @anlyyao (#4110)Attachments: 修复删除按钮在华为pure70机型上显示不完整的问题 @waiterxiaoyy (#4124)DateTimePicker: 修复插槽名重复导致的控制台告警 @anlyyao (#4126)Picker:- 优化性能减少掉帧 @jarmywang @Boomkaa (#4120)
- 修复平铺模式
value变化未能准确监听 @jarmywang (#4120)
ColorPicker: 补充styleIsolation配置项,解决外部样式无法覆盖组件样式问题 @anlyyao (#4138)SwipeCell: 消除IntersectionObserver is using slowest path警告 @anlyyao (#4139)Tabs: 消除IntersectionObserver is using slowest path警告 @anlyyao (#4139)Progress: @anlyyao (#4153)- 修复深色模式下环形进度条内部背景色错误
- 修复环形进度条内部文本间距错误
详情见: https://github.com/Tencent/tdesign-miniprogram/releases/tag/1.12.1
React for Mobile 发布 0.21.1
🌈 0.21.1 2025-12-25
🚀 Features
ActionSheet:item属性补充description、suffixIcon字段 @anlyyao (#845)Badge: @anlyyao (#855)shape属性新增ribbon-right/ribbon-left/triangle-right/triangle-left可选项,其中ribbon与ribbon-right等效- 优化
ribbon实现,改用background: linear-gradient(),移除伪元素相关样式
Navbar: 新增placeholder属性,默认值为false;新增zIndex属性,默认值为1@anlyyao (#852)TabBar: 新增placeholder属性,默认值为false;新增zIndex属性,默认值为1@anlyyao (#852)
🐞 Bug Fixes
ActionSheet: @anlyyao (#845)- 修复左对齐场景下,子项
border左间距错误 - 修复
grid主题,description描述文本行高错误 - 修复
grid主题 + 无description描述文本场景下,顶部间距错误 list主题最后一项不应设置底边框
- 修复左对齐场景下,子项
Picker: 修复swipeDuration属性无效的问题 @Ryan-CW-Code (#848)
🚧 Others
feat: 新增支持.dark类名,丰富切换深色模式的方式 @liweijie0812 (#851)
详情见: https://github.com/Tencent/tdesign-mobile-react/releases/tag/0.21.1
TDesign Weekly Release (Dec 3rd 2025)
Vue3 for Web 发布 tdesign-vue-next@1.17.7
🌈 1.17.7 2025-12-18
🚀 Features
ImageViewer:- 优化下载跨域图片时的格式处理,优化通过下载获取的文件大小 @RylanBot (common#2311) (#6270)
- 支持直接下载同域图片,避免二次转换导致体积增大和动图失效等问题 @RylanBot (common#2311) (#6270)
- 支持 .dark 类名,丰富切换深色模式的方式 @liweijie0812 (common#2355)
🐞 Bug Fixes
Avatar: 修复样式与设计稿不一致的问题 @liweijie0812 (common#2364) (#6270)DatePicker: 修复按需引入组件且开启时间面板时打包后丢失部分样式的问题 @uyarn (#6257)DateRangePicker: 修复在表单中使用且携带default-time参数时,二次选择会置空数据的缺陷 @RSS1102 (#6268)Dropdown: 修复编辑器提示缺少TDropdownMenu类型声明的问题 @RSS1102 (#6238)Menu: 修复菜单选项默认边距和图标大小的问题 @liweijie0812 (common#2369) (#6270)Tree: 修复子节点为自定义的 Input 等元素时,选中文本的高亮样式被隐藏的问题 @RylanBot (common#2370) (#6270)Popconfirm: 修复快速点击默认按钮时getComputedStyle报错的问题 @Copilot (#6224)
📈 Performance
- 移除产物中的冗余内容 @liweijie0812 (#6269)
详情见: https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.17.7
React for Web 发布 1.16.0
🌈 1.16.0 2025-12-15
🚨 Breaking Changes
MessagePlugin: 移除消息容器的id='tdesign-message-container--${placement}',之前依赖该属性的业务注意此变更⚠️ @RylanBot (#3820)
🚀 Features
- 支持
readonly的组件新增 APIreadOnly,与readonly效果一致。原有的readonly会被保留,未来版本将废弃,建议及时更换⚠️ @RylanBot (#3955) - 支持
.dark类名,丰富切换深色模式的方式 @liweijie0812 (common#2355) Dialog: 优化渲染阶段,避免子元素计算异常的问题,此前有在 Dialog 内进行复杂内容渲染的请注意此变更⚠️ @HaixingOoO (#3705)Form: 保留原始 HTML 效果,当输入框按下 Enter 键自动触发 submit 事件,如果需要拦截该行为,可以给输入框绑定onEnter={(e)=>e.preventDefault()},此前有依赖此内置特性请注意此变更⚠️ @RylanBot (#3943)MessagePlugin: 新增开启和关闭时的动画效果 @RylanBot (#3820)ImageViewer:
🐞 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:Popup:PopupPlugin: 修复classPrefix不生效的问题 @RylanBot (#3940)
详情见: https://github.com/Tencent/tdesign-react/releases/tag/1.16.0
React for Web 发布 1.15.11
🌈 1.15.11 2025-12-15
🚀 Features
🐞 Bug Fixes
RadioGroup: 修复 NextJS 中,variant="default-filled时,子组件含动态内容时导致无限循环的问题 @tingtingcheng6 (#3921)
详情见: https://github.com/Tencent/tdesign-react/releases/tag/1.15.11
Vue3 for Mobile 发布 1.12.1
🌈 1.12.1 2025-12-18
🐞 Bug Fixes
fix: 修复1.12.0版本打包产物中有不存在的 sourceMap 引用而产生的警告 @liweijie0812 (#2111)
详情见: https://github.com/Tencent/tdesign-mobile-vue/releases/tag/1.12.1
Vue3 for Mobile 发布 1.12.0
🌈 1.12.0 2025-12-17
🚀 Features
ActionSheet:item属性补充description、suffixIcon字段 @anlyyao (#2098)Navbar: 新增placeholder属性,默认值为false;新增zIndex属性,默认值为1@anlyyao (#2103)TabBar: 新增placeholder属性,默认值为false;新增zIndex属性,默认值为1@anlyyao (#2103)Cascader: 添加load函数用于异步加载 options 数据 @RSS1102 (#2087)Table: 新增columns.render配置,支持自定义表头或单元格 @anlyyao (#2107)Swiper:navigation属性扩展支持boolean类型 @RSS1102 (#2060)ImageViwer: @anlyyao (#2108)- 新增
cover插槽,用于自定义图片预览最上层内容 - 新增
image插槽,用于自定义图片区域的内容
- 新增
🐞 Bug Fixes
Search: 修复在小屏幕不遵循flex:1的问题 @LittleTurtle2333 (common#2268)(#2090)BackTop: 修复文本字重错误 @anlyyao (#2089)ColorPicker: 修复组件深色模式背景、边框、文本色错误 @anlyyao (#2089)ActionSheet: @anlyyao (#2098)- 修复左对齐场景下,子项
border左间距错误 - 修复
grid主题,description描述文本行高错误 - 修复
grid主题 + 无description描述文本场景下,顶部间距错误 list主题最后一项不应设置底边框
- 修复左对齐场景下,子项
Empty: 修复控制台Failed to resolve directive: if的告警 @parade0393 (#2086)Table: 修复columns.title为string时,表头插槽无效的问题 @anlyyao (#2107)
🚧 Others
feat: 新增支持.dark类名,丰富切换深色模式的方式 (common#2355) @liweijie0812 (#2104)⚠️ chore: 改用Font token,组件级 CSS Vars 有调整,涉及组件有:ActionSheet、Badge、Calendar、Cascader等 30+ 组件 @anlyyao (#2089)⚠️ chore:--td-xx-icon-font-size统一更名为--td-xx-icon-size,涉及组件有BackTop、Button、Cell、Empty、Grid、ImageViewer、NoticeBar、Progress、Result、Search和Upload,共计 11 个组件 @anlyyao (#2089)
详情见: https://github.com/Tencent/tdesign-mobile-vue/releases/tag/1.12.0
TDesign Weekly Release (Dec 1st 2025)
Vue3 for Web 发布 tdesign-vue-next@1.17.6
🌈 1.17.6 2025-12-01
🐞 Bug Fixes
DatePicker: 修复 1.16.0 版本后,日期区间选择器跨年时右侧面板月份错误同步变化的问题 @liweijie0812 @Copilot (#6204)
详情见: https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.17.6
Miniprogram for WeChat 发布 1.12.0
🌈 1.12.0 2025-12-05
🚀 Features
ChatList: 新增ChatList对话列表组件 @zydemail @liuding0304 @goldjunkrat @waiterxiaoyy @mimaoxiao @zhangjiaoalice (#4010)ChatSender: 新增ChatSender对话输入组件 @zydemail @liuding0304 @goldjunkrat @waiterxiaoyy @mimaoxiao @zhangjiaoalice (#4010)ChatMessage: 新增ChatMessage对话消息体组件 @zydemail @liuding0304 @goldjunkrat @waiterxiaoyy @mimaoxiao @zhangjiaoalice (#4010)ChatActionbar: 新增ChatActionbar对话操作组件 @zydemail @liuding0304 @goldjunkrat @waiterxiaoyy @mimaoxiao @zhangjiaoalice (#4010)ChatMarkdown: 新增ChatMarkdownMarkdown内容组件 @zydemail @liuding0304 @goldjunkrat @waiterxiaoyy @mimaoxiao @zhangjiaoalice (#4010)ChatThinking: 新增ChatThinking思考过程组件 @zydemail @liuding0304 @goldjunkrat @waiterxiaoyy @mimaoxiao @zhangjiaoalice (#4010)ChatLoading: 新增ChatLoading对话加载组件 @zydemail @liuding0304 @goldjunkrat @waiterxiaoyy @mimaoxiao @zhangjiaoalice (#4010)Attachments: 新增Attachments文件附件组件 @zydemail @liuding0304 @goldjunkrat @waiterxiaoyy @mimaoxiao @zhangjiaoalice (#4010)ChatContent: 新增ChatContent对话正文组件 @zydemail @liuding0304 @goldjunkrat @waiterxiaoyy @mimaoxiao @zhangjiaoalice (#4010)Popover: 新增Popover组件 @Wesley-0808 (#4049)ImageViewer: 新增image-props属性 @betavs (#4078)ActionSheet:item属性补充description字段 @anlyyao (#4096)
🐞 Bug Fixes
BackTop: 修复文本字重错误 @anlyyao (#4061)ColorPicker: 修复组件深色模式背景、边框、文本色错误 @anlyyao (#4061)Grid: 修复column小于4 或大于4 时,文本字号大小错误 @anlyyao (#4061)Badge: 修复count插槽异常 @anlyyao (#4085)Picker: 修复keys动态变更时,子项列表数据不显示 @anlyyao (#4084)Upload: @anlyyao (#4087)- 修复企业微信/桌面端环境中部分机型无法唤起上传
- 修复当
request-method返回Promise时,无法上传的问题
ActionSheet: @anlyyao (#4096)- 修复左对齐场景下,子项
border左间距错误 - 修复
grid主题 + 无description描述文本场景下,顶部间距错误 list主题最后一项不应设置底边框- 修复
item属性的disabled配置无效
- 修复左对齐场景下,子项
Toast: 修复弹窗与遮罩消失不同步的问题 @Boomkaa (#4103)
🚧 Others
⚠️ chore: 改用Font token,组件级 CSS Vars 有调整,涉及组件有:ActionSheet、Badge、Calendar、Cascader等 30+ 组件⚠️ chore:--td-xx-icon-font-size统一更名为--td-xx-icon-size,涉及组件有BackTop、Button、Cell、Empty、Grid、ImageViewer、NoticeBar、Progress、Result、Search和Upload,共计 11 个组件
详情见: https://github.com/Tencent/tdesign-miniprogram/releases/tag/1.12.0
TDesign Weekly Release (Nov 4th 2025)
Vue3 for Web 发布 tdesign-vue-next@1.17.5
🌈 1.17.5 2025-11-28
🐞 Bug Fixes
Tree: 修复1.17.3版本过滤中可选节点被错误禁用的问题 @RylanBot (common#2345) (#6196)
详情见: https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.17.5
Vue3 for Web 发布 tdesign-vue-next@1.17.4
🌈 1.17.4 2025-11-28
🚀 Features
🐞 Bug Fixes
Calendar: 优化透传组件 props 事件的处理方式,修复透传的回调函数无法触发的问题 @Wesley-0808 (#6157)DatePicker: 优化日期范围选择器的交互问题,避免先选择结束日期后需重复操作多次的问题 @mikasayw (#6143)Description: 修复无边框模式下itemLayout垂直排列的间距问题 @mikasayw (#6156)Input:- 修正 input 及上层 select 等组件在 safari 中初次渲染 auto-width 失效的问题 @Cat1007 (common#2336) (#6188)
- 优化透传组件 props 事件的处理方式,修复透传的回调函数无法触发的问题 @Wesley-0808 (#6157)
SelectInput: 优化透传组件 props 事件的处理方式,修复透传的回调函数无法触发的问题 @Wesley-0808 (#6157)Slider: 修复初始化时精度计算错误的问题 @RylanBot (#6183)Table:- 优化透传组件 props 事件的处理方式,修复透传的回调函数无法触发的问题 @Wesley-0808 (#6157)
- 修复可编辑单元格在
keepEditMode下没有正确在validateData回调展示的问题 @uyarn (#5490)
TagInput: 优化透传组件 props 事件的处理方式,修复透传的回调函数无法触发的问题 @Wesley-0808 (#6157)TreeSelect: 优化透传组件 props 事件的处理方式,修复透传的回调函数无法触发的问题 @Wesley-0808 (#6157)Upload:- 优化透传组件 props 事件的处理方式,修复透传的回调函数无法触发的问题 @Wesley-0808 (#6157)
- 修复不支持文件数组上传的问题 @GATING (#6169)
Table: 修复分页受控模式下current属性手动变更不触发onPageChange的问题 @RSS1102 (#6163)
📝 Documentation
详情见: https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.17.4
React for Web 发布 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: 支持cardScaleAPI,用于控制卡片的缩放比例 @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
详情见: https://github.com/Tencent/tdesign-react/releases/tag/1.15.9
React for Mobile 发布 0.21.0
🌈 0.21.0 2025-11-27
🚀 Features
Calendar: 新增allowSameDay属性,允许 type='range' 场景的起止时间相同 @liweijie0812 (#829)Upload:DropdownItem: 新增icon属性,支持自定义图标 @anlyyao (#831)
🐞 Bug Fixes
Calendar: 修复value =[]结合switch-mode = 'year-month'使用时当前月份计算错误 @anlyyao (#832)ColorPicker: 修复组件深色模式背景、边框、文本色错误 @anlyyao (#834)BackTop: 修复文本字重错误 @anlyyao (common#2339)Search: 修复在小屏幕不遵循flex:1的问题 @LittleTurtle2333 (common#2268)Slider: 修复深色模式下滑轨背景色、滑块禁用态背景色错误 @anlyyao (common#2331)Popover: 修复箭头间距错误 @anlyyao (#840)GridItem: 修复column为0时,标题行高错误 @anlyyao (#840)
详情见: https://github.com/Tencent/tdesign-mobile-react/releases/tag/0.21.0