CHANGELOG.md

title	更新日志
docClass	timeline
toc	false
spline	explain

🌈 0.19.0 2025-08-01

🚀 Features

• QRCode: 新增 QRCode 二维码组件 @anlyyao (#696)
• Popup: 新增 duration 属性 @novlan1 (#691)

🐞 Bug Fixes

• BackTop: 修复默认返回按钮图标无效 @anlyyao (#682)
• Cascader: 修复深色模式 0.5px 边框颜色错误 @anlyyao (#682)
• Overlay: 修复深色模式背景色错误 @anlyyao (#682)
• Upload: 修复移除按钮颜色错误 @anlyyao (#682)
• Switch: 修复 loading 颜色、dot 滑块禁用态/深色模式背景色错误 @anlyyao (#687)
• NoticeBar: 修复 warning 和 error 主题默认图标错误 @novlan1 (#688)
• Guide: 修复 popover 下展示位置错误问题 @novlan1 (#689)
• PullDownRefresh: 修复 change 事件不生效问题 @novlan1 (#690)
• Sticky: 修复滚动元素找不到问题 @novlan1 (#692)

🚧 Others

• site: 修复主题生成器在移动端预览窗口无效的问题 @anlyyao (#682)

🌈 0.18.0 2025-07-15

🚀 Features

• Form: 新增 Form 组件 @slatejack (#666)
• Upload: 组件重构， 存在 DOM 调整。新增 allowUploadDuplicateFile、beforeUpload、autoUpload 等多个属性，支持图片预览 @slatejack (#549)

🚧 Others

• fix(build): 修复 0.17.0 版 npm 包中组件文件路径错误 @anlyyao (#679)

🌈 0.17.0 2025-07-11

🚀 Features

• Picker: 新增 Picker 选择器组件 @ZWkang @novlan1 (#655)
• DateTimePicker: 新增 DateTimePicker 时间选择器组件 @novlan1 (#672)
• Footer: 新增 Footer 页脚组件 @anlyyao (#676)
• Table: 新增 rowAttributes 和 rowClassName 属性，暴露组件实例的 refreshTable 方法 @anlyyao (#669)

🐞 Bug Fixes

• BackTop: 补充默认 target 值 @novlan1 (#671)

🌈 0.16.0 2025-07-04

🚀 Features

• Fab: 支持使用默认插槽自定义悬浮按钮内容，此时 buttonProps、icon 和 text 属性将失效 @novlan1 (#645)
• Calendar: 新增 switchMode 和 readonly 属性 @novlan1 (#663)
• Table: 支持 fixedRows 属性，列配置项支持 fixed 属性 @novlan1 (#662)

🚧 Others

• React: 全面升级相关依赖，直接支持 React 19 @HaixingOoO (#606)

🌈 0.15.0 2025-05-29

🚀 Features

• ImageViewer: 新增图片预览组件 @novlan1 (#607)

🐞 Bug Fixes

• TabPanel: 修复组件内容未展示的问题 @betavs (#638)

🌈 0.14.0 2025-05-16

🚀 Features

• Cascader: 新增 Cascader 组件 @ming680 @anlyyao (#475)
• DropdownMenu: 新增 DropdownMenu 组件 @ming680 @anlyyao (#503)
• Overlay: 新增遮罩动画系列回调函数，包括 onOpen、onOpened、onClose 和 onClosed 事件 @anlyyao (#629)
• PullDownRefresh: 新增 disabled 属性 @anlyyao (#631)

🐞 Bug Fixes

• Button: 修复按钮点击态样式缺失 @anlyyao (#627)
• Steps: 修复内置图标无效的问题 @anlyyao (#635)

🌈 0.13.2 2025-04-25

🚀 Features

• Icon: 新增 logo-miniprogram、logo-cnb、seal、quote 图标 @taowensheng1997 @uyarn (#621)

🐞 Bug Fixes

• Icon: 优化多个文件相关图标的绘制效果，修复 gesture-right-slip 的绘制问题@uyarn(#621)
• Slider: marks 属性不支持 ()=>TNode 渲染的问题 @anlyyao (#622)

🌈 0.13.1 2025-04-21

🐞 Bug Fixes

• SideBar: 修复组件未导出问题 @anlyyao (#616)

🌈 0.13.0 2025-04-18

🚀 Features

• Icon: 图标库版本更新到 0.4.4(#590)
• Toast: 新增 warning 主题 @betavs (#589)
• Fab: 新增 draggable，yBounds ，onDragEnd 和 onDragStart 等属性，支持组件拖拽 @novlan1 (#594)
• List: 新增 List 组件 @feaswcy (#463)
• ActionSheet: 新增 ActionSheet 组件 @TianlunXiong (#471)
• Progress: 新增 size 属性，仅在环形进度条有效 @anlyyao (#609)
• CollapsePanel: 优化面板折叠动画 @anlyyao (#611)

🐞 Bug Fixes

• Textarea: 修复传入参数类型错误 @RSS1102 (#591)；修复 iOS 真机上输入内容重复的问题，并补充 onCompositionstart 和 onCompositionend 属性 @anlyyao (#601)

🚧 Others

• site: 站点接入主题生成器 @RylanBot (#604)

🌈 0.12.0 2025-03-12

🚨 Breaking Changes

• Dialog: 新增 closeBtn、width、overlayProps 属性和 middle、top 插槽，存在 DOM 调整 @epoll-j (#548)
• Swiper: 组件重构，存在 DOM 调整。新增 nextMargin、previousMargin 和 click 事件。并对 navigation 属性进行功能增强，新增 paginationPosition、showControls 属性，移除 showSlideBtn 属性 @xifanTT (#557)

🐞 Bug Fixes

• ColorPicker: 修复组件 es 产物缺样式文件入口 @anlyyao (#577)

🚧 Others

• site: 站点接入 stackblitz 和中英文切换能力 @anlyyao (#579)

🌈 0.11.0 2025-03-07

🚨 Breaking Changes

• Steps: 组件重构，移除 options 和 separator 属性，新增 currentStatus、sequence 属性，存在 DOM 调整 @Lyan-u (#532)
• StepItem: 组件重构，新增 titleRight、extra 属性，存在 DOM 调整 @Lyan-u (#532)

🚀 Features

• ColorPicker: 新增 ColorPicker 组件 @slatejack (#569)
• CheckboxGroup: 新增 borderless、readonly 和 keys 属性 @liweijie0812 (#572)
• Calendar: 新增 Calendar 日历组件 @epoll-j (#528)
• TreeSelect: 新增 TreeSelect 组件 @epoll-j (#523)
• ConfigProvider: 新增 ConfigProvider 组件 @anlyyao (#574)

🐞 Bug Fixes

• Cell: 修复部分样式错误，并更新 align 属性描述 @liweijie0812 (#568)

🌈 0.10.0 2025-01-20

🚀 Features

• Radio: 组件重构，新增 block、borderless、placement 与 readonly 等属性 @byq1213 (#468)
• RadioGroup: 组件重构，新增 allowUncheck、borderless、keys 、placement 与 readonly 等属性 @byq1213 (#468) @liweijie0812 (#555)
• Rate: 组件重构，废弃 variant 属性， 新增 placement 与 icon 属性 @ming680 (#493)
• Input: 新增 enterkeyhint API 用于控制回车键样式，此 API 仅在部分浏览器支持，HTML5 原生属性。新增 spellcheck API 是否开启拼写检查，HTML5 原生属性 @liweijie0812 (#553)
• Icon: 新增logo-alipay、logo-behance-filled等图标，修改logo-wecom图标，移除不合理的logo-wecom-filled图标，并优化部分图标的绘制路径 @uyarn @tdesign-bot (#559)
• Swiper: 新增 touchable 属性 @anlyyao (#565)

🐞 Bug Fixes

• Swiper: 修复缺少 ref 传递导致的控制台报错问题 @cc-weng (#534)

🌈 0.9.0 2024-11-11

🚨 Breaking Changes

• Textarea: 组件重构，新增 allowInputOverMax，bordered 与 readonly 等属性 @anlyyao (#526)
• Avatar: 组件重构，新增 imageProps 属性 @slatejack (#541)

🚀 Features

• Guide: 新增 Guide 组件 @novlan1 (#535)

🐞 Bug Fixes

• CountDown: 修复毫秒级计算器计算错误 @novlan1 (#542)

🌈 0.8.0 2024-10-17

🚨 Breaking Changes

• Switch: 组件重构，移除 colors 属性，change 事件参数有调整 @anlyyao (#527)
• PullDownRefresh: 组件重构，maxBarHeight 与 loadingBarHeight 属性扩展支持 string 类型，并新增 onRefresh、onScrolltolower 和 onTimeout 等属性 @novlan1 (#479)
• Message: 组件重构，新增 align、link、marquee、offset、onCloseBtnClick、onDurationEnd 以及 onLinkClick 等属性，并移除 onClose、onClosed、onOpen、onOpened 与 onVisibleChange 等属性 @novlan1 (#477)

🚀 Features

• Input: 支持 format 属性 @anlyyao (#533)

🐞 Bug Fixes

• Stepper: 修复无法直接输入的问题 @anlyyao (#537)

🌈 0.7.0 2024-09-20

🚨 Breaking Changes

• Checkbox: 组件重构，新增 readonly 属性 @epoll-j (#504)
• Drawer: 组件重构，新增 attach、title 和 footer 等属性，并支持函数式调用 @novlan1 (#488)
• SwipeCell: 组件重构，移除 expanded 属性，新增 opened 属性 @novlan1 (#492)
• Indexes: 组件重构，移除 list, height 属性，select 事件参数有变更，新增indexList, sticky 与 stickyOffset 等属性，新增 change 事件，新增IndexesAnchor子组件； @Lyan-u (#513)
• Stepper: 组件重构，新增 integer 和 size 属性，新增 focus 事件 @taninsist (#525)
• Slider: 组件重构，新增 theme 属性，dragend 事件参数有调整 @slatejack (#522)
• Tabs: 组件重构，新增bottomLineMode 、spaceEvenly 属性，新增onClick、onScroll 事件 @epoll-j (#515)
• Toast: 组件重构，新增 style、className、showOverlay 和 overlayProps 等属性，新增 close 事件 @novlan1 (#494)

🚀 Features

• Empty: 新增 Empty 组件 @epoll-j (#505)
• Popover: 新增 Popover 组件 @epoll-j (#510)

🌈 0.6.1 2024-09-04

🚀 Features

• Icon: 更新图标库版本到 0.3.5 ，lock-on 图标存在更新 @liweijie0812 (#507)

🌈 0.6.0 2024-08-30

🚀 Features

• Table: 新增 Table 组件 @TianlunXiong (#472)
• SideBar: 新增 SideBar 组件 @tobytovi (#491)
• layout: 新增 layout 组件 @jiasy1616 (#452)
• NoticeBar: 新增 direction 属性， extra 属性名称变更为 operation，废弃 change 事件 @slatejack (#501)
• TabBar: 新增 children、split 和 shape 等属性 @tobytovi (#482)
• TabBarItem: 新增 children 属性 @tobytovi (#482)
• Collapse: 新增 children 和 theme 属性 @tobytovi (#500)
• CollapsePanel: 新增 placement 和 headerLeftIcon 属性 @tobytovi (#500)

🐞 Bug Fixes

• Badge: 修复 content 为 ReactNode 类型时组件渲染异常 @anlyyao (#499)

🌈 0.5.0 2024-08-23

🚨 Breaking Changes

• Input: 组件重构，新增 allowInputOverMax、autocomplete、borderless、readonly、status 与tips 属性，新增 onValidate 事件 @slatejack (#467)
• Popup: 组件重构，新增 attach、closeBtn、closeOnOverlayClick、destroyOnClose、preventScrollThrough 等属性，新增 onClose、onClosed、onOpen、onOpened 等事件 @hkaikai (#449)
• Search: 组件重构，新增 clearable 和 readonly 属性，新增 onActionClick 事件 @slatejack (#476)
• Badge: 组件重构，size 默认值变更为 medium，size 与 shape 属性 可选项存在变更 @anlyyao (#487)
• CountDown: 新增 children，作用同 content 属性，size 默认值变更为 medium @anlyyao (#481)
• Navbar: 组件重构，移除 homeIcon、leftIcon、rightIcon 等属性、移除 onHomeClick 事件，新增 capsule、left、leftArrow、right 等属性、新增 onRightClick @04756 (#450)
• GridItem: badgeProps 属性更名为 badge @Lyan-u (#448)

🚀 Features

• Link: 新增 Link 组件 @Magicalboys (#443)
• Image: 新增 referrerpolicy 和 fallback 属性 @anlyyao (#470)
• Button: 新增 loadingProps 和 suffix 属性，并修复虚框按钮样式错误 @tobytovi (#469)
• Grid: 新增 theme 属性 @Lyan-u (#448)

🌈 0.4.0 2024-08-16

🚨 Breaking Changes

• BackTop: 组件重构，新增 container ，visibilityHeight 属性，新增 onToTop 事件 @ssmyaojiayouya (#430)
• Progress: 组件重构，新增 theme, className, style 属性 @anlyyao (#387)
• Divider: 组件重构，废弃lineColor 属性 @liweijie0812 (#403)
• Cell: 组件重构，Dom 有调整 @dexterBo (#432)
• Loading: 组件重构，移除 progress 属性 ，新增 attach、content 和 fullscreen 属性，支持 loading 或 LoadingPlugin 插件函数 @anlyyao (#458)
• Skeleton: 组件重构，支持 delay 属性 @anlyyao (#455)

🚀 Features

• Result: 新增 Result 组件 @slatejack (#431)
• Overlay: 新增 Overlay 组件 @anlyyao (#451)
• Tabs: 支持 className 和 style 组件参数 @Charles-1999 (#357)
• CellGroup: 新增 theme 属性 @dexterBo (#432)
• Tag: 新增 children 属性 @taninsist (#445)
• CheckTag: 新增 variant 属性 @taninsist (#445)
• Icon: 更新 Icon 版本至 0.3.4 并补齐示例 @anlyyao (#456)

🐞 Bug Fixes

• Toast: 修复 preventScrollThrough 属性类型声明与文档描述不一致 @betavs (#372)

🚧 Others

• Sticky: 更新组件示例与 API 文档 @byq1213 (#435)

🌈 0.3.1 2022-11-28

🚀 Features

• Skeleton: rowCols 支持传入 borderRadius @yuanmeda (#318)

🐞 Bug Fixes

• Checkbox: 修复点击 content 无反应的问题 @LeeJim (#328)

🚧 Others

• Badge: 更新示例代码 @teal-front (#299)
• Textarea: 更新示例代码 @palmcivet (#301)
• Search: 更新示例代码 @palmcivet (#309)
• Slider: 更新示例代码 @yuanmeda (#313)
• Steps: 更新示例代码 @yuanmeda (#314)
• Upload: 更新示例代码 @yuanmeda (#315)
• Progress: 更新示例代码 @xxxlj (#319)
• BackTop: 更新示例代码 @yuanmeda (#317)
• PullDownRefresh: 更新示例代码 @yuanmeda (#318)
• Button: 更新示例代码 @TingShine (#321)
• Image: 更新示例代码 @TingShine (#322)
• Stepper: 更新示例代码 @TingShine (#308)
• Loading: 更新示例代码 #476 @lockiechen (#323)
• TabBar: 更新示例代码 @yuanmeda (#302)
• CheckBox: 更新示例代码 @yuanmeda (#303)
• Textarea: 更新示例代码 @palmcivet (#301)
• Fab: 更新示例代码 @yuanmeda (#304)
• Input: 更新示例代码 @palmcivet (#300)
• Divider: 更新示例代码 @yuanmeda (#305)
• Sticky: 更新示例代码 @yuanmeda (#306)
• Rate: 更新示例代码 @yuanmeda (#307)

🌈 0.3.0 2022-10-25

🚀 Features

• NoticeBar: 新增公告栏组件 @ZWkang (#292)
• Grid: 透传所有非定义的 props 至根元素 @ZWkang (#293)

🚧 Others

• Avatar: 更新示例代码 @anlyyao (#296)

🌈 0.2.0 2022-07-25

🚀 Features

• Drawer: 新增抽屉组件 @APlanckFish (#271)

🚧 Others

• site: 官网更新组件分类 @LeeJim (#279)

🌈 0.1.2 2022-07-18

🐞 Bug Fixes

• Sticky: 修复 fixed 状态下丢失宽度的问题 @LeeJim (#277)

🚧 Others

• chore: 优化更新日志文档样式 @HQ-Lin (#276)

🌈 0.1.1 2022-07-12

🚀 Features

• Tag: 视觉升级以及新增支持左图标 @anlyyao (#270)
• Progress: 新增 Progress 组件 @yilaierwang (#273)
• Fab 新增 Fab 组件 @anlyyao (#266)

🐞 Bug Fixes

• Search: 修复无法使用的问题 @Perisiguiendo (#269)
• Button: 补充支持 style 属性 @anlyyao (#266)

🌈 0.1.0 2022-06-29

• 首发版本