基于Antd库实现可编辑树组件
I 前言
Antd是基于Ant Design设计体系的React UI组件库,主要用于研发企业级中后端产品,在前台很多项目中都有使用。除了提供少量比较基础的例如Button、Form、Input、Modal、List…组件,还有Tree、Upload、Table这几个功能集成度比较高的复杂组件,其中Tree组件的应用场景挺多的,在少量涉及显示树形结构数据的功能中可以表现:目录结构展现、族谱关系图…,总之在需要呈现多个父子层级之间结构关系的场景中即可能用到这种Tree组件,Antd尽管官方提供了Tree组件但是它的功能比较有限,定位是主要负责对数据的展现工作,树数据的增删查改这些功能基本没有支持,但是Antd Tree的属性支持比较完善,我们可以基于Antd树来实现支持编辑功能的EditableTree组件。
源码:nojsja/EditableTree
已经发布为npm组件,可以直接安装:
$: npm install editable-tree-antd# or$: yarn add editable-tree-antd预览
EditableTree_zh_CN.png
II 功能分析
- 非叶子节点的节点名不为空,节点值为空或者数组
- 叶子节点的节点名可为空,节点值不可为空
- 点击树节点进入节点编辑状态,提交后实现节点数据升级
- 非叶子节点每一层级都支持兄弟节点增加、子节点增加、当前节点删除以及节点名、节点值编辑
- 叶子节点只支持当前节点删除和当前节点的节点名、节点值编辑
- 树的每一层级的节点名和节点值能否可以编辑、节点能否可以删除均可以通过传入的节点数据属性控制,默认情况下所有节点可编辑、可删除
- 树的层级深度支持属性配置,子节点深度不能超过树的最大深度值,默认为50层子级
- 新添加支持:将一段yaml字符串解析为多个树节点
III 实现解析
基于React / Antd / Mobx
Antd Tree文档
文件结构
— index.js — 入口文件,数据初始化、组件生命周期控制、递归调用TreeNode进行数据渲染
— Tree.js — Tree类用于笼统化树形数据的增删查改操作,相当于Model层
— lang.js — 多语言文件
— TreeNode.jsx — 单层树节点组件,用于隔离每层节点状态显示和操作
——- TreeNodeDisplay.jsx — 非编辑状态下树数据的展现
——- TreeNodeNormalEditing.jsx — 普通节点处于编辑状态下时
——- TreeNodeYamlEditing.jsx — yaml节点处于编辑状态下时
——- TreeNodeActions.jsx — 该层级树节点的所有功能按钮组
— styles / editable-tree.css — 树样式
— styles / icon-font / * — 图标依赖的iconfont文件
实现原理
- 先来看下Antd原生需要
Tree数据格式:
[ { title: 'parent 1', key: '0-0', children: [ { title: 'parent 1-0', key: '0-0-0', disabled: true, children: [ { title: 'leaf', key: '0-0-0-0', disableCheckbox: true, }, { title: 'leaf', key: '0-0-0-1', } ] }, { title: 'parent 1-1', key: '0-0-1', children: [{ title: <span style={{ color: '#1890ff' }}>sss</span>, key: '0-0-1-0' }] } ] }]每一层级节点除了需要基本的
title(文字label)、key(节点唯一标识)、children(子结点列表)属性外,还有其它很多自己设置参数比方配置节点能否选中等等,这里就不对其它功能配置项做细研究了,感兴趣可以查看官方文档。在官方说明中
title值其实不只是一个字符串,还可以是一个ReactNode,也就是说Antd官方为我们提供了一个树改造的后门,我们可以用自己的渲染逻辑来替换官方的title渲染逻辑,所以关键点就是分离这个title渲染为一个独立的React组件,在这个组件里我们独立管理每一层级的树节点数据展现,同时又向这个组件暴露操作整个树形数据的方法。另一方面Tree型数据一般都需要使用递归逻辑来进行节点渲染和数据增删查改,这里TreeNode.js就是递归渲染的Component对象,而增删查改逻辑我们把它分离到Tree.jsModel里面进行管理,这样子思路就比较清晰了。
关键点说明:index.js
入口文件,用于:数据初始化、组件生命周期控制、递归调用
TreeNode进行数据渲染、加载lang文件等等
在生命周期
componentDidMount中我们初始化一个Tree Model,并设置初始化state数据。在
componentWillReceiveProps中我们升级这个Model和state以控制界面状态升级,注意使用的Js数据深比较函数deepComparison用来避免不必要的数据渲染,数据深比较时要使用与树显示相关的节点属性裸数据(见方法getNudeTreeData),比方nodeName,nodeValue等属性,其它的无关属性比方id和depth需要忽略。formatNodeData主要功能是将我们传入的自己设置树数据递归 “翻译” 成Antd Tree渲染需要的原生树数据。
[ { nodeName: '出版者', id: '出版者', // unique id, required nameEditable: true, // is level editable (name), default true valueEditable: true, // is level editable (value), default true nodeDeletable: false, // is level deletable, default true nodeValue: [ { nodeName: '出版者形容', isInEdit: true, // is level in edit status id: '出版者形容', nodeValue: [ { nodeName: '出版者名称', id: '出版者名称', nodeValue: '出版者A', }, { nodeName: '出版者地', id: '出版者地', valueEditable: false, nodeValue: '出版地B1', }, ], } ], }, ...];- 代码逻辑:
...class EditableTree extends Component { state = { treeData: [], // Antd Tree 需要的结构化数据 expandedKeys: [], // 将树的节点开展/折叠状态归入控制 maxLevel: 50, ;// 默认最大树深度 enableYaml: false, lang: 'zh_CN' }; dataOrigin = [] treeModel = null key=getRandomString() /* 组件挂载后初始化树数据,生成treeModel,升级state */ componentDidMount() { const { data, maxLevel = 50, enableYaml, lang="zh_CN" } = this.props; if (data) { this.dataOrigin = data; TreeClass.defaultTreeValueWrapper(this.dataOrigin); // 树节点增加默认值 TreeClass.levelDepthWrapper(this.dataOrigin); // 增加层级深度属性 const formattedData = this.formatTreeData(this.dataOrigin); // 生成格式化后的Antd Tree数据 this.updateTreeModel({ data: this.dataOrigin, key: this.key }); // 升级model const keys = TreeClass.getTreeKeys(this.dataOrigin); // 获取各个层级的key,默认开展所有层级 this.setState({ treeData: formattedData, expandedKeys: keys, enableYaml: !!enableYaml, maxLevel, lang, }); } } /* 组件props数据升级后升级treeModel和state */ componentWillReceiveProps(nextProps) { const { data, maxLevel = 50, enableYaml, lang="zh_CN" } = nextProps; this.setState({ enableYaml: !!enableYaml, lang, maxLevel }); // 深比较函数避免不必要的树升级 if ( !deepComparison( TreeClass.getNudeTreeData(deepClone(this.dataOrigin)), TreeClass.getNudeTreeData(deepClone(data)) ) ) { this.dataOrigin = data; TreeClass.defaultTreeValueWrapper(this.dataOrigin); TreeClass.levelDepthWrapper(this.dataOrigin); const formattedData = this.formatTreeData(this.dataOrigin); this.updateTreeModel({ data: this.dataOrigin, key: this.key }); const keys = TreeClass.getTreeKeys(this.dataOrigin); this.onDataChange(this.dataOrigin); // 触发onChange回调钩子 this.setState({ treeData: formattedData, expandedKeys: keys }); } } /* 修改节点 */ modifyNode = (key, treeNode) => { const modifiedData = this.treeModel.modifyNode(key, treeNode); // 升级model this.setState({ treeData: this.formatTreeData(modifiedData), // 升级state,触发数据回调钩子 }, () => this.onDataChange(this.dataOrigin)); } /** * 以下省略的方法具备跟modifyNode类似的逻辑 * 调用treeModel修改数据而后升级state **/ /* 进入编辑模式 */ getInToEditable = (key, treeNode) => { ... } /* 增加一个兄弟节点 */ addSisterNode = (key) => { ... } /* 增加一个子结点 */ addSubNode = (key) => { ... } /* 移除一个节点 */ removeNode = (key) => { ... } /* 递归生成树节点数据 */ formatNodeData = (treeData) => { let tree = {}; const key = `${this.key}_${treeData.id}`; if (treeData.toString() === '[object Object]' && tree !== null) { tree.key = key; treeData.key = key; tree.title = /* 关键点 */ (<TreeNode maxLevel={this.maxLevel} focusKey={this.state.focusKey} treeData={treeData} enableYaml={this.state.enableYaml} modifyNode={this.modifyNode} addSisterNode={this.addSisterNode} addExpandedKey={this.addExpandedKey} getInToEditable={this.getInToEditable} addSubNode={this.addSubNode} addNodeFragment={this.addNodeFragment} removeNode={this.removeNode} lang={lang(this.state.lang)} />); if (treeData.nodeValue instanceof Array) tree.children = treeData.nodeValue.map(d => this.formatNodeData(d)); } else { tree = ''; } return tree; } /* 生成树数据 */ formatTreeData = (treeData) => { let tree = []; if (treeData instanceof Array) tree = treeData.map(treeNode => this.formatNodeData(treeNode)); return tree; } /* 升级 tree model */ updateTreeModel = (props) => { if (this.treeModel) { this.treeModel.update(props); } else { const _lang = lang(this.state.lang); this.treeModel = new TreeClass( props.data, props.key, { maxLevel: this.state.maxLevel, overLevelTips: _lang.template_tree_max_level_tips, completeEditingNodeTips: _lang.pleaseCompleteTheNodeBeingEdited, addSameLevelTips: _lang.extendedMetadata_same_level_name_cannot_be_added, } ); } } /* 树数据升级钩子,提供给上一层级调用 */ onDataChange = (modifiedData) => { const { onDataChange = () => {} } = this.props; onDataChange(modifiedData); } ... render() { const { treeData } = this.state; return ( <div className="editable-tree-wrapper"> { (treeData && treeData.length) ? <Tree showLine onExpand={this.onExpand} expandedKeys={this.state.expandedKeys} // defaultExpandedKeys={this.state.expandedKeys} defaultExpandAll treeData={treeData} /> : null } </div> ); }}EditableTree.propTypes = { data: PropTypes.array.isRequired, // tree data, required onDataChange: PropTypes.func, // data change callback, default none maxLevel: PropTypes.number, // tree max level, default 50 lang: PropTypes.string, // lang - zh_CN/en_US, default zh_CN enableYaml: PropTypes.bool // enable it if you want to parse yaml string when adding a new node, default false};关键点说明:Tree.js
Tree类用于笼统化树形数据的增删查改操作,相当于
Model层
逻辑不算复杂,很多都是递归树数据修改节点,具体代码不予赘述:
export default class Tree { constructor(data, treeKey, { maxLevel, overLevelTips = '已经限制模板树的最大深度为:', addSameLevelTips = '同层级已经有同名节点被增加!', completeEditingNodeTips = '请完善当前正在编辑的节点数据!', }) { this.treeData = data; this.treeKey = treeKey; this.maxLevel = maxLevel; this.overLevelTips = overLevelTips; this.completeEditingNodeTips = completeEditingNodeTips; this.addSameLevelTips = addSameLevelTips; } ... /* 为输入数据覆盖默认值 */ static defaultTreeValueWrapper() { ... } /* 查询能否有节点正在编辑 */ static findInEdit(items) { ... } /* 进入编辑模式 */ getInToEditable(key, { nodeName, nodeValue, id, isInEdit } = {}) { ... } /* 修改一个节点数据 */ modifyNode(key, { nodeName = '', nodeValue = '', nameEditable = true, valueEditable = true, nodeDeletable = true, isInEdit = false, } = {}) { ... } /* 增加一个目标节点的兄弟结点 */ addSisterNode(key, { nodeName = '', nameEditable = true, valueEditable = true, nodeDeletable = true, isInEdit = true, nodeValue = '', } = {}) { ... } /* 增加一个目标节点的子结点 */ addSubNode(key, { nodeName = '', nameEditable = true, valueEditable = true, nodeDeletable = true, isInEdit = true, nodeValue = '', } = {}) { ... } /* 移除节点 */ removeNode(key) { ... } /* 获取树数据 */ getTreeData() { return deepClone(this.treeData); } /* 升级树数据 */ update({ data, key }) { this.treeData = data; this.treeKey = key; }}关键点说明:TreeNode.jsx
表示单个树节点的React组件,以下均为其子组件,用于展现各个状态下的树层级
TreeNodeDisplay.jsx — 非编辑状态下树数据的展现
TreeNodeNormalEditing.jsx — 普通节点处于编辑状态下时
TreeNodeYamlEditing.jsx — yaml节点处于编辑状态下时
TreeNodeActions.jsx — 该层级树节点的所有功能按钮组
每个层级节点都可以增加子节点、增加同级节点、编辑节点名、编辑节点值、删除当前节点(一并删除子节点),nameEditable属性控制节点名能否可编辑,valueEditable树形控制节点值能否可编辑,nodeDeletable属性控制节点能否可以删除,默认值都是为true。
tree_add_sister.png
tree_add_sub.png
isInEdit属性表明当前节点能否处于编辑状态,处于编辑状态时显示输入框,否则显示文字,当点击文字时当前节点变成编辑状态。
tree_in_edit.png
简单的页面展现组件,具体实现见 源码:TreeNode.jsx
IV 遇到的问题&处理办法
树数据升级渲染导致的节点折叠状态重置
想象我们打开了树的中间某个层级进行节点名编辑,编辑完成后点击提交,树重新渲染刷新,而后之前编辑的节点又重新折叠起来了,我们需要重新打开那个层级看能否编辑成功,这种使用体验无疑是痛苦的。
造成树节点折叠状态重置的起因就是树的重新渲染,且这个折叠状态的控制数据并没有暴露到每个TreeNode上,所以在我们自己实现的TreeNode中无法独立控制树节点的折叠/开展。
查看官方文档,传入树的
expandedKeys属性可以显式指定整颗树中需要开展的节点,expandedKeys即需要开展节点的key值数组,为了将每个树节点折叠状态变成受控状态,我们将expandedKeys存在state或者mobx store中,并在树节点折叠状态改变后升级这个值。
...render() { const { treeData } = this.state; return ( <div className="editable-tree-wrapper"> { (treeData && treeData.length) ? <Tree showLine onExpand={this.onExpand} expandedKeys={this.state.expandedKeys} treeData={treeData} /> : null } </div> ); }Antd格子布局塌陷
在
TreeNode.jsx组件中有一个比较严重的问题,如上文提到的EditableTree的某一层级处于编辑状态时,该层级中的文字展现组件<span>会变成输入组件<input>,我发现在编辑模式下Antd的Row/Col格子布局正常工作,在非编辑模式下因为节点内容从块元素input变成了内联元素span,格子布局塌陷了,这种情况下即便公告了Col占用的格子数量,内容仍旧使用最小宽度展现,即文字占用的宽度。推测起因是Antd的
Row/Col格子布局自身的问题,没有深究,这边只是将<span>元素换成了<div>元素,并且在样式中公告div占用的最小宽度min-width,同时设置max-width和overflow避免文字元素超出边界。
tree_in_edit.png
V 结语
其实Tree组件已经不止写过一次了,之前基于Semantic UI写过一次,不过由于Semantic UI没有Tree的基础实现,所以基本上是完全自己重写的,基本思路其实跟这篇文章写的大致相同,也是递归升级渲染节点,将各个节点的折叠状态放入state进行受控管理,不过这次实现的EditableTree最主要一点是分离了treeModel的数据管理逻辑,让界面操作层TreeNode.jsx、数据管理层Tree.js和控制层index.jsx完全分离开来,结构明了,后期即便想扩展功能也未尝不可。又是跟Antd斗智斗勇的一次(苦笑脸)…
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » 基于Antd库实现可编辑树组件