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
属性,配置水印层级