4.0.0

4.0.0

• 新增 CheckCasacader 多项级联选择器组件
• 新增 ZenMode 禅模式组件
• 新增 PopConfirm 气泡确认框组件
• 新增 Avatar 头像组件
• 新增 Space 间距器组件
• 新增 Descriptions 描述列表组件
• 新增 Result 结果组件
• 新增 EmptyState 空状态组件
• 新增 Highlighter 文本高亮组件
• 新增 SvgIcon SVG容器组件
• 新增 Textarea 多行文本输入框组件
• 新增 CheckTreeSelect 多项树形选择器组件
• 新增 CheckSelect 多项选择器组件

Checkbox

• 新增 name 支持自定义 <input type="checkbox" \/> 的名称，用于 Form 提交
• 新增 value 支持绑定表单控件值， 用于 Form 提交
• CheckboxGroup 新增 children 支持自定义渲染 Checkbox

Counter

• 新增 autoFocus 支持开启自动聚焦
• 新增 changeOnWheel 支持开启滑轮改值
• 新增 invalid 支持开启无效态

DatePicker

• 新增 invalid 支持开启无效态
• 新增 overlay 自定义控制弹出层
• 新增 size 自定义大小
• 新增 appearance 自定义不同 UI 外观

Form

• 新增 initialErrors 支持初始化表单控件的异常错误
• 新增 initialTouched 支持初始化表单控件是否已产生交互并失焦动作
• 新增 validateTrigger设置统一的表单校验时机
• 新增 validateAfterTouched 控制初次交互时不进行校验
• 新增 lazyValidate 开启惰性校验，遇到移除不再进行后续的校验
• 新增 onSubmit 提交时回调
• 新增 onReset 重置时回调
• 优化 ref 指向更改为 innerRef，原 ref 更正为 dom 引用获取，innerRef 校验等回调方法写法支持 Promise
• 优化 Form.Item 下的 required 只做展示，不做校验，校验使用 rules 指定
• 新增 Form.Item 下的 valueType 支持指定控件值数据结构类型
• 新增 Form.Item 下的 valueChangeFuncPropName 支持自定义设置 Form 从表单控件采集数据回调的属性
• 新增 Form.Item 下的 valueDispatchTransform 支持自定义 Form 从控件个体采集数据的转换器，最终会把返回值转发给 Form
• 新增 Form.Item 下的 valueConnectTransform 支持自定义控件个体接收 Form 下发数据的转换器，最终会把返回值转发给 FormField
• 新增 Form.Item 下的 validateTrigger 支持设置触发该字段校验的时机（值必须是回调函数），会覆盖 Form 设置的 validateTrigger
• 新增 Form.Item 下的 render 支持表单控件 render 渲染
• 优化 Form.List 下的 children 渲染函数支持多种快捷操作方法 swap, insertBefore, move

Input

• 优化 bordered 字段 bordered => appearance，统一使用 appearance 设置外形（线\面\无边框）值
• 新增 prepend 支持 Input 前置外置元素组合
• 新增 append 支持 Input 后置外置元素组合
• 新增 prefix 支持 Input 前置内置元素
• 新增 suffix 化支持 Input 前置内置元素
• 新增 readOnly 支持 Input 功能
• 新增 autoFocus 支持 Input 功能
• 新增 maxLength 支持 Input 功能
• 新增 trimValueOnBlur 支持 Input 功能
• 新增 clearableTrigger 支持 Input 清空内容功能
• 新增 size 支持不同尺寸

Rating

• 新增 autoFocus 支持自定聚焦
• 变更 组件名 Rate -> Rating，符合专业认知
• 变更 字段：vertical -> halfPlacement
• 优化 快捷键，支持左右键最大最小值无缝切换

Search

• 新增 defaultValue 支持输入框值非受控
• 新增 value 支持输入框值受控
• 变更 onChange 更改参数定义 (event: HTMLInputEvent) => void -> (inputVal: ReactText) => void
• 变更 onSearch 更改参数定义 (inputVal: string, item ?:DataItem) => void -> (inputVal: ReactText) => void

