TDesign Weekly Release (Oct 4th 2026)

Vue2 for Web 发布 1.16.3

🌈 1.16.3 2026-10-28

🐞 Bug Fixes

• fix: 优化 1.16.2 版本的兼容性问题 @uyarn (#3926)

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

Vue2 for Web 发布 1.16.2

🌈 1.16.2 2026-10-28

🚀 Features

• Tree:
  • 新增 checkAllAffectedBy，用于控制禁用子节点是否参与父节点全选、半选状态判断 @RSS1102 (#3914)
  • 新增支持 bigint 类型的节点值及滚动定位，修复零值节点操作和混合类型键的树数据查询异常。 @RSS1102 (#3915)
• TreeSelect: 新增支持 bigint 类型的选中值、回显及事件回传。 @RSS1102 (#3915)
• Cascader: 新增支持 bigint 类型的选中值，正确处理 0n 回显及 Vue2 节点渲染 @RSS1102 (#3915)

🐞 Bug Fixes

• Icon: 修复 usb 原始图标的图层 ID 错误导致在深色模式下渲染错误的问题 @uyarn (#298)(#3885)
• TreeSelect: 修复自定义 keys 下对象选中值回显、标签移除及 children 别名递归查找异常的问题。 @RSS1102 (#3916)
• Cascader: 修复多选值不在选项中时渲染报错、异步加载后 loading 画面残留的问题。 @RSS1102 (#3913)

📝 Documentation

• Comment: 修正 avatar 属性的类型描述，移除不受支持的 AvatarProps 类型 @liweijie0812 (#3923)
• Site: 新增全站及单组件的 llm.txt @liweijie0812 (#3889)

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

React for Web 发布 tdesign-react@1.18.6

🌈 1.18.6 2026-10-30

🚀 Features

• Tree
  • 新增 checkAllAffectedBy，支持配置父节点全选、半选状态的判定范围。@RSS1102 (#4452)
  • 支持 bigint 类型的选中值 @RSS1102 (#4450)
• TreeSelect: 支持 bigint 类型的选中值 @RSS1102 (#4450)
• Cascader: 支持 bigint 类型的选中值 @RSS1102 (#4450)

🐞 Bug Fixes

• Form: 修复 1.18.2 版本后，FormItem 卸载后重渲染仍保留旧值，且 UI 显示与 getFieldsValue 不一致的问题 @RylanBot (#4440)
• Slider: 修复开启 range 但传入空范围值时，无法正确交互的问题 @dvd233 (#4425)
• Drawer: 修复开启 sizeDraggable 时，拖拽中按下右键并松开后，尺寸仍跟随鼠标变化的问题 @RylanBot (#4435)
• Table: 修复开启 resizable 时，拖拽中按下右键并松开后，尺寸仍跟随鼠标变化的问题 @RylanBot (#4435)

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

React for Web 发布 tdesign-react@1.18.5

🌈 1.18.5 2026-10-23

🐞 Bug Fixes

• Drawer: 修复 mode='push' 时，margin 样式异常的问题 @RSS1102 (#4418)
• Form: 修复 1.18.3 版本后，最后一个表单项无 name 时上方字段 margin-bottom 丢失的问题@uyarn (#4427)

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

Vue3 for Mobile 发布 1.17.1

🌈 1.17.1 2026-10-29

🚧 Others

• build: 对齐构建工具链版本，修复 tree-shaking 失效 @anlyyao (#2393)

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

Vue3 for Mobile 发布 1.17.0

🌈 1.17.0 2026-10-29

🚀 Features

• Comment: 新增 Comment 评论组件 @boomLL (#2376)
• CheckboxGroup: 新增 direction 属性，表示复选框按钮排列方式 @anlyyao (#2337)
• DropdownItem: 新增 keepLabelActive 属性， 表示标题是否保持高亮（含菜单收起态），仅多选场景生效 @anlyyao (#2372)
• Form:
  • FormProps 支持 FormData 泛型 @anlyyao (#2344)
  • 新增 readonly 和 id 属性 @anlyyao (#2388)
• Guide: 新增 hideBack 属性，可隐藏最后一步的「返回」按钮 @anlyyao (#2340)
• Overlay: 新增 onOpen / onOpened / onClose / onClosed 过渡事件 @anlyyao (#2340)
• RadioGroup: 新增 direction 属性，表示单选框按钮排列方式 @anlyyao (#2337)
• SwipeCell: 新增 dragstart 和 dragend 事件 @liweijie0812 (#2345)

🐞 Bug Fixes

• ActionSheet: 支持列表项超出滚动 @Jesse205 (common#2742)
• Button: 修复短按时无悬浮样式 @Jesse205 (#2322)
• Collapse: 修复面板展开时底部线框样式错误 @anlyyao (#2323)
• Dialog: 修复在关闭后无法移除根元素 @Jesse205 (#2357)
• Form:
  • 修复全局 requiredMarkPosition 配置不生效 @Jesse205 (#2325)
  • 修正 setValidateMessage 误引用全局 FormData 类型 @anlyyao (#2344)
  • 表单项右侧箭头颜色随主题自适应 @yzh1002 (#2364)
  • 调整 FormItem 结构使 arrow 仅与标签和输入框居中对齐 @anlyyao (#2385)
  • 修复 contentAlign 属性无效 @anlyyao (#2388)
• Input:
  • 修复 password 类型输入框 placeholder 被字间距拉伸 @anlyyao (common#2718)
  • 移除 JS focus() 聚焦逻辑，改用原生 autofocus @Runc2333 (#1874)
• PullDownRefresh:
  • 修复下拉过快导致不触发刷新 @Jesse205 (#2375)
  • 修复 disabled 为 false 时，仍能触发下拉刷新问题 @boomLL (#2374)
• Rate:
  • 修复深色模式下的提示文本颜色 @liweijie0812 (common#2706)
  • 修复评分提示层被相邻 Slider 滑块遮挡的问题 @dvd233 (common#2737)
• Slider: 修复胶囊模式下滑轨圆角样式错误 @anlyyao (common#2736)
• Tag: 修复圆角样式值错误 @anlyyao (common#2716)
• Textarea:
  • 修复 placeholder 占位内容字号错误 @anlyyao (common#2717)
  • 移除 JS focus() 聚焦逻辑，改用原生 autofocus @Runc2333 (#1874)
• TreeSelect: 修复 keys.children 配置子节点字段别名不生效的问题。 @dvd233 (#2359)

📈 Performance

• Dialog: plugin 模式移除写死的 zIndex 默认值（原 2500），层级统一由样式表提供（@z-index-popup = 1500） @anlyyao (#2340)
• DropdownMenu:
  • 规范层级默认值，由 11600 调整为 1600，由样式表提供（@z-index-dropdown-menu = 1600） @anlyyao (#2340)
  • 改用 Popup 的 opened/closed 事件替代定时器控制关闭时机，确保关闭时机与动画实际结束对齐 @anlyyao (#2350)
• Message: 规范层级默认值，由 15000 调整为 5000，由样式表提供（@z-index-message = 5000） @anlyyao (#2340)
• Overlay: zIndex 移除内联默认值 1000，层级改由样式表 @z-index-overlay（1000）提供 @anlyyao (#2340)
• Popup: 规范层级默认值，由 11500 调整为 1500，由样式表提供（@z-index-popup = 1500） @anlyyao (#2340)
• Toast: 规范层级默认值，由 12001 调整为 2000，由样式表提供（@z-index-toast = 2000） @anlyyao (#2340)
• Style: 修正灰阶色值。深色主题：--td-gray-color-11 由 #383838 修正为 #393939；浅色主题：--td-gray-color-3 由 #e7e7e7 修正为 #e8e8e8，--td-gray-color-4 由 #dcdcdc 修正为 #ddd，--td-gray-color-5 由 #c5c5c5 修正为 #c6c6c6，--td-gray-color-11 由 #383838 修正为 #393939 @anlyyao (common#2715)
• Build: 升级 @typescript/native-preview 至 7.0.0-dev.20260707.2 并移除声明构建配置中的 @/* 路径别名，修复发布后类型提示降级为 any 的问题 @anlyyao (#2331)

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

Flutter for Mobile 发布 1.1.0

🌈 1.1.0 2026-10-28

🚨 Breaking Changes

• 升级提示：本版本包含公开 API、默认行为和视觉变化。使用 tdesign_flutter: ^1.0.0 的项目可能解析到 1.1.0；升级前请检查以下兼容性影响，并回归相关业务场景。

• TActionSheet: 命令式入口返回的 Popup 句柄默认在关闭后保留内容 State；重开时可复用，所属 Navigator 卸载时释放。替换会话时请检查 GlobalKey、Controller 和资源释放。 @RSS1102 (#1197)

• TButton: child 中的 TText 默认接受按钮尺寸、配色和状态文案样式；显式字段优先，依赖原正文默认值的用法需明确样式。 @RSS1102 (#1180)

• TCheckboxGroup: 新增 onSelectionLimitExceeded，保留旧参数和回调 onMaxSelected（业务自定义 implements TCheckboxGroup 须补 onSelectionLimitExceeded getter，否则无法编译；旧入口已废弃，计划在 2.0.0 删除）。 @RSS1102 (#1196)

• TDrawer: 新增 onItemTap / TDrawerItemTapCallback，保留旧参数、回调入口及类型（业务自定义 implements TDrawer 须补 onItemTap getter，否则无法编译；旧入口已废弃，计划在 2.0.0 删除）。 @RSS1102 (#1196)

• Theme:

  • 调整 Badge、SideBar、Cell 圆角，Table、Tabs、Toast 内边距，以及 BackTop、Dropdown、Refresh 图标的默认规格。 @RSS1102 (#1174)
  • 将已核实的组件默认属性接入全局 Token，自定义主题时对应尺寸、间距及圆角开始联动，保留显式覆盖优先级。 @RSS1102 (#1174)
  • 部分组件 ThemeData 新增配置或解析成员；业务通过 implements 自行实现这些类型时，可能需要补充成员或调整实现，升级前请检查编译结果。 @RSS1102 (#1172) (#1174)

• TNavBar: title 中的 TText 默认接受导航标题字体和颜色；复合标题及长标题可能改变布局，保留旧外观需显式定制。 @RSS1102 (#1180)

• TNoticeBar: 新增 onTargetTap，保留旧参数和回调 onPressed（业务自定义 implements TNoticeBar 须补 onTargetTap getter，否则无法编译；旧入口已废弃，计划在 2.0.0 删除）。 @RSS1102 (#1196)

• TPickerPopup: 关闭后默认保留内容 State；同一句柄在同一 Navigator 中重开时可复用。设置 destroyOnClose: true 时关闭后释放。1.0.0 关闭后始终释放，升级时请检查状态重置和资源生命周期。 @RSS1102 (#1197)

• TPopover: 新增 onLongPress，保留旧参数和回调 onLongTap（业务自定义 implements TPopoverAnchor 或 TPopoverWidget 须补 onLongPress getter，否则无法编译；旧入口已废弃，计划在 2.0.0 删除）。 @RSS1102 (#1196)

• TPopup:

  • TPopupOverlayConfig 改为 final class，包外继承、implements 和相关 mock 需要改用直接构造或组合。旧 onClick 保留但已废弃；onTap 非空时优先。 @RSS1102 (#1199)
  • 关闭后默认保留内容 State；同一句柄在同一 Navigator 中重开时可复用。设置 destroyOnClose: true 时关闭后释放。1.0.0 关闭后始终释放，升级时请检查状态重置和资源生命周期。 @RSS1102 (#1197)

• TSteps: 新增 onStepTapped，保留旧参数和回调 onChange，保留当前步骤点击通知（业务自定义 implements TSteps、TStepsHorizontal 或 TStepsVertical 须补 onStepTapped getter，否则无法编译；旧入口已废弃，计划在 2.0.0 删除）。 @RSS1102 (#1196)

• TTabBar:

  • 新增菜单 onSelected，保留旧参数和回调 onChanged（业务自定义 implements TTabBarPopUpBtnConfig 须补 onSelected getter，否则无法编译；旧入口已废弃，计划在 2.0.0 删除）。 @RSS1102 (#1196)
  • 新增 notifyOnReselect，保留旧参数和字段 allowMultipleTaps（业务自定义 implements TTabBarItemConfig 须补 notifyOnReselect getter，否则无法编译；旧入口已废弃，计划在 2.0.0 删除）。 @RSS1102 (#1196)

🚀 Features

• TBackTop: 新增 onCompleted，成功回顶后触发；onPressed 保持原有时机（计划在 2.0 统一为点击时触发，成功回顶通知使用 onCompleted）。 @RSS1102 (#1193)
• Theme: 新增 Badge 气泡圆角、Button 四档图标尺寸和 Tag 四档内边距配置；默认视觉变化见上方说明。 @RSS1102 (#1172)
• TPopup: 新增蒙层点击回调 onTap，兼容旧入口。 @RSS1102 (#1199)

🐞 Bug Fixes

• DropdownMenu: 隔离共享 Controller 的状态与过期回调 @lnuxe (#1203)
• TAvatar: 补齐 TText 头像文字默认样式 @RSS1102 (#1182)
• TCalendar: 补齐日期副标题的 TText 默认样式 @RSS1102 (#1182)
• TCellGroup: 修复 scrollable 在无界高度父级下触发布局异常 @runoob-coder (#1162)
• TCollapse: 补齐标题、正文和尾部的 TText 默认样式 @RSS1102 (#1182)
• TDialog:
  • 修复 TText 标题与正文未应用弹窗文字样式的问题 @RSS1102 (#1181)
  • 修复文字操作区在长文案换行或文字缩放时的裁切，默认高度保持56，内容需要时增高。 @RSS1102 (#1180)
• TDivider: 补齐 TText 分隔线标签默认样式 @RSS1102 (#1182)
• TDrawer:
  • 保留标题的 TD 段落设置 @RSS1102 (#1182)
  • 自定义菜单正文接入菜单默认字体 @RSS1102 (#1184)
• TDropdownMenu: 修复旧组件解绑影响后绑定组件菜单命令的问题 @RSS1102 (#1191)
• TFooter:
  • 修复 Web 端链接文字被压缩后逐字竖排的问题 @liweijie0812 (#1113)
  • 修复链接组换行后分隔线出现在行尾或独占一行的问题 @liweijie0812 (#1113)
• TForm: 修复 Controller 替换失败后原绑定失效及卸载清理异常 @RSS1102 (#1191)
• Theme:
  • 修复主题 Token 更新后已打开浮层未实时响应的问题，保留显式配置优先级。 @RSS1102 (#1172)
  • 修复稀疏尺寸 Token 默认端点及 Tag 分档内边距中断过渡的覆盖丢失。 @RSS1102 (#1172)
• TLink: 补齐 TText 链接默认样式 @RSS1102 (#1182)
• TLoading: 修复所属 Overlay 卸载后全局加载会话未自动释放的问题 @RSS1102 (#1190)
• TMessage: 修复所属 Overlay 卸载时遗留句柄和 Entry 的问题 @RSS1102 (#1190)
• TNoticeBar: 修复自定义区域将拖动、长按、多指及鼠标按键组合误判为点击的问题 @RSS1102 (#1192)
• TPicker: 自定义选项接入选中与禁用状态字体 @RSS1102 (#1184)
• TPopover:
  • 修复自然尺寸及单行、省略和支柱测量 @RSS1102 (#1182)
  • 自定义内容子树接入气泡默认字体和颜色 @RSS1102 (#1184)
• TProgress: 补齐 TText 进度标签默认样式 @RSS1102 (#1182)
• TPullDownRefresh:
  • 修复旧组件解绑影响后绑定组件刷新命令的问题 @RSS1102 (#1191)
  • 修复未下拉刷新时顶部提示文字溢出绘制的问题。 @RSS1102 (#1209)
• TSlider:
  • 修复滑块端点、数值和刻度的位置不对齐。 @runoob-coder (#1212)
  • 修复受限尺寸及布局变化时滑块拖动异常。 @runoob-coder (#1212)
• TSteps: 自定义标题和说明接入对应方向及状态字体 @RSS1102 (#1184)
• TSwipeCell: 修复 Controller 替换失败后原控制器无法继续控制的问题 @RSS1102 (#1191)
• TSwiper: 修复重复提交无效 Controller 时绕过绑定校验的问题 @RSS1102 (#1191)
• TTabBar:
  • 自定义菜单项接入默认字体并按真实内容适配行高 @RSS1102 (#1184)
  • 修复菜单回调内导航或自行关闭后误关其他页面的问题，保留原回调时机；新页面覆盖时仅移除原菜单。 @RSS1102 (#1198)
• TTable: 补齐表头和单元格的 TText 默认样式 @RSS1102 (#1182)
• TToast:
  • 自定义普通/加载文案接入 Toast 默认字体和颜色 @RSS1102 (#1184)
  • 修复所属 Overlay 被遮挡后卸载时遗留实例和计时任务的问题 @RSS1102 (#1190)

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