TDesign Weekly Release (Dec 4th 2025)

Vue2 for Web 发布 1.14.4

🌈 1.14.4 2025-12-26

🐞 Bug Fixes

• Drawer: 修复 DOM 元素未正确移除的问题 @RSS1102 (#3788)
• Guide: 修复 DOM 元素未正确移除的问题 @RSS1102 (#3788)

详情见： 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:
  • 修复 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)

详情见： 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:
  • 修复 1.16.0 版本的重构导致 SSR 环境下产生的报错问题 @RylanBot (#4026)
  • 修复 1.16.0 版本的重构导致嵌套场景下，内层弹窗无法正常关闭的问题 @RylanBot (#4023)

🚧 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: 新增 fixed API，适用于触发元素为 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 的组件新增 API readOnly，与 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:
  • 新增默认 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)

详情见： https://github.com/Tencent/tdesign-react/releases/tag/1.16.0

React for Web 发布 1.15.11

🌈 1.15.11 2025-12-15

🚀 Features

• Textarea: 支持 count API，用于自定义计数元素的渲染 @RylanBot (#4003)

🐞 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: 新增 ChatMarkdown Markdown 内容组件 @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

• Table: 优化通过分页操作后 Table 内容变化时的展示效果，分页器会锚定在当前视口 @RSS1102 (#6172)

🐞 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

• Calendar: 补充range参数的用法示例 @shumuuu (#6148)

详情见： 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: 支持 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)

详情见： 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:
  • 新增 addBtn 属性 @anlyyao (#830)
  • 启用 capture 属性时跳过文件名重复检测；在 capture = '' + 拍照上传场景中，allowUploadDuplicateFile 应取 true @anlyyao (#833)
• 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

TDesign Weekly Release (Nov 3rd 2025)

Vue3 for Mobile 发布 1.11.1

🌈 1.11.1 2025-11-21

🚀 Features

• Calendar: 新增 allowSameDay 属性，允许 type='range' 场景的起止时间相同 @liweijie0812 (#2076)
• DropdownItem: 新增 icon 属性，支持自定义图标 @anlyyao (#2073)
• Upload:
  • 新增 addBtn 属性 @anlyyao (#2074)
  • 启用 capture 属性时跳过文件名重复检测；在 capture = '' + 拍照上传场景中，allowUploadDuplicateFile 应取 true @anlyyao (#2079)

🐞 Bug Fixes

• Calendar: 修复 value =[] 结合 switch-mode = 'year-month' 使用时当前月份计算错误 @anlyyao (#2080)
• DropdownMenu: 修复首次渲染时动画错误 @anlyyao (#2073)
• DropdownItem: 修复图标左侧间距错误 @anlyyao (#2073)
• Dialog: 修复 actions 插槽无效的问题 @anlyyao (#2075)
• Popover: 修复箭头间距错误 @slatejack (#2059)
• GridItem: 修复标题行高错误 @anlyyao (#2059)
• Slider: 修复深色模式下滑轨背景色、滑块禁用态背景色错误 @anlyyao (#2069)
• Popup:
  • 修复 visible 变更为 true 时，visible-change 事件未触发 @anlyyao (#2072)
  • 修复visible-change 事件参数错误 @anlyyao (#2072)

详情见： https://github.com/Tencent/tdesign-mobile-vue/releases/tag/1.11.1

TDesign Weekly Release (Nov 2nd 2025)

Vue3 for Web 发布 tdesign-vue-next@1.17.3

🌈 1.17.3 2025-11-14

🚀 Features

• DatePicker: 在未配置 enableTimePicker 场景下也应用 defaultTime 的配置，影响 valueType 为 time-stamp的返回值及 onChange 的回调参数 ⚠️ @RSS1102 @uyarn (#6140)
• Divider: 新增 size API，用于控制间距大小 @liweijie0812 (#6094)
• Guide: 支持在调整窗口大小时自动调整引导组件的展示效果 @yrc2333 (#6133)
• Form: pattern API 新增支持 string 类型 @liweijie0812 (#6134)
• Form: 在 setValidateMessage 中添加 success 验证类型支持 @RSS1102 (#6147)

🐞 Bug Fixes

• Popup: 修复在 SSR 场景下的异常问题 @uyarn (#6124)
• Table: 修复在 pageSize 由小到大改变时无法自定义当前页的问题 @RSS1102 (#6127)
• Tabs: 修复开启 destroyOnHide 移除标签后会导致后续 TabItem 状态异常的问题 @yrc2333 (#6137)
• Empty: 修复多语言动态切换响应式无效 @liweijie0812 (#6126)
• Menu: 修复快速操作菜单时，父菜单关闭后子菜单未正确收起的问题 @RSS1102 (#6121)

详情见： https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.17.3

Miniprogram for WeChat 发布 1.11.2

🌈 1.11.2 2025-11-12

🚀 Features

• Picker:
  • ⚠️ itemHeight 默认单位改用 px，避免单位转换带来的精度问题 @anlyyao (#4052)
  • 新增 visibleItemCount 属性，可自定义可视区域 PickerItem 的子项个数 @anlyyao (#4052)
  • 优化大量数据时列表滚动性能 @jarmywang (#4014)
• Calendar: 新增 allowSameDay 属性，允许 type='range' 场景的起始时间相同 @anlyyao (#4045)
• Cascader: 支持通过 keys 属性定义 children / disabled 在 options 中对应的字段别名 @anlyyao (#4044)

详情见： https://github.com/Tencent/tdesign-miniprogram/releases/tag/1.11.2

React for Mobile 发布 0.20.1

🌈 0.20.1 2025-11-12

🚀 Features

• Form: 表单验证 pattern 支持 string 类型 @liweijie0812 (#821)

🐞 Bug Fixes

• Form: 修复错误消息 max 和 min 英文翻译错误 @liweijie0812(#816)
• SwipeCell: 修复初始化状态判断错误 @RSS1102 (#810)
• TabBar:
  • 解决TabBar组件在使用subTabBar时点击报错问题 @mikasayw (#819)
  • 解决TabBar和TabBarItem组件的 className、style 属性失效问题 @mikasayw (#819)

详情见： https://github.com/Tencent/tdesign-mobile-react/releases/tag/0.20.1

Flutter for Mobile 发布 0.2.6

🌈 0.2.6 2025-11-14

🚀 Features

• TDNoticeBar : 新增content属性，废弃并兼容原有的context属性 @runoob-coder (#744)
• TDButton: 添加渐变颜色背景 @jflin19990707 (#773)
• TDToast: TDToast支持展示多个 @jflin19990707 (#780)
• TDUpload: 增加自定义上传监听 @leenc123 (#775)
• TDTable: 增加自定义表尾属性 @leenc123 (#776)

🐞 Bug Fixes

• TDMultiCascader: 修复initialIndexes 参数不生效 @epoll-j (#752)
• TDDialog: 按钮文案溢出问题 @jflin19990707 (#772)
• TDDateTimePicker: 日期时分秒的英文配置改为缩写 @jflin19990707 (#770)
• TDCell: TDCell的note过长时溢出问题 @jflin19990707 (#769)
• TDCell: 修复单元格内 icon 与文本的对齐问题 @runoob-coder (#789)
• TDProgress : 修复进度条改变时的样式问题 @runoob-coder (#744)

📝 Documentation

• docs: 优化文档格式和内容 @runoob-coder (#744)

🚧 Others

• 组件全面适配深色模式，优化调整组件样式（实验版） @runoob-coder (#744)
• demo: 优化调整demo示例项目及代码演示，升级 Android 构建配置和依赖项以兼容在flutter 3.16.9至最新版（3.35.5）下运行，调整web预览iframe样式去除顶部边距 @runoob-coder (#744)
• web: 覆盖web依赖项，解决与flutter_localizations的版本冲突问题，兼容flutter之前版本 @runoob-coder (#744)

详情见： https://github.com/Tencent/tdesign-flutter/releases/tag/0.2.6

TDesign Weekly Release (Nov 1st 2025)

Vue2 for Web 发布 1.14.2

🌈 1.14.2 2025-11-07

🚀 Features

• Watermark: 新增 layout API，支持生成不同布局的水印 @Wesley-0808 (#3726)
• Cascader:
  • 支持 filterable 与 checkStrictly 及valueMode = parentFirst配合使用，展示非叶子节点的效果 @uyarn (#3763)
  • option 新增onChange和onExpand 方法，用于多选场景下，自定义节点时自定义点击节点的触发逻辑，具体使用请参考自定义下拉选项的参考示例 @uyarn (#3763)

🐞 Bug Fixes

• Cascader:
  • 修复多选自定义节点无法进行展开处理的问题 @uyarn (#3763)
  • 修复reserveKeyword API 无效的问题 @uyarn (#3763)
• Watermark:
  • 修复多行图文水印图片配置了灰度时，整个画布内容也会灰度的问题 @Wesley-0808 (#3726)
  • 修复 window 不存在场景，构建时报错的问题 @Wesley-0808(#3736)
• Textarea: 修复内容超长情况下，设置 autosize 没有完整自动撑开高度，存在有滚动条的问题 @engvuchen (#3727)
• Form: 修复错误消息 max 和 min 英文翻译错误 @liweijie0812(#3743)
• Calendar:
  • 修复了年份选项错误地使用了月份选项禁用范围判定逻辑的问题 @shumuuu (#3759)
  • 修复了当设定日历的range值为同一年内时，终止月份之后的月份选项没有正常禁用的问题 @shumuuu (#3759)
• Menu: 修复菜单项自动翻转失效的问题 @RSS1102 (#3744)

🚧 Others

• Tabs: 在非拖拽场景下不注册拖拽事件 @RSS1102 (#3738)

详情见： https://github.com/Tencent/tdesign-vue/releases/tag/1.14.2

React for Web 发布 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)

详情见： https://github.com/Tencent/tdesign-react/releases/tag/1.15.8

Miniprogram for WeChat 发布 1.11.1

🌈 1.11.1 2025-11-06

🐞 Bug Fixes

• Calendar: 修复 value[] 结合 swich-mode 时，初始化错误 @anlyyao (#4005)
• CheckboxGroup: 修复无法在 form 中获取数据的问题 @Boomkaa (#4017)
• TabBar: 修复子项背景色叠加的问题 @Boomkaa (#4019)
• ActionSheet: 修复组件初始化数据重复修改导致异常的问题 @betavs (#4013)
• Toast: 修复圆角样式错误 @anlyyao (#4031)
• Upload: 修复 draggable 值变换时组件显示错误 @anlyyao (#4030)
• Picker: 修复 autoClose 为 false 时，点击遮罩层会重置选项为拨动前选项值的问题 @composable-tu (#3874)

详情见： https://github.com/Tencent/tdesign-miniprogram/releases/tag/1.11.1

TDesign Weekly Release (Oct 4th 2025)

Vue3 for Web 发布 tdesign-vue-next@1.17.2

🌈 1.17.2 2025-10-30

🚀 Features

• Affix: 新增支持contentAPI，与其他组件保持一致 @ImaginingMaker @zhangpaopao0609 (#5981)
• Cascader:
  • 支持 filterable 与 checkStrictly 及valueMode = parentFirst配合使用，展示非叶子节点的效果 @uyarn (#6102)
  • option 新增onChange和onExpand 方法，用于多选场景下，自定义节点时自定义点击节点的触发逻辑，具体使用请参考自定义下拉选项的参考示例 @uyarn (#6102)
• Popup: 新增 getPopper() 方法，将返回 popper 实例，用于基于 popper 进行动态操作的场景 @RSS1102 (#6096)

🐞 Bug Fixes

• AutoComplete: 修复使用键盘选中后，删除输入框内容时无法再次打开选项弹窗的问题 @SaberA1ter (#6059)
• Cascader:
  • 修复多选自定义节点无法进行展开处理的问题 @uyarn (#6102)
  • 修复reserveKeyword API 无效的问题 @uyarn (#6102)
• DatePicker: 修复面板底部内容区域在非需要情况下仍存在的问题 @huguangju (#6055)
• DateRangePicker: 修复全局替换图标场景下，点击关闭按钮报错的问题 @uyarn (#6108)
• Form: 修复错误消息 max 和 min 英文翻译错误 @liweijie0812 (#6082)
• ImageViewer:
  • 修复 zIndex 过大导致工具栏的 tooltip 会被遮挡的问题 @liweijie0812 (#6107)
  • 修复预览图片时点击右键后失焦，预览图会跟随鼠标移动的问题 @mikasayw (#6098)
• MessagePlugin: 修复className参数无效的问题 @Wesley-0808 (#6097)
• NotificationPlugin: 优化 offset 没有对容器层生效的问题 @liweijie0812 (#6087)
• Rate: 修复color属性不支持响应式的问题 @mikasayw (#6072)
• Table: 修复控制台的告警问题 @mikasayw (#6070)
• Menu: 修复父菜单关闭时子菜单状态残留 @RSS1102 (#6086)
• Table: 当未提供 pageSize 时确保使用 defaultPageSize 大小 @RSS1102 (#6101)

📝 Documentation

• ImageViewer: 优化示例页面操作栏被主题生成器遮挡的问题 @liweijie0812 (#6107)

详情见： https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.17.2

React for Web 发布 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 切换时，无法正确刷新的问题
  • 修复没开启虚拟滚动的配置，也启动了相关计算的问题

详情见： https://github.com/Tencent/tdesign-react/releases/tag/1.15.7

Vue3 for Mobile 发布 1.11.0

🌈 1.11.0 2025-10-23

🚀 Features

• Icon:
  • tdesign-icons-vue-next 发布 0.4.1 版本，新增align-bottom、no-result、no-result-filled、 tree-list、wifi-no、 wifi-no-filled、logo-stackblitz-filled、logo-stackblitz、logo-wecom-filled 图标；移除 video-camera-3、video-camera-3-filled、list 图标，此前有依赖以上移除图标升级请注意 ⚠️ @uyarn @liweijie0812 (#2017)
  • 按需加载方式使用的图标资源支持可变粗细功能，通过strokeWidth属性进行配置 @uyarn @liweijie0812 (#2017)
  • 按需加载方式使用的图标资源支持多色填充功能，通过strokeColor 和 fillColor 属性进行配置 @uyarn @liweijie0812 (#2017)
• Watermark: 新增 Watermark 水印组件 @Wesley-0808 (#2024)
• Popup: mounted 后才显示，避免 ssr 下 mismatch @novlan1 (#1654)
• Cascader: 支持透传 overlayProps @novlan1 (#2027)
• Drawer: 新增 overlayProps 属性 @anlyyao (#2034)
• ImageViwer: 修复点击遮罩层 close 事件未触发，并补充触发源 image，表示点击图片关闭图片预览 @liweijie0812 (#2045)

🐞 Bug Fixes

• Message: 修复 error 和 warning 主题图标错误 @anlyyao (#2008)
• CountDown: 开启 autostart 后，置于后台的状态不更新时间 @SinzoL (#2010)
• Textarea: 修复输入文本颜色错误 @anlyyao (#2026)
• CountDown: 开启 splitWithUnit 后，单位不显示 @Linzsong (#2019)
• Button: 修复 disabled 或 loading 动态变化时，hover 态异常 @liweijie0812 (#1998)
• Cascader: 修复异步加载数据问题 @novlan1 (#2027)
• ConfigProvider: 修复错误消息 max 和 min 英文翻译错误 @liweijie0812(#2048)
• QRCode: 修复按需导出名称错误 @liweijie0812 (#2043)
• Upload:
  • 修复 addContent 插槽位置错误 @anlyyao (#2055)
  • 修复 --td-upload-add-icon-font-size 无效 @anlyyao (#2055)
  • 修复 add 图标不居中问题 @anlyyao (#2308)

详情见： https://github.com/Tencent/tdesign-mobile-vue/releases/tag/1.11.0

TDesign Weekly Release (Oct 3rd 2025)

Miniprogram for WeChat 发布 1.11.0

🌈 1.11.0 2025-10-20

🚀 Features

• Watermark: 新增 Watermark 水印组件 @Wesley-0808 (#3799)
• Textarea: 改用伪元素实现边框，避免占位 @anlyyao (#3878)
• SideBarItem:
  • 新增默认插槽，可自定义侧边栏子项内容 @anlyyao (#3875)
  • 支持由标签内容撑开高度 @anlyyao (#3985)
• Swiper: 新增 animationfinish 事件 @anlyyao (#3885)
• Textarea: 组件 CSS Vars 新增 --td-textarea-padding @anlyyao (#3937)
• PickerItem: 子项支持 icon 属性 @anlyyao (#3930)
• Upload: click 事件新增 index 参数 @anlyyao (#3942)
• Slider: label 属性支持函数类型，用于自定义滑块当前值文本 @anlyyao (#3928)
• Drawer: 新增 overlayProps 属性 @anlyyao (#3978)
• QRCode: 新增外部样式类 t-class-canvas @anlyyao (#3956)

🐞 Bug Fixes

• DateTimePicker: 修复 showWeek 模式下日（date）列表未正确排除 start 和 end、且 steps 步长无效的问题 @composable-tu (#3861)
• Message: 修复 error 主题图标错误 @anlyyao (#3879)
• PullDownRefresh: 修复 t-class-loading 配置不生效的问题 @betavs (#3896)
• Input: 修复在 skyline 和 type = 'nickname' 场景下，change 事件无效的问题 @anlyyao (#3858)
• StepItem: 修复 title 和 description 之间的间距错误 @anlyyao (#3898)
• Skeleton: 修复 row-col 中的选项为数字时无法实现多列效果的问题 @betavs (#3932)
• TabBar: 修复在 Skyline 渲染引擎下， change 事件无效的问题 @anlyyao (#3926)
• Checkbox: 修复 icon 属性使用 svg 资源时在 iOS 上不显示 @anlyyao (#3929)
• Slider: 修复动态更新 value 无效的问题 @anlyyao (#3954)
• DropdownItem: 修复在 iOS 26 中弹窗定位不准 @anlyyao (#3953)
• Toast: 修复 showOverlay 和 preventScrollThrough 均为 true 时，遮罩背景色错误 @anlyyao (#3948)
• SideBar: 修复禁用态颜色错误 @novlan1 (#3982)
• Calendar: 修复翻页按钮状态错误 @anlyyao (#3996)
• ImageViewer: 修复背景色错误问题 @novlan1 (#3881)
• QRCode: 修复中心二维码位置偏移 @SinzoL (#3899)

详情见： https://github.com/Tencent/tdesign-miniprogram/releases/tag/1.11.0

TDesign Weekly Release (Oct 2nd 2025)

Vue3 for Web 发布 tdesign-vue-next@1.17.1

🌈 1.17.1 2025-10-09

🐞 Bug Fixes

• Descriptions: 修复无边框模式下的边距问题 @liweijie0812 (#6043)
• Watermark: 修复 1.17.0 SSR 场景下构建时报错的问题 @Wesley-0808 (#6047)
• Calendar: 修复了当设定日历的range值为同一年内时，终止月份之后的月份选项没有正常禁用的问题 @shumuuu (#6045)

详情见： https://github.com/Tencent/tdesign-vue-next/releases/tag/tdesign-vue-next@1.17.1

React for Web 发布 1.15.6

🌈 1.15.6 2025-10-10

🐞 Bug Fixes

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

详情见： https://github.com/Tencent/tdesign-react/releases/tag/1.15.6

React for Mobile 发布 0.20.0

🌈 0.20.0 2025-10-11

🚀 Features

• Icon:
  • tdesign-icons-react 发布 0.6.1 版本，新增align-bottom、no-result、no-result-filled、 tree-list、wifi-no、 wifi-no-filled、logo-stackblitz-filled、logo-stackblitz、logo-wecom-filled 图标；移除 video-camera-3、video-camera-3-filled、list 图标，此前有依赖以上移除图标升级请注意 ⚠️ @uyarn (#785)
  • 按需加载方式使用的图标资源支持可变粗细功能，通过strokeWidth属性进行配置 @uyarn (#785)
  • 按需加载方式使用的图标资源支持多色填充功能，通过 strokeColor 和 fillColor 属性进行配置 @uyarn (#785
• Watermark: 新增 Watermark 水印组件 @Wesley-0808 (#804)
• ImageViwer: 修复点击遮罩层 close 事件未触发，并补充触发源 image，表示点击图片关闭图片预览 @anlyyao (#811)
• Drawer: 新增 overlayProps 属性 @anlyyao (#809)

🐞 Bug Fixes

• Message: 修复 marquee、closeBtn 与 link 属性表现异常，更新 click 事件参数 @vancece (#779)
• Steps: 修复 current 属性的 string 类型和 number 类型渲染效果不一致 @ImaginingMaker (#761)
• Rate: 修复点选时弹框未显示 @lockiechen (#754)
• CountDown: 修复毫秒不展示以及自动执行的问题 @SinzoL (#781)
• Collapse:
  • 修复 defaultExpandAll 属性导致的打开异常问题 @ImaginingMaker (#775)
  • 修复 defaultExpandAll 与 expandMutex 同时传递时的冲突问题 @ImaginingMaker (#775)

详情见： https://github.com/Tencent/tdesign-mobile-react/releases/tag/0.20.0