Slider

• 新增 color 自定义颜色能力
• 变更 字段：vertical -> halfPlacement
• 废弃 type，可使用 color 替代

Radio

• 新增 readOnly 支持只读状态
• 优化 content 类型支持 ReactNode
• 新增 RadioGroup 下的 children，支持内嵌 Radio，实现灵活的布局

Select

• 新增 overlay 控制弹出层的行为
• 新增 searchPlaceholder 支持搜索占位符配置
• 新增 loadingContent 支持自定义加载中文案
• 新增 virtual 支持虚拟列表
• 新增 height 支持虚拟列表
• 新增 itemHeight 支持虚拟列表
• 新增 displayRender 统一支持选择后内容自定义渲染
• 优化 value 类型 string[] -> string \| number
• 优化 defaultValue 类型 string[] -> string \| number
• 优化 onChange 类型定义
• 变更 字段 bordered => appearance，支持设置外形（线\面\无边框）值
• 废弃 setOverlayContainer，建议使用 popper.container 替代
• 废弃 autoload 用户自行控制页面级首次渲染数据加载
• 废弃 type 拆分为单选多选组件单独维护

TimePicker

• 新增 defaultValue 表示非受控初始化值
• 新增 itemHeight 设置选择器高
• 新增 disabledHours、disabledMinutes、disabledSeconds 追加 panel 参数，示当前计算的是开始还是结束
• 变更 value 类型定义为 string[]
• 变更 placeholder 类型变更为 string[]
• 变更 onChange 参数类型变更为 string[]

Transfer

• 新增 placeholder 支持自定义搜索输入框占位内容
• 新增 DataItem.title 类型支持 ReactNode
• 新增 defaultTargetIds 支持非受控设置穿梭目标 ids 列表
• 新增 pagination 支持大数据分页支持
• 新增 onDrop 新增第三个参数，表示操作前后的 ids 顺序列表

TreeSelect

• 新增 overlay 控制弹出层的行为
• 新增 searchPlaceholder 支持搜索占位符配置
• 新增 loadingContent 支持自定义加载中文案
• 新增 virtual 支持虚拟列表
• 新增 height 支持虚拟列表
• 新增 itemHeight 支持虚拟列表
• 新增 displayRender 统一支持选择后内容自定义渲染
• 新增 render 支持自定义渲染每一项
• 变更 value 类型 string[] \| string -> string \| number
• 变更 defaultValue 类型 string[] \| string -> string \| number
• 变更 bordered 字段 bordered -> appearance，设置外形（线\面\无边框）值
• 变更 expandedIds 字段：expandIds -> expandedIds，统一字段命名及其含义
• 变更 defaultExpandedIds 字段：defaultExpandIds -> defaultExpandedIds
• 变更 onChange 类型参数定义
• 废弃 autoload 用户自行控制页面级首次渲染数据加载
• 废弃 type 拆分为单选多选组件单独维护
• 废弃 mode 建议使用 CheckCascader 组件替代面包屑模式，交互体验更优。

Upload

• 新增 File.abort 中断上传方法
• 新增 File.progressNumber 表示实时上传进度数字

Carousel

• 新增 arrowSize 支持设置箭头指示器尺寸
• 新增 dotType 支持设置分页指示器类型
• 新增 dotPlacement 支持设置分页指示器位置

Card

• 变更 size 功能定义为紧凑或者常规，原功能设置 width 采用 style 即可
• 变更 content 字段名为 children，作为内容渲染
• 新增 loading 增加加载状态
• 新增 cover 支持卡片封面设置 ReactNode
• 废弃 type 不再支持 simple 模式，使用场景过于模糊

Collapse

• 新增支持嵌套 Collapse 使用
• 废弃 extra 建议使用 title 实现其扩展

List

