TreePicker 树形选择器

<TreePicker> 选择器组件,树形单项选择器。

获取组件

import { TreePicker } from 'rsuite';

演示

默认

外观

尺寸

位置

禁用

禁用搜索框

自定义选项

异步

自定义页脚

虚拟列表

Props

<TreePicker>

属性名称 类型 (默认值) 描述
appearance enum: 'default', 'subtle' ('default') 设置外观
block boolean 堵塞整行
childrenKey string ('children') tree 数据结构 children 属性名称
classPrefix string('picker') 组件 CSS 类的前缀
cleanable boolean (true) 是否可以清除
container HTMLElement or (() => HTMLElement) 设置渲染的容器
data * Array<DataItemType> tree 数据
defaultExpandAll boolean 默认展开所有节点
defaultExpandItemValues any [] 设置默认展开节点的值
defaultOpen boolean 默认打开
defaultValue string 默认选中的值
disabled boolean 是否禁用 Picker
disabledItemValues string[] 禁用选项
expandItemValues any [] 设置展开节点的值(受控)
height number (360px) menu 的高度。当设置了 virtualized 为 true 时, 可以通过 height 控制 menu 的高度
inline boolean 是否内联显示 tree
labelKey string ('label') tree 数据结构 label 属性名称
locale object 本地语言
menuClassName string 应用于菜单 DOM 节点的 css class
menuStyle React.CSSProperties 应用于菜单 DOM 节点的 style
onChange (value:string) => void 数据改变的回调函数
onClean (event:SyntheticEvent) => void 值清理时触发回调
onClose () => void 关闭 Dropdown 的回调函数
onExpand (expandItemValues: any [], activeNode:DataItemType, concat:(data, children) => Array) => void 树节点展示时的回调
onEnter () => void 显示前动画过渡的回调函数
onEntered () => void 显示后动画过渡的回调函数
onEntering () => void 显示中动画过渡的回调函数
onExit () => void 退出前动画过渡的回调函数
onExited () => void 退出后动画过渡的回调函数
onExiting () => void 退出中动画过渡的回调函数
onOpen () => void 展开 Dropdown 的回调函数
onSearch (searchKeyword:string, event) => void 搜索回调函数
onSelect (activeNode:DataItemType, value:any, event) => void 选择树节点后的回调函数
open boolean 打开(受控)
placeholder React.Node ('Select') 占位符
placement enum: Placement('bottomStart') 打开位置
renderExtraFooter () => React.Node 自定义页脚内容
renderTreeIcon (nodeData:DataItemType) => React.Node 自定义渲染 图标
renderTreeNode (nodeData:DataItemType) => React.Node 自定义渲染 tree 节点
renderValue (value:string,item:DataItemType, selectedElement:React.Node) => React.Node 自定义渲染选中的值
searchBy (keyword: string, label: React.ReactNode, item: ItemDataType) => boolean 自定义搜索规则
searchable boolean (true) 是否可以搜索
size enum: 'lg', 'md', 'sm', 'xs' ('md') 设置组件尺寸
toggleComponentClass React.ElementType ('a') 为组件自定义元素类型
value string 当前选中的值
valueKey string ('value') tree 数据结构 value 属性名称
virtualized boolean (false) 是否开启虚拟列表

相关组件

  • <CheckTreePicker> 选择器组件,在 TreePicker 节点上支持 Checkbox,用于多选 。
  • <Tree> 用于展示一个树结构数据。
  • <CheckTree> 用于展示一个树结构数据,同时支持 Checkbox 选择。
🎉 v5 版本已经发布! 前往 v5 文档开始使用.