Skip to content

Releases: Tencent/tdesign

TDesign Weekly Release (Feb 2nd 2026)

15 Feb 03:11
32c0800

Choose a tag to compare

React for Mobile 发布 0.21.2

🌈 0.21.2 2026-02-10

🚀 Features

  • Icon: 新增 217 个与人工智能、文档、徽标和文件相关的图标 @uyarn(#872)
  • Cascader: @anlyyao (#865)
    • 新增 overlayPropsheadermiddleContent 属性
    • pick 事件新增 labellevel 参数,其中 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)

08 Feb 03:11
2d29f9d

Choose a tag to compare

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)
    • 新增 disableTime API,用于配置时间选择器中被禁用的时间 @Wesley-0808 (#6316)
    • 新增 rangepanelActiveDate API,用于支持定义日期选择范围,具体使用请参考示例 @Wesley-0808 (#6316)
  • DateRangePicker:
    • disabled API 新增支持数组类型,用于单独禁用开始日期或结束日期 @uyarn (#6390)
    • 新增 rangepanelActiveDate API,用于支持定义日期选择范围,具体使用请参考示例 @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-typeentrance-pathneed-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-typeentrance-pathneed-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)

01 Feb 03:11
1481aca

Choose a tag to compare

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 版本导致点击蒙层时,onOverlayClickonClose 无法触发的问题 @RylanBot (#4098)
  • ImageViewer: 修复 classNamestyle 属性失效的问题 @RSS1102 (#4087)
  • Popup:
    • 修复 trigger="hover" 且弹层与触发元素间距较大时,鼠标还未移入弹层就关闭的问题 @RylanBot (#4100)
    • 修复组件嵌套使用时的关闭逻辑 @uyarn (#4099)
  • Typography: 修复开启 ellipsis 时,将一个完整英文单词切割放在两行的问题 @RylanBot (#3997)

🚧 Others

  • Popup: 优化开启 destroyOnClose 时的内部状态,确保逻辑正常 @uyarn (#4099)

详情见: 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

  • ActionSheet: 调整导出方式,分离组件和函数式 API 的使用方式 @anlyyao (#2122)

🚀 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 可选项,其中 ribbonribbon-right 等效
    • 优化 ribbon 实现,改用 background: linear-gradient(),移除伪元素相关样式

🐞 Bug Fixes

  • Sticky: 修复 containerVue 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:
    • shape 属性新增 ribbon-right/ribbon-left/triangle-right/triangle-left 可选项,其中 ribbonribbon-right 等效 @novlan1 (#4201)
    • 优化 ribbon 实现,改用 background: linear-gradient(),移除伪元素相关样式 @novlan1 (#4201)
  • Calendar: 新增 allowSameDay 属性,允许 type='range' 场景的起止时间相同 @novlan1 (#4201)
  • Cascader:
    • 支持通过 keys 属性定义 children / disabledoptions 中对应的字段别名 @novlan1 (#4201)
    • 新增 middle-content 插槽,用于自定义中间区域内容 @novlan1 (#4201)
  • 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:
    • 优化性能减少掉帧 @novlan1 (#4201)
    • 优化大量数据时列表滚动性能 @novlan1 (#4201)
    • itemHeight 默认单位改用 px,避免单位转换带来的精度问题 @novlan1 (#4201)
    • 新增 visibleItemCount 属性,可自定义可视区域 PickerItem 的子项个数 @novlan1 (#4201)
  • Popover:
    • 新增 fixed API,适用于触发元素为 fixed 场景。⚠️ 当触发元素为 fixed 时,除了需要显示指定 fixed 属性为 true,还需在触发元素层添加 t-popover-wrapper--fixed 类,用于定位触发元素 @novlan1 (#4201)
    • 新增 --td-popover-[theme]-color--td-popover-[theme]-bg-color 系列 CSS Vars @novlan1 (#4201)
  • QRCode: 组件新增 init(),用于外部调用,重新绘制二维码 @novlan1 (#4201)
  • Search:
  • SidebarItem:
  • TabBar: 新增 placeholder 属性,默认值为 false;新增 zIndex 属性,默认值为 1 @novlan1 (#4201)

🐞 Bug Fixes

  • ActionSheet:
    • 修复左对齐场景下,子项 border 左间距错误 @novlan1 (#4201)
    • 修复 grid 主题 + 无 description 描述文本场景下,顶部间距错误 @novlan1 (#4201)
    • list 主题最后一项不应设置底边框 @novlan1 (#4201)
    • 修复 item 属性的 disabled 配置无效 @novlan1 (#4201)
  • BackTop: 修复文本字重错误 @novlan1 (#4201)
  • Badge: 修复 count 插槽异常 @novlan1 (#4201)
  • Calendar:
  • Checkbox: 修复 icon 属性使用 svg 资源时在 iOS 上不显示 @novlan1 (#4201)
  • CollapsePanel:
    • 修复深色模式下面板右侧图标颜色错误 @novlan1 (#4201)
    • 修复左侧图标颜色错误,默认主题色,支持使用 css vars 自定义 @novlan1 (#4201)
  • 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:
    • 修复 autoClosefalse 时,点击遮罩层会重置选项为拨动前选项值的问题 @novlan1 (#4201)
    • 修复平铺模式 value 变化未能准确监听 @novlan1 (#4201)
    • 修复 keys 动态变更时,子项列表数据不显示 @novlan1 (#4201)
    • 修复 popupProps.showOverlay 无效 @novlan1 (#4201)
  • Popup: 修复 duration 参数无效的问题 @novlan1 (#4201)
  • Progress:
    • 修复深色模式下环形进度条内部背景色错误 @novlan1 (#4201)
    • 修复环形进度条内部文本间距错误 @novlan1 (#4201)
    • 修复深色模式下环形进度条内部背景色错误 @novlan1 (#4201)
    • 修复环形进度条内部文本间距错误 @novlan1 (#4201)
  • Slider: 修复受控 + 双游标滑块模式下陷入死循环的问题 @novlan1 (#4201)
  • SwipeCell: 消除 IntersectionObserver is using slowest path 警告 @novlan1 (#4201)
  • TabBar: 修复子项背景色叠加的问题 @novlan1 (#4201)
  • Tabs: 消除 IntersectionObserver is using slowest path 警告 @novlan1 (#4201)
  • Toast:
    • 修复 Toast 嵌套调用时 close 回调陷入循环的问题 @novlan1 (#4201)
    • 修复弹窗与遮罩消失不同步的问题 @novlan1 (#4201)
    • 修复圆角样式错误 @novlan1 (#4201)
    • 修复 showOverlaypreventScrollThrough 均为 true 时,遮罩背景色错误 @novlan1 (#4201)
  • Upload:
Read more

TDesign Weekly Release (Jan 3rd 2026)

22 Jan 02:51
625b395

Choose a tag to compare

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" 的弹窗
    • 支持 draggablemode="modeless" 生效
  • Form: 支持 getFieldsValuegetFieldValue 返回未渲染的数值 @RylanBot (#4050)

🐞 Bug Fixes

  • Cascader:
    • 修复在弹出层可见期间,滚动位置被意外更新的问题 @RylanBot (#4062)
    • 优化 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#4056)
  • Dialog:
    • 修复 closeOnOverlayClickfalse 时,onOverlayClick 无法触发的问题 @TidySongS (#4065)
    • 修复 mode="modeless" 的弹窗,点击空白地方会被关闭的问题 @RylanBot (#3950)
    • 修复开启 draggable 时,无法选中内部 Input 等元素中文本的问题 @RylanBot (#3950)
  • Form:
    • 修复自定义控件时 setFieldsValue 失败的问题 @RylanBot (#4029)
    • 修复使用 shouldUpdate 时,必须给 FormItemkey 才能生效的问题 @RylanBot (#4005)
  • FormList: @RylanBot (#4005)
    • 修复子节点存在另一个 Form 时,部分 API 异常的问题
    • 修复结合 shouldUpdate 使用时,initialData 不生效的问题
    • 修复 add 过程中缺乏拷贝从而污染用户原始数据的问题 @RylanBot
  • InputNumber: 修复大数计算前导零被错误清除的问题 @Liumingxun (common#2394)
  • Menu: 优化 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#4056)
  • Popup:
    • 修复嵌套场景下,外层弹窗隐藏时,内层弹窗无法正常关闭的问题 @RylanBot (#4085)
    • 修复 triggerElementdisabled 的场景下,hover 时无法正常显示弹出层的问题 @RylanBot (#4085)
    • 修复 content 动态修改时,箭头位置不稳定的问题 @RylanBot (#4062)
  • Select:
    • 修复 tagInputProps.tagProps 不生效的问题 @RylanBot (#4070)
    • 优化 Safari 浏览器中点击展开图标没有变换方向的问题 @liweijie0812 (#4056)
  • SelectInput: @RylanBot (#4070)
    • 修复 1.16.0 版本的修复导致点击 closable 图标时无法清除选项的问题
    • 修复传入 tagInputProps.tagProps.onClose 时,onTagChange 不生效的问题
  • Text: 修复在关闭 copyableTooltip 时,元素未同步隐藏的问题 @RylanBot (#4067)
  • Textarea: 修复 count 计算逻辑没有遵循 maxcharactermaxlength 的问题 @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

详情见: 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

🐞 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)
  • TDRadioTDCheckbox: 单选框、多选框多列展示问题 @jflin19990707 (#841)
  • TDNavBar: 优化标题栏返回图标 支持暗黑模式 @sinianbao (#844)

🚧 Others

  • docs: 更新主题生成器文档,添加视频演示链接 @RSS1102 (#833)

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

TDesign Weekly Release (Jan 2nd 2026)

15 Jan 02:47
ad095b2

Choose a tag to compare

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 回调参数,包括 formDataname 用于 JSON Schema 等生成式表单场景 @uyarn (#6321)
  • LoadingPlugin: 支持接收 ConfigProvider 的全局配置,如自定义前缀 @Wesley-0808 @uyarn @Copilot (#6212)
  • MessagePlugin: 支持接收 ConfigProvider 的全局配置,如自定义前缀 @Wesley-0808 @uyarn @Copilot (#6212)
  • NotificationPlugin:
    • 新增 classNamestyle API,支持自定义通知框类、内联样式 @Wesley-0808 (#6307)
    • 支持接收 ConfigProvider 的全局配置,如自定义前缀 @Wesley-0808 @uyarn @Copilot (#6212)
  • TagInput: 修复横向滚动模式下增删选项滚动条位置异常的问题 @liweijie0812 @Copilot (#6213)
  • Upload: 新增支持 .ai、.ps、.eps 等支持的文件类型 @uyarn (common#2374) (#6324)
  • Calendar: range API 支持单独设置开始范围或结束范围 @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:
    • 修复单选模式下取消行高亮时 activeRowList 未正确清空的问题 @Copilot (#6222)
    • 修复组件实例方法 clearValidateData 没有清理可编辑单元格验证结果的问题 @RSS1102 (#6186)
  • 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)

08 Jan 02:46
1adc296

Choose a tag to compare

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 版本的重构导致 triggerdisabled 依旧能触发弹出层的问题

详情见: https://github.com/Tencent/tdesign-react/releases/tag/tdesign-react@1.16.3

TDesign Weekly Release (Dec 4th 2025)

01 Jan 02:53
1adc296

Choose a tag to compare

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

详情见: 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:
    • 修复 valueDisplayonClose 回调函数读取到 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: 修复使用 defaultValuereadonly 产生的警告问题 @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 可选项,其中 ribbonribbon-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:
  • 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 属性补充 descriptionsuffixIcon 字段 @anlyyao (#845)
  • Badge: @anlyyao (#855)
    • shape 属性新增 ribbon-right/ribbon-left/triangle-right/triangle-left 可选项,其中 ribbonribbon-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)

22 Dec 02:48
c4feac5

Choose a tag to compare

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

🌈 1.17.7 2025-12-18

🚀 Features

🐞 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

详情见: 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)
    • 修复 onChangecontext.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 属性补充 descriptionsuffixIcon 字段 @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.titlestring 时,表头插槽无效的问题 @anlyyao (#2107)

🚧 Others

  • feat: 新增支持 .dark 类名,丰富切换深色模式的方式 (common#2355) @liweijie0812 (#2104)
  • ⚠️ chore: 改用 Font token,组件级 CSS Vars 有调整,涉及组件有:ActionSheetBadgeCalendarCascader 等 30+ 组件 @anlyyao (#2089)
  • ⚠️chore: --td-xx-icon-font-size 统一更名为 --td-xx-icon-size,涉及组件有 BackTopButtonCellEmptyGridImageViewerNoticeBarProgressResultSearchUpload,共计 11 个组件 @anlyyao (#2089)

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

TDesign Weekly Release (Dec 1st 2025)

08 Dec 02:41
6a03405

Choose a tag to compare

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

🐞 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 有调整,涉及组件有:ActionSheetBadgeCalendarCascader 等 30+ 组件
  • ⚠️chore: --td-xx-icon-font-size 统一更名为 --td-xx-icon-size,涉及组件有 BackTopButtonCellEmptyGridImageViewerNoticeBarProgressResultSearchUpload,共计 11 个组件

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

TDesign Weekly Release (Nov 4th 2025)

01 Dec 02:54
2c6c76e

Choose a tag to compare

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

🌈 1.17.5 2025-11-28

🐞 Bug Fixes

详情见: 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

详情见: 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: 支持当 valueModeall 或者 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:
  • TreeSelect: @RylanBot (#3984)
    • 修复过滤节点的父节点也可以被选中的问题
    • 修复 blur 时,输入框内容没有清空的问题

🚧 Others

  • Slider: 加强组件的泛型支持,便于 valueonChange 联动 @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

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