• 变更 action 字段位置变更：ListProps.action -> ListItemProps.action
• 变更 actionPlacement 字段位置变更：ListProps.action -> ListItemProps.action
• 新增 hoverable 鼠标移入时是否显示阴影
• 废弃 titleTag 建议使用 title，结合 Tag 组件进行自定义渲染
• 废弃 titleTagType 建议使用 title，结合 Tag 组件进行自定义渲染
• 废弃 type 字段，基于 item 是否存在 avatar 属性决定是否渲染即可
• 废弃 layout 字段，功能无场景使用，建议外层自定义布局

Popover

• 新增 onOpen 打开时回调 | 增加钩子函数
• 新增 onClose 关闭时回调 | 增加钩子函数
• 变更 overlayClassName 字段为 className

Preview

• 变更 onError 方法入参
• 变更 images 字段名为 src，语义化统一，且支持单个和数组
• 变更 simpleData 字段类型 string[] | object[] -> string[]
• 新增 title 支持图片标题展示
• 新增 current 支持当前预览图片索引(受控)，增加图片索引控制能力
• 新增 defaultCurrent 支持当前预览图片索引非受控

Table

• 变更 fixedToColumn 字段类型为只支持对象设置，支持受控冻结列
• 新增 onLoadChildren 支持返回 undefined 不做任何处理，用于支持自定义控制 data 更新
• 新增 expandedEmbedRowKeys 支持内嵌面板独立控制
• 新增 onEmbedExpand 支持内嵌面板独立控制
• 新增 stickyFooter 支持底部吸底
• 新增 stickyFooterBottom 支持自定义底部吸底距离视口底部距离
• 新增 defaultFixedToColumn 支持非受控冻结列
• 新增 onFixedToColumn 支持冻结列设置回调，配合受控场景使用
• 新增 showRowHighlight 强化控制行 hover 高亮功能
• 新增 sortedColKeys 支持受控列排序
• 新增 onSortedColKeysChange 支持列排序设置回调，配合受控场景使用
• 废弃 column 数据项中 selectFilters 属性，请使用 filterDropdown

Timeline

• 变更 icon 支持 ReactNode 按需引入 Icon，取消 string 模式全量引入

ToolTip

• 变更 overlayClassName 字段名，使用 className 即可
• 变更 placement 字段枚举值，语义化气泡卡片显示的位置
• 新增 onOpen 支持打开时回调
• 新增 onClose 支持关闭时回调
• 新增 arrow 是否显示箭头
• 新增 unmountOnClose 开启关闭时销毁，用于性能优化，优先级大于 preload
• 新增 preload 开启预加载渲染，用于性能优化，优先级小于 unmountOnClose

Tree

• 变更 expandedIcon 字段 openIcon -> expandIcon、类型：string-> React.ReactNode，保证命名语义化
• 变更 collapsedIcon 字段 closeIcon -> collapsedIcon、类型：string-> React.ReactNode 保证命名语义化
• 变更 onBeforeSave 入参，支持节点对象数据状态注入，统一第一个参数为事件对象
• 变更 onSave 入参，支持节点对象数据状态注入，统一第一个参数为事件对象
• 变更 onBeforeDelete 入参，支持节点对象数据状态注入，统一第一个参数为事件对象
• 变更 onDelete 入参，支持节点对象数据状态注入，统一第一个参数为事件对象
• 变更 onExpand 入参，统一第一个参数为 id 数据
• 变更 onLoadChildren 入参，支持节点对象数据状态注入
• 变更 onSelect 入参变更，支持节点反选
• 变更 onCheck 参数变更，统一第一个参数为 id 数据，支持节点对象数据状态注入
• 变更 onDragStart 入参，支持节点对象数据状态注入，统一第一个参数为事件对象
• 变更 onDrop 入参，支持节点对象数据状态注入，统一第一个参数为事件对象
• 变更 onDropEnd 入参，支持节点对象数据状态注入，统一第一个参数为事件对象
• 新增 onDragEnd 拖拽结束时触发
• 新增 onDragLeave 节点 drag leaver 时调用
• 新增 onDragOver 节点 drag over 时调用
• 新增 virtual 支持虚拟列表
• 新增 height 支持虚拟列表
• 新增 itemHeight 支持虚拟列表
• 新增 showLine 支持自定义是否展示连接线
• 新增 leafIcon 支持设置叶子节点 Icon
• 新增 titleRender 支持自定义渲染每一项
• 新增 onContextMenu 支持节点编辑操作交互更新，废弃右键
• 新增 menuOptions 类型和 contextMenu 一致 | 节点编辑操作交互更新，废弃右键
• 新增 editPlaceholder 强化支持编辑输入框自定义 placeholder
• 新增 onSearch 强化支持搜索框 change 时回调
• 优化 checkedIds 类型扩充 string => string \| number
• 优化 defaultCheckedIds 类型扩充 string => string \| number
• 优化 selectedId 类型扩充 string => string \| number
• 优化 defaultSelectedId 类型扩充 string => string \| number
• 优化 expandedIds 类型扩充 string => string \| number
• 优化 defaultExpandedIds 类型扩充 string => string \| number
• 废弃 contextMenu 交互变更，建议使用 onContextMenu 实现或者使用 menuOptions 替代节点编辑交互

