Skip to content

Latest commit

 

History

History
139 lines (104 loc) · 7.84 KB

README.md

File metadata and controls

139 lines (104 loc) · 7.84 KB

更新日志

  • 更新时间 2023/02/20
    • 结合业务层实现对齐,修复左侧层数不一样的情况无法对齐
  • 更新时间 2023/02/16
    • 新增支持根节点对齐,伸缩不改变根节点位置
  • 更新时间 2022/11/04
    • 修复右子树更新左子树丢失问题:vue-okr-tree@1.0.15
  • 更新时间 2022/11/03
    • 修复左子树更新无效问题:vue-okr-tree@1.0.13
  • 更新时间 2022/09/07
    • 修复安装包内容不一样 对应版本:vue-okr-tree@1.0.12
  • 更新时间 2022/07/25
    • 优化文档 对应版本:vue-okr-tree@1.0.11
  • 更新时间 2020/12/02
    • 修复异步修改data不渲染问题 对应版本:vue-okr-tree@1.0.5
  • 更新时间 2020/12/05
    • 修改部分展示 bug 对应版本:vue-okr-tree@1.0.6
  • 更新时间 2021/01/13
    • 增加 updateKeyChildren 方法:vue-okr-tree@1.0.7
  • 更新时间 2021/02/03
    • 增加 node-btn-content 属性,对展开圆圈内容自定义处理 vue-okr-tree@1.0.8
  • 更新时间 2021/02/04
    • 增加 showNodeNum 属性显示子节点数 vue-okr-tree@1.0.9
  • 更新时间 2021/09/07
    • 修复节点倒叙显示问题 对应版本:vue-okr-tree@1.0.10

文档和事例

地址:http://www.longstudy.club/vue-okr-tree-doc/index.html

vue-okr-tree

基于 Vue 2的组织架构树组件

Install

# use npm
npm i vue-okr-tree

# use yarn
yarn add vue-okr-tree

Quick Start

import {VueOkrTree} from 'vue-okr-tree';
import 'vue-okr-tree/dist/vue-okr-tree.css'

// ...

CDN

# css
<link href="http://qjge81f6q.hd-bkt.clouddn.com/vue-okr-tree.css">

# js
<script src="http://qjge81f6q.hd-bkt.clouddn.com/vue-okr-tree.umd.min.js"></script>

API

Attributes

参数 说明 类型 可选值 默认值
data 展示数据 array
direction 树的展开方向 String horizontal / vertical vertical
onlyBothTree 子树在根节点左右两边展开,该模式只有在 direction 为 horizontal 有效,且必须提供 leftData 数据 Boolean false
leftData 展示左子数的数据,该属性于在 onlyBothTree 模式启用 array
label-width 节点的宽度,默认为自动宽度。如果 label-width 为 number 类型,单位 px;如果 label-width 为 string 类型,则这个宽度会设置为 节点 的 style.width 的值,节点的宽度会受控于外部样式 string/number
label-height 节点的高度,默认为自动高度。如果 label-height 为 number 类型,单位 px;如果 label-height 为 string 类型,则这个高度会设置为 节点 的 style.height 的值,节点的高度会受控于外部样式 string/number
label-class-name 节点 className 的回调方法,也可以使用字符串为所有的节点设置一个固定的 className Function(node)/String
current-lable-class-name 当前选中节点的样式 Function(node)/String
show-collapsable 节点是否可被展开 Boolean false
show-node-num 显示子节点数 Boolean false
default-expand-all 是否默认展开所有节点,该参数只有在 show-collapsable 为 true 时有效 Boolean false
render-content 树节点的内容区的渲染 Function Function(h, node)
node-btn-content 展开的按钮内容渲染 Function Function(h, node)
props 配置选项,具体看下表 object
node-key 每个树节点用来作为唯一标识的属性,整棵树应该是唯一的 String
default-expanded-keys 默认展开的节点的 key 的数组(需要注意的是,此时必须设置node-key,其值为节点数据中的一个字段名,该字段在整棵树中是唯一的。) array
filter-node-method 对树节点进行筛选时执行的方法,返回 true 表示这个节点可以显示,返回 false 则表示这个节点会被隐藏 Function(value, data, node)
aniamte 是否开启节点展开的过渡动画 Boolean false
animate-name 过渡动画名称,支持动画类型有 okr-fade-in-linear/okr-fade-in/okr-zoom-in-center/okr-zoom-in-top/okr-zoom-in-bottom String okr-zoom-in-center

props

参数 说明 类型 可选值 默认值
label 指定节点标签为节点对象的某个属性值 string, function(data, node)
children 指定节点标签为节点对象的某个属性值 string

Events

事件名称 说明 回调参数
node-click 节点被点击时的回调 共三个参数,依次为:传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身。
node-expand 节点被展开时触发的事件 共三个参数,依次为:传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身
node-collapse 节点被关闭时触发的事件 共三个参数,依次为:传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身
node-contextmenu 当某一节点被鼠标右键点击时会触发该事件 共四个参数,依次为:event、传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身。

方法

方法名 说明 回调参数
filter 对树节点进行筛选操作 接收一个任意类型的参数,该参数会在 filter-node-method 中作为第一个参数
updateKeyChildren 通过 keys 设置节点子元素,使用此方法必须设置 node-key 属性 (key, data) 接收两个参数,1. 节点 key 2. 节点数据的数组
getNode 根据 data 或者 key 拿到 Tree 组件中的 node,使用此方法必须设置 node-key 属性 (data) 要获得 node 的 key 或者 data
setCurrentNode 通过 node 设置某个节点的当前选中状态,使用此方法必须设置 node-key 属性 (node) 待被选节点的 node
setCurrentKey 通过 key 设置某个节点的当前选中状态,使用此方法必须设置 node-key 属性 (key) 待被选节点的 key,若为 null 则取消当前高亮的节点
getCurrentKey 获取当前被选中节点的 key,使用此方法必须设置 node-key 属性,若没有节点被选中则返回 null
getCurrentNode 获取当前被选中节点的 data,若没有节点被选中则返回 null
remove 删除 Tree 中的一个节点,使用此方法必须设置 node-key 属性 (data) 要删除的节点的 id 或者 data 或者 node
append 为 Tree 中的一个节点追加一个子节点 (data, parentNode) 接收两个参数,1. 要追加的子节点的 data 2. 子节点的 parent 的 data、key 或者 node
insertBefore 为 Tree 的一个节点的前面增加一个节点 (data, refNode) 接收两个参数,1. 要增加的节点的 data 2. 要增加的节点的后一个节点的 data、key 或者 node
insertAfter 为 Tree 的一个节点的后面增加一个节点 (data, refNode) 接收两个参数,1. 要增加的节点的 data 2. 要增加的节点的前一个节点的 data、key 或者 node

浏览器支持情况

Modern browsers and Internet Explorer 10+.

License

MIT

作品展示