v5.20.0

New Features

• 560c291 5a696c5 Rate: Support slide gesture (#5497) (#5505)
• 6b0c107 SwipeAction: Add onActionsReveal prop (#5484)
• ea21796 Form: Add new requiredMarkStyle option none (#5486)

Enhancements

• 68f3692 Upgrade @use-gesture/react to 10.2.17
• 0d94c63 Update id-ID locale (#5485)

Bug Fixes

• f580110 830b96b SwipeAction: Fix position blink sometimes (like #5490) (#5514)
• be90116 Swiper: Fix a dragging gesture bug when imperatively call jumpTo in the onClick event of Swiper.Item
• 88b0fea useResizeEffect: Avoid ResizeObserver loop limit exceeded error (#5491)

---

特性

• 560c291 5a696c5 Rate: 支持了滑动手势 (#5497) (#5505)
• 6b0c107 SwipeAction: 新增了 onActionsReveal 属性 (#5484)
• ea21796 Form: requiredMarkStyle 属性新增了可选项 none，用于完全不显示必填标记 (#5486)

优化

• 68f3692 升级 @use-gesture/react 到 10.2.17
• 0d94c63 更新了 id-ID 翻译 (#5485)

修复

• f580110 830b96b SwipeAction: 修复了在某些情况下可能位置出现闪烁偏移的问题 (参见 #5490) (#5514)
• be90116 Swiper: 修复了当手动在 Swiper.Item 的 onClick 事件中调用 jumpTo 方法时，可能会导致手势异常的问题
• 88b0fea useResizeEffect: 避免出现 ResizeObserver loop limit exceeded 报错 (#5491)

v5.19.0

New Features

• a102c4b Add .umd.js and .compatible.umd.js bundles
• 34502ca Cascader & CascaderView: Add activeIcon prop (#5462)
• 82a35de Modal & Dialog & ActionSheet: Omit destroyOnClose and forceRender types in imperatively show mode (#5475)
• d21b9ef NumberKeyboard: Support multiple customKeys (#5458)

Enhancements

• 710f301 PasscodeInput: Export type PasscodeInputRef
• 0569fa9 PasscodeInput: Use aria labels to imporve a11y and adjust classname (#5476)
• eccdcb3 NumberKeyboard: Adjust className with prefix (#5454) ⚠️
• 2ad7b75 Result: Add default value for status prop (#5480)
• 01d27e0 SearchBar: Use aria labels to imporve a11y (#5465)
• b175374 Calendar: Replace renderLabel type string to ReactNode (#5450)

Bug Fixes

• ebd9a91 SearchBar: Prevent getting duplicated value on enter press with some IMEs (#5466)
• bc56b48 ImageViewer: Scale origin is inaccurate when pinching (#5461)
• 5338920 Button: Fix React's bug when the browser translation function is enabled (#5460)

---

特性

• a102c4b 增加了 .umd.js 和 .compatible.umd.js 的预构建产物
• 34502ca Cascader & CascaderView: 增加了 activeIcon 属性 (#5462)
• 82a35de Modal & Dialog & ActionSheet: 在指令式的 show 方法的 ts 类型定义中，去除了 destroyOnClose 和 forceRender 属性 (#5475)
• d21b9ef NumberKeyboard: 支持配置两个自定义按键 (#5458)

优化

• 710f301 PasscodeInput: export 了 PasscodeInputRef 类型
• 0569fa9 PasscodeInput: 优化了可访问性，并且调整了一些 CSS 类名 (#5476) ⚠️
• eccdcb3 NumberKeyboard: 调整了一些 CSS 类名 (#5454) ⚠️
• 2ad7b75 Result: 为 status 属性增加了默认值 (#5480)
• 01d27e0 SearchBar: 优化了可访问性 (#5465)
• b175374 Calendar: renderLabel 属性的类型从 string 调整为了 ReactNode (#5450)

修复

• ebd9a91 SearchBar: 避免在输入法中按下回车键会导致插入重复的值 (#5466)
• bc56b48 ImageViewer: 修复了缩放时中心偏移的问题 (#5461)
• 5338920 Button: 修复了和浏览器翻译功能的兼容性问题 (#5460)

v5.18.0

New Features

• 7be2bb0 Switch: Deprecate beforeChange prop and onChange supports promise (#5456) ⚠️

Enhancements

• ea463ee Rate: Use aria labels to imporve a11y (#5449)
• d2afb1f NoticeBar: Adjust the clickable area of close icon (#5448)
• 4ecbbf2 A minor refactor to reduce bundle size
• c7aeec4 Upgrade rc-field-form to 1.27 and @use-gesture/react to 10.2.16

Bug Fixes

• 9fec063 Tabs: Fix the background color in dark mode
• c7a772b Form: Form.Item now supports native props (aka style className aria-* data-*)
• 6393aa9 fee2ff5 Calendar: CalendarRef used to be misspelled as CalenderRef (#5443) ⚠️

---

特性

• 7be2bb0 Switch: 弃用了 beforeChange 属性，同时 onChange 属性支持了返回 promise (#5456) ⚠️

优化

• ea463ee Rate: 增加了一些 aria 标记，优化可访问性 (#5449)
• d2afb1f NoticeBar: 扩大了关闭图标的点击范围 (#5448)
• 4ecbbf2 底层做了一些重构，稍微减少了一些包体积
• c7aeec4 rc-field-form 升级到了 1.27，@use-gesture/react 升级到了 10.2.16

修复

• 9fec063 Tabs: 修复了深色模式下的背景色
• c7a772b Form: Form.Item 支持了 native props（也就是 style className aria-* data-*）
• 6393aa9 fee2ff5 Calendar: ts 类型 CalenderRef 之前拼写错误了，现在纠正为 CalendarRef 了 (#5443) ⚠️

v5.17.2

Bug Fixes

• 6abb71e FloatingPanel: Fix the background color in dark mode
• 1146296 FloatingPanel: Fix --border-radius applying to the wrong element (#5432)
• 18443f2 TextArea: Revert 86c70fc to fix the problem of height not changing when content get deleted (#5427)
• fae4554 Picker: In some circumstances wheel may not scroll to the correct position

---

修复

• 6abb71e FloatingPanel: 修复了深色模式下的背景色
• 1146296 FloatingPanel: 修复了 --border-radius 应用到了错误的元素上的问题 (#5432)
• 18443f2 TextArea: 回退了 86c70fc 的改动，以修复当内容变化时 TextArea 高度可能不会降低的问题 (#5427)
• fae4554 Picker: 修复了在某些情况下拨轮所滚动的位置异常的问题

v5.17.1

Bug Fixes

• Fix the broken npm package of v5.17.0.

修复

• 5.17.0 发布的 npm 包有误，重新发布

v5.17.0

New Features

• fcf05d2 Picker: Add loading & loadingContent props (#5404)
• c152cf3 Image: Add onContainerClick prop (#5419)

Enhancements

• 050e83e 7cb6691 Adjust the style of some components in dark mode (#5395) (#5386)

Bug Fixes

• 4a81b83 CapsuleTab & JumboTab: Animation does not work when content height change (#5421)
• 05b1814 Cascader & CascaderView: Fix onTabsChange not being triggered when jump to next level
• 6177784 onChange prop should only be called when the previous and next values are different
• 1b78356 Empty: Fix svg image too high on iOS 11.4
• 86c70fc TextArea: Fix autoSize may cause blinking in some browsers

---

特性

• fcf05d2 Picker: 增加了 loading 和 loadingContent 属性，用来控制 Picker 的加载状态 (#5404)
• c152cf3 Image: 增加了 onContainerClick 属性 (#5419)

优化

• 050e83e 7cb6691 优化了一些组件在深色模式下的样式 (#5395) (#5386)

修复

• 4a81b83 CapsuleTab & JumboTab: 修复了当内容高度变化时，tab 切换的动画效果缺失的问题 (#5421)
• 05b1814 Cascader & CascaderView: 修复了当自动进入下一级选项时，onTabsChange 事件没有触发的问题
• 6177784 各种组件的 onChange 事件现在只会在前后两次值不一样时才进行触发了
• 1b78356 Empty: 修复了在 iOS 11.4 上 svg 元素高度异常的问题
• 86c70fc TextArea: 修复了当开启 autoSize 时，输入框可能出现闪烁的问题

v5.16.1

Bug Fixes

• 829d873 Popup: The default value of getContainer should be () => document.body instead of null (#5388)

修复

• 829d873 Popup: getContainer 属性的默认值应该是 () => document.body 而非 null (#5388)

v5.16.0

New Features

• ee41ac0 Cascader: Add a new actions param to children render function (#5375)
• 3fe936a List: Support nativeElement ref (#5369)
• 7e07480 ProgressBar: Add text prop and --text-width CSS variable
• 333d5e8 ProgressBar: Add rounded prop
• afec81c Popup: Add disableBodyScroll prop
• 72ba539 Popup & CenterPopup: Add closeOnMaskClick onClose showCloseButton props
• ef1cbf0 Modal: Change Action.text type to ReactNode (#5354)
• 9d59d4b Add id-ID locale (#5357)
• 0cdd57c Add kk-KZ locale (#5355)

Enhancements

• 429424d ProgressBar: Adjust the default track width to 8px
• b972f75 Stepper: Use aria propss to improve a11y (#5365)
• 3576b64 Slider: Use aria props to improve a11y (#5359)
• da26fbb Popup: Refactor the implementation and now it will render with ShouldRender (#5338)

Bug Fixes

• e0d2c44 Picker: Fix some accessibility issues on android (#5370)
• 35642f1 Steps: Icon background should be black in dark mode (#5371)

---

特性

• ee41ac0 Cascader: children 的 render 函数增加了 actions 参数 (#5375)
• 3fe936a List: 支持了 ref，暴露出了 nativeElement (#5369)
• 7e07480 ProgressBar: 增加了 text 属性和 --text-width CSS 变量
• 333d5e8 ProgressBar: 增加了 rounded 属性
• afec81c Popup: 增加了 disableBodyScroll 属性
• 72ba539 Popup & CenterPopup: 增加了 closeOnMaskClick onClose showCloseButton 属性
• ef1cbf0 Modal: 调整了 Action.text 的类型为 ReactNode (#5354)
• 9d59d4b 增加了 id-ID 翻译 (#5357)
• 0cdd57c 增加了 kk-KZ 翻译 (#5355)

优化

• 429424d ProgressBar: 调整了默认的轨道宽度为 8px
• b972f75 Stepper: 使用 aria 属性优化了组件的无障碍支持 (#5365)
• 3576b64 Slider: 使用 aria 属性优化了组件的无障碍支持 (#5359)
• da26fbb Popup: 重构了底层实现，使用了统一的 ShouldRender (#5338)

修复

• e0d2c44 Picker: 修复了一些安卓环境下的无障碍问题 (#5370)
• 35642f1 Steps: 修复了在深色模式下图标的背景颜色不正确的问题 (#5371)

v5.15.1

Enhancements

• 35ed247 Dialog: Improve a11y (#5337)
• c43bf1a Switch: Improve a11y (#5331)

Bug Fixes

• f609819 Radio: onChange should be call once when the selected item is clicked multiple times (#5343)
• 452ea60 DatePicker & DatePickerView: Fix year filter not working (#5340)

---

优化

• 35ed247 Dialog: 优化了对无障碍的支持 (#5337)
• c43bf1a Switch: 优化了对无障碍的支持 (#5331)

修复

• f609819 Radio: 当用户多次点击时，现在 onChange 事件只会触发一次了 (#5343)
• 452ea60 DatePicker & DatePickerView: 修复了 filter 中 year 的配置没有生效的问题 (#5340)

v5.15.0

New Features

• 05c6215 List: Add max-width limit to extra part for preventing overflow & add --extra-max-width
• 6b4b6a4 Checkbox: Add ref for Checkbox which supports check uncheck toggle methods
• 87533ec TextArea: Support nativeElement ref (#5307)
• 2ebede5 Badge: Add wrapperClassName and wrapperStyle props (#5302)

Enhancements

• 22b03da Star: Adjust the star icon
• 6412725 InfiniteScroll: Add throttle logic for scroll position check to have better performance
• 2262837 Icon: Upgrade antd-mobile-icons to 0.3.0 so that the svg elements won't have the nonsense titles
• 2feb9c4 Toast: Refactor the implementation of Toast.show (#5296)
• c3bc2b6 Badge: Change the class name of the wrapper element to adm-badge-wrapper (used to be adm-badge-wrap)

Bug Fixes

• 7686a15 SafeArea: Fix SafeArea becoming too high in some rem layout projects. Add --multiple and --adm-safe-area-multiple for manually adjusting the height.
• 12328b2 Form: Avoid rendering an empty description node (#5320)
• 53f36ec List: Revert #5277 to prevent unexpected line breaks in extra part
• 434b980 InfiniteScroll: Prevent dropping into the infinite loop trap for React 18 apps
• b841bde ImageUploader: Fix some images may be skipped when multiple images accomplish upload process at the same time

---

特性

• 05c6215 List: extra 部分增加了 max-width 限制，避免文字过长时溢出容器 & 增加了 --extra-max-width 用来自由设置上述的 max-width
• 6b4b6a4 Checkbox: 增加了 ref，支持 check uncheck toggle 方法
• 87533ec TextArea: ref 中支持了 nativeElement (#5307)
• 2ebede5 Badge: 增加了 wrapperClassName 和 wrapperStyle 属性 (#5302)

优化

• 22b03da Star: 调整了默认的星形图标
• 6412725 InfiniteScroll: 增加了限流逻辑，避免出现性能影响
• 2262837 Icon: 升级 antd-mobile-icons 到 0.3.0 版本，现在的 svg 元素上不会出现无意义的 title 了
• 2feb9c4 Toast: 重构了 Toast.show 的实现 (#5296)
• c3bc2b6 Badge: 外层容器的 className 从 adm-badge-wrap 调整为了 adm-badge-wrapper

修复

• 7686a15 SafeArea: 修复了在一些高清模式的项目中，SafeArea 可能高度过高的问题，并且新增了 --multiple 和 --adm-safe-area-multiple CSS 变量用于手动设置放大倍数
• 12328b2 Form: 修复了可能会意外渲染一个 description 节点的问题 (#5320)
• 53f36ec List: 回退了 #5277 的改动，避免 extra 部分出现意外的折行
• 434b980 InfiniteScroll: 修复了在 React 18 的应用中，InfiniteScroll 在部分失败状态下可能进入死循环的问题
• b841bde ImageUploader: 修复了在 React 18 的应用中，同时上传多张图片可能会导致部分上传任务无法正确的触发完成的问题