Grid

• 新增 gutter 属性，支持配置自定义间距
• 新增 rowGap 属性，支持行间距配置

Button

• 变更 size 由 'large' | 'default' | 'small' 变更为 'lg' | 'sm' | 'md' | 'xl'
• 变更 appearance 由 'link' | 'button' 变更为 'link' | 'line' | 'filled' | 'unset'
• 变更 icon 类型由 string 变更为 React.ReactNode
• 新增 shape 属性，设置按钮的形状

Breadcrumb

• 变更 onClick 属性参数，由 (path: string) => void 变更为 ((evt: MouseEvent<Element, MouseEvent>, item: BreadcrumbDataItem, index: number) => void
• 变更 path 不再为面包屑依赖属性
• 变更 icon 类型由 string 变更为 ReactNode
• 新增 size 属性，设置面包屑尺寸
• 废弃 content，请使用 title

Dropdown

• 新增 overlay 属性自定义控制下拉框行为
• 新增 DropdownDataItem 类型下新增 split 属性，配置底部分割线

Menu

• 变更 菜单项 content 属性，请使用 title 属性
• 新增 defaultActiveId 属性，配置默认激活菜单项
• 新增 expandedType 属性，配置弹出层展开方式
• 新增 defaultExpandedIds 属性，配置默认菜单展开项
• 新增 expandedIds 属性，配置菜单展开项
• 新增 onExpand 属性，用于展开菜单时回调

Pagination

• 新增 showTotal 属性，配置是否展示总条数
• 新增 showPagers 属性，配置是否展示页码
• 废弃 type 属性 'simple' 类型，可以组合使用 type="shrink" 和 showJumper={false} 实现原效果

Stepper

• 变更 current 由从 0 开始变为从 1 开始
• 变更 icon 类型由 string 变更为 ReactNode
• 新增 type 属性，支持配置节点类型

Tabs

• 变更 type 默认类型由 'card' 变为 'line'
• 变更 type 废弃 'editable' 属性，直接使用 editable 属性
• 变更 drag 类事件统一对齐H5原生api
• 新增 TabList 组件，支持单独使用切换头
• 新增 editable 属性，配置是否可编辑
• 变更 onTabClick 属性，定义由 (tabKey, event) => void 变更为 ((tabId: ReactText) => void)
• 废弃 onBeforeDelete 事件
• 废弃 max 属性
• 废弃 canScroll
• 废弃 Tabs. Pane 下的 animation 属性

Alert

• 新增 closeIcon 属性，支持自定义关闭 Icon
• 新增 showIcon 属性，支持配置是否展示 Icon

Drawer

• 更改 onClose 属性，移除无用的 event 入参
• 新增 preload 属性，支持开启预加载渲染
• 新增 unmountOnClose 属性，支持开启关闭时销毁
• 新增 closeOnEsc 属性，支持开启 Esc 快捷键关闭
• 新增 onEscKeyDown 属性，支持 Esc 按键快捷键
• 新增 closeIcon 属性，支持自定义 closeIcon
• 新增 container 属性，支持容器渲染局部弹窗
• 新增 maskClosable 属性，支持开启点击蒙层时关闭控制

Badge

• 新增独立使用场景特性

Loading

• 变更 Loading.open 的参数类型、个数改变
• 新增 delay 属性，支持延迟显示加载效果的时长（可用于防止闪烁）

Message

• 新增 delay 属性，支持延迟显示加载效果的时长（可用于防止闪烁）

Modal

• 变更 size 枚举值规范化
• 新增 closeIcon 属性，支持自定义关闭图标
• 新增 container 属性，支持容器渲染局部抽屉
• 新增 showHeaderDivider 属性，支持控制头部分割线是否展示
• 新增 showFooterDivider 属性，支持控制底部分割线是否展示
• 新增 preload 属性，支持开启预加载渲染
• 新增 unmountOnClose 属性，支持开启关闭时销毁
• 新增 width 属性
• 新增 height 属性
• 新增 autoFocus 属性，支持受控控制是否自动聚焦
• 新增 focusElementOnClose 属性，支持自定义关闭抽屉返回聚焦的元素
• 新增 trapFocus 属性，支持开启跟踪收敛焦点到弹出层
• 新增 returnFocusOnClose 属性，支持开启关闭后焦点返回
• 新增 maskClosable 属性，支持开启点击蒙层时关闭

Notification

• 变更 title 属性， 强化类型 string -> React.ReactNode
• 变更 key 属性 为 id ，统一规范命名
• 新增 timeout 属性，自定义通知自动关闭时长
• 新增 autoClose 属性，自定义是否自动关闭通知
• 新增 action 属性，自定义按钮等操作
• 废弃 onConfirm 属性，可以使用 action 替代
• 废弃 confirmText 属性，可以使用 action 替代

Progress

• 新增 bufferPercent 属性，支持进度条缓冲区百分比值
• 新增 color 属性，支持自定义进度条颜色
• 新增 indeterminate 属性，支持开启进度条加载
• 新增 strokeWidth 属性，支持进度条线性宽度

Tag

• 变更 type 属性，新增 default，变更默认为 default
• 变更 appearance 属性，修改 line 为 solid，适配样式变更
• 变更 color 属性，变更字段含义为：标签文字颜色
• 新增 size 属性，新增不同标签尺寸
• 新增 background 属性，支持设置标签背景色
• 新增 render 属性，支持子代内容渲染
• 新增 closeable 属性，是否展示可关闭按钮
• 新增 editable 属性，支持开启可编辑
• 新增 autoEditable 属性，支持开启挂载时自动开启编辑状态
• 新增 onEdit 属性，支持 tag 修改操作回调
• 新增 onDelete 属性，支持 tag 删除操作回调
• 新增 maxWidth 属性，支持设置最大宽度开启文本超出省略
• 新增 shape 属性，支持多形状
• 变更 Tag.Group 下 data 属性，支持自定义宽
• 新增 Tag.Group 下 maxWidth 属性，提供统一设定方式
• 变更 Tag.Group 下 shape 属性，提供统一设定方式
• 变更 Tag.Group 下 onAdd 属性，变更类型为 (newStringValue: string) => void
• 变更 Tag.Group 下 onEdit 属性，变更类型为 (newStringValue: string, disposeNode: TagGroupDataItem, index: number) => void

Watermark

• 新增 fontSize 属性，支持配置水印文字大小
• 新增 grayscale 属性，开启水印灰度化
• 新增 container 属性，支持配置水印挂载容器
• 新增 textOverflowEffect 属性，配置文本长度超出画布长度时的处理方式
• 新增 color 属性，配置水印文字颜色
• 新增 zIndex 属性，配置水印层级