Zarm v3 开发计划

[JeromeLin]

Discussed in #662

v3 版本分支：feature

^{Originally posted by JeromeLin June 21, 2021}

全面重构函数组件

重构为函数组件，完善组件 ref 定义，完善组件 ts 类型定义

• ActionSheet @dominicleo
• ActivityIndicator @mrdulin
• Affix @faner11
• Badge @tgioer
• Button @JeromeLin
• Cell @BestDingSheng
• Carousel @faner11
• Checkbox @faner11
• Collapse @BestDingSheng
• ConfigProvider @JeromeLin
• FilePicker @Yang03
• Input @JeromeLin
• ImagePreview @Yang03
• Keyboard、KeyBoardPicker @JeromeLin
• Loading @faner11
• Mask @JeromeLin
• Marquee @nagq
• Message @jiyingzhi
• Modal、Modal.Alert、Modal.confirm @dominicleo
• NavBar @jiyingzhi
• NoticeBar @faner11
• Panel @BestDingSheng
• Popup @JeromeLin
• Progress @mrdulin
• PinchZoom @Yang03
• Radio @JunIce
• Switch @JeromeLin
• Stepper @JunIce
• SearchBar @nemoisme
• Select @Yang03
• Slider @Yang03
• TabBar @Yang03
• Tabs @JeromeLin
• Toast @faner11
• Tooltip @stbui
• Wheel @edison-hm
• BackToTop @dominicleo
• Calendar @Yang03
• Trigger @LentoYe
• SwipeAction @zhangjizhe
• DatePicker @Yang03
• DatePickerView @Yang03
• DateSelect @Yang03
• Popper @Yang03
• Popup @dominicleo
• Picker @dominicleo
• PickerView @dominicleo
• Pull @kokoFE
• StackPicker => Cascader @loststars20160827

新增组件

新增常用组件，及一些 hooks 用法的组件

• 新增图片组件 Image #700 @Justinnng
• 新增栅格组件 Grid #691 @dominicleo
• 新增 Rate 评分组件 feat: 新增评分组件 #799 @dominicleo
• 新增 Skeleton 骨架屏组件 Feature skeleton #933
• 新增 WaterMark 水印组件 feat: 新增水印组件 #796 @dominicleo
• 增加支持部分 hooks 组件
  • useLongPress 长按 refactor: refactor mask, popup, keyboard, keyboard-picker, input, custom-input by functional component #657
  • ClickOutside => useClickAway 单击外部跟踪器 refactor: refactor mask, popup, keyboard, keyboard-picker, input, custom-input by functional component #657
  • Scroller => useThrottleScroll 滚动 Feature(useScroll): add useScroll hook #867
  • Drag => useDrag 拖拽 feat: add useDrag #667
  • useOrientation 屏幕方向 feat: useOrientation #727
  • useLockScroll 锁定背景滚动 feat: 锁定背景滚动 #802

组件迭代

组件 API 调整，功能增强

• ConfigProvider 全局配置
  • 组件样式设置作用域修正为当前节点下（非全局）
  • 增加适配 iphoneX 安全区域
  • 增加组件 css 变量设置
  • 增加组件挂载节点的 mountContainer
  • 增加组件类名前缀 prefixCls 设置
• Input 文本输入框
  • 拆分使用到虚拟键盘的自定义输入框组件 CustomInput
  • 触发的事件入参由 value 值改为 event，受影响的事件有 onChange onFocus onBlur onFocus
  • 删除 onClear 事件，点击重置按钮请空值将触发 onChange 事件
  • 抽离自定义输入框 CustomInput, 配合 KeyBoard 扩展自定义输入框
  • 增加属性 label，用于设置标签栏
• Cell 列表
  • 变更为 List 和 List.Item 组件，样式结构调整
  • 属性 icon 变更为 prefix
  • 属性 description 变更为 after
  • 属性 help 变更为 info
  • 属性 title 字体大小变更为 17px
• Checkbox 多选框
  • Group
    • 属性 type 可选值 cell 变更为 list
    • 属性 size 变更为 buttonSize
    • 属性 shape 变更为 buttonShape
    • 属性 ghost 变更为 buttonGhost
    • 新增属性 listMarkerAlign ，用于设置列表类型时标记的位置
• Radio 单选框
  • Group
    • 属性 type 可选值 cell 变更为 list
    • 属性 size 变更为 buttonSize
    • 属性 shape 变更为 buttonShape
    • 属性 ghost 变更为 buttonGhost
    • 属性 compact 变更为 buttonCompact
    • 新增属性 listMarkerAlign ，用于设置列表类型时标记的位置
• Select 选择器 和 DateSelect 日期选择器
  • 移除属性 hasArrow，默认展示箭头
• NoticeBar 公告栏
  • 新增属性 onClose，关闭触发的回调函数
  • 修复关闭后只移除了 Message 组件，根节点没有被移除的 bug
• Message 消息
  • 移除属性 size，及相关样式
  • 新增属性 onClose，关闭触发的回调函数
• ImagePreview 图片预览
  • 支持横屏下查看图片
• Modal 模态框
  • 支持开启状态下锁定背景滚动
• Badge 徽标
  • 移除属性 theme，颜色设置通过 css 变量 --background 来定义
  • 新增属性 bordered ，用于判断徽标是否有边框
• SearchBar 搜索栏
  • 输入框事件变更为与原生 input 保持一致，如 onChange、onFocus、onBlur 等
  • 删除 onClear 事件，点击重置按钮请空值将触发 onChange 事件
• Slider 滑动输入条
  • 支持点击，移动到点击位置
  • 新增属性 onSlideChange ，滑动时触发
• Toast 轻提示
  • 静态方法挂载到 Toast.useToast 下，详细用法参考官网例子
• BackTop 返回顶部
  • BackToTop 组件更名为 BackTop
  • 新增属性 mountContainer ，用于设置组件挂载节点
• Badge 徽标
  • 移除属性 theme，颜色设置通过 css 变量 --background 来定义
  • 新增属性 bordered ，用于判断徽标是否有边框
• Mask 遮罩层
  • 移除属性 type
  • 新增属性 color 用户设置颜色
  • 新增属性 opacity 用于设置透明度
• DatePicker 日期选择器
  • 新增属性 columnType 用于模式设置

其他

• 移除单个组件的 prefixCls 设置，改为在 ConfigProvider 中使用全局设置 prefixCls #708
• 完善组件 css 变量定义
  • 增加变量前缀，如：--za-xxx
• StrictMode 支持
  • Popper findDOMNode warning
• 完全兼容 SSR 场景
• 拥抱 React v18

[JeromeLin]

Popup/ActionSheet/NavBar 等组件增加安全区域选项

增加适配 iphoneX 安全区域 这条就是

[zjfjiayou]

会不会长期支持呢，ant mobile已经很久没更新了

[JeromeLin]

会不会长期支持呢，ant mobile已经很久没更新了

长期，我们这个项目历经5年了。

[zjfjiayou]

会不会长期支持呢，ant mobile已经很久没更新了

长期，我们这个项目历经5年了。

赞一个先

[jiyingzhi]

可以拆分成更新的任务，方便大家认领！

[JeromeLin]

@jiyingzhi 已拆分出任务，https://github.com/ZhongAnTech/zarm/projects

[skywalk94]

文档更新日志麻烦加上时间

[JeromeLin]

文档更新日志麻烦加上时间

文档会区分版本

[zqq980214]

可以考虑添加一个 骨架屏的组件嘛

[JeromeLin]

@zqq980214 市面上一些骨架屏的实现效果感觉都不是太好，想设计一个好用点的骨架屏。暂时还没完全想好，看情况是否先做一个简单版本。

[ly4work]

不知道有没有计划开发Form组件呢？ant-mobile的最新大版本体验版已经在试验开源了哦，加油Zarm!

[JeromeLin]

不知道有没有计划开发Form组件呢？ant-mobile的最新大版本体验版已经在试验开源了哦，加油Zarm!

暂无Form开发计划，可以结合第三方使用

[wr404274848]

Table组件有计划吗，能异步设置DataSource的

[long5635152]

DatePicker组件建议新增日期范围选择,可以选择一个时间点到另一个时间点,

[samsonCao]

什么时候发布稳定版本呢，急需 打开弹框类组件背景无法滚动的功能。现在只能先自己实现一下，包装一层Modal。

[wr404274848]

移动端什么业务需要用到弹框呢，启动广告？

[JeromeLin]

DatePicker组件建议新增日期范围选择,可以选择一个

日期范围选择可以使用 Calendar 日历组件，或者自行组装

[JeromeLin]

Table组件有计划吗，能异步设置DataSource的

移动端使用Table比较少，v3版本暂无此计划

[JeromeLin]

什么时候发布稳定版本呢，急需 打开弹框类组件背景无法滚动的功能。现在只能先自己实现一下，包装一层Modal。

v3 还有部分功能未完成，敬请期待～

[dongliang1993]

有什么需要社区帮忙开发的吗

[JeromeLin]

有什么需要社区帮忙开发的吗

@dongliang1993 重构部分已基本完成，有一些新增组件可以做进来，比如 #986 和 #813，欢迎认领提交 PR

[qiaogaolong]

@JeromeLin 还有多久V3版本才能开放出来呀

[Me-UserName]

@JeromeLin 还有多久V3版本才能开放出来呀

[nbutmickey]

V2版本的Popup组件在StrictMode情况下，无法弹出怎么解决

[JeromeLin]

V2版本的Popup组件在StrictMode情况下，无法弹出怎么解决

升级v3或者去掉StrictMode

[nbutmickey]

我看应该是只有dev环境下有这个问题，请问在V2版本下有解决思路吗，看样子是mountd钩子执行了两次导致的