The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- 新增节点选中的样式class
- 展开icon的class转移到父节点
- 删除vTree的usePadding属性,使用 padding 代替 margin 来展示子节点缩进
CTreeDrop
默认与 display slot 新增 Slot Props
- 修复
CTreeDrop
下拉框定位top
,bottom
不正确的问题
- 修复
CTreeDrop
下拉框定位不正确的问题
- 修改
package.json
字段
- 树子节点新增
_is-leaf
class
- 优化拖拽操作
- 修复
expandedKeys
在重新设置 data 后无效的问题
CTree
新增expandedKeys
Prop 以响应展开节点变化CTree
新增nodeClassName
Prop 给每个节点添加自定义的 class
CTree
node-drop
事件提到Tree.vue
组件触发,且在拖拽成功后触发,因此触发频率相比以往会降低
CTree
defaultExpandedKeys
Prop 因为设计时不考虑其改变的情况,现已不推荐使用,将在下个大版本废弃,推荐改用expandedKeys
CTree
node-drop
事件新增被拖拽节点参数
CTree
新增expandOnFilter
Prop 来决定过滤时是否展开所有可见节点CTree
新增unselectOnClick
Prop 可配置单选点击已选中节点时是否取消选中的行为
- 取消运行时删除再定义
nonReactive
的行为,改为使用 TypeScript 类型断言来修复找不到nonReactive
属性的报错 - 由于上述修改,测试用例不得不使用
(vm as any).nonReactive
来代替vm.$data.nonReactive
- 以上两点修改对树组件使用者没有影响
- 修复
insertBefore
,insertAfter
方法逻辑错误
- 修复执行插入方法时数据不正确的问题
- 修复
CTreeDrop
单选点击清空时,未加载数据无法清空的问题
- 修复 2.0.16 版本导致
CTreeDrop
收起再展开数据显示不全的问题 - 修复
CTreeDrop
收起时会展开数据的问题
- 修复
CTreeDrop
收起时会展开数据的问题
CTreeDrop
收起时清空搜索关键字
- 修复
CTreeDrop
挂载后设置新的数据,显示不刷新的问题
CTreeDrop
设置clearable
为 true 后,若没有checkable
或selectable
,或没有选中的值,将不会出现清空按钮- 增大展开节点图标点击热区,点不到展开图标?不存在的
- 修复过滤状态的树无法从外部清除被过滤节点的选中的问题
- 修复 value 是未加载单选节点时重置 value 不触发 selected-change 事件问题
- 修复先设置 value 后设置 data 时,
CTreeSearch
与CTreeDrop
值不回显的问题
- 禁用
CTreeDrop
不显示右侧下拉箭头与清除按钮 - 缩小
CTreeDrop
搜索输入框上下间距 - 修改输入框 placeholder 颜色值为
#c5c8ce
- 修复禁用下拉框可以点击清除的问题
- 不级联搜索父节点现在子节点也会出现在结果中
- 修复单选搜索父节点无法显示子节点的问题
CTree
事件传出带_parent
与children
的完整节点信息- 节点
render
传入带_parent
与children
的完整节点信息参数
- 修复树数据设置单选时无法取消选中的问题
- 修复
setExpandAll
在异步加载的情况下会无限载入的问题 - 修复 data 变化时单选选中值异常,有值但界面上不选中的问题
setExpand
新增expandParent
参数,设置为 true 可同时展开父节点,默认为 true
- 修复
setExpandKeys
第二个参数无效的问题 - 修复
filter
方法过滤函数参数在传入 filterMethod Prop 的情况下无法覆盖的问题
- CTreeDrop 新增
dropdownWidthFixed
Prop 以阻止下拉框宽度自适应
- 修复标题换行导致的样式问题
- 修复点击子节点会触发 expand 事件的问题
- scroll 事件监听器加上
.passive
修饰符
- 修复 CTreeSearch 初始化未更新全选复选框
- 非级联过滤不根据父节点过滤情况判断
- filter 不使用递归
- 修复 CTreeDrop 初始展示文字不准确
- 修复 CTree value 改变会触发两次
checked-change
事件的问题
- CTreeSearch 新增
searchMethod
自定义搜索方法
- CTreeSearch
searchRemote
Prop 在传入searchMethod
时无效
- 修复 CTreeDrop 展示框文字垂直不居中
- CTreeDrop 新增
dropdownMinWidth
Prop 可指定下拉框最小宽度
- 兼容 Vue 2.5.16
v-model
与$attrs
问题 - 修复指定 titleField 失效的问题
Warning: 2.x 进行了重构,与 1.x 的内部逻辑、行为表现以及 API 都有较大的差异,本更新日志可能无法将所有差异都列全。
功能上新增:
- 支持单选与多选并存
- 丰富获取节点数据 API
- 新增节点增删 API
- 新增节点拖拽功能
- 树搜索新增全选复选框
CTree Props:
- 新增
unloadDataList
Prop - 新增
showUnloadCheckedNodes
Prop - 新增
filteredNodeCheckable
Prop - 新增
defaultExpandAll
Prop - 新增
defaultExpandedKeys
Prop - 新增
draggable
,droppable
,beforeDropMethod
Props,支持拖拽 - 新增
autoLoad
Prop 控制异步时是否自动加载根节点 - 新增
nodeMinHeight
,nodeIndent
,renderNodeAmount
,bufferNodeAmount
Props 控制节点渲染
CTree Events:
- 新增
expand
事件 - 新增
click
,node-dblclick
,node-right-click
节点点击事件 - 新增
node-dragstart
,node-dragenter
,node-dragover
,node-dragleave
,node-drop
节点拖拽事件
CTree Methods:
- 新增
setData
方法设置树数据 - 新增
checkAll
,clearChecked
方法进行多选全部勾选、全部取消操作 - 新增
setExpandKeys
- 新增
getCheckedKeys
,getSelectedKey
,getExpandNodes
,getExpandKeys
,getCurrentVisibleNodes
,getNode
,getTreeData
,getFlatData
,getNodesCount
方法获取相应的节点数据 - 新增
insertBefore
,insertAfter
,append
,prepend
,remove
方法操作节点增加与删除 - 新增
showCheckedNodes
方法展示已选节点 - 新增
scrollTo
方法设置滚动到指定节点
CTree Slots:
- 新增
empty
Slot 自定义暂无数据 DOM - 新增
loading
Slot 自定义加载图标
CTree Data Fields:
- 新增
_filterVisible
表示是否过滤后可见 - 新增
_parent
指向父节点 - 新增
_loading
表示节点是否正在加载
CTreeSearch Props:
- 新增
showCheckAll
,showCheckedButton
,checkedButtonText
Props - 新增
searchRemote
Prop 远程搜索 - 新增
searchDebounceTime
Prop 指定搜索防抖时间
CTreeSearch Methods:
- 新增
clearKeyword
方法清空关键字 - 新增
search
方法手动执行搜索
CTreeSearch Slots:
- 新增
search-input
自定义搜索输入框 - 新增
actions
添加操作按钮 - 新增
footer
自定义底部信息
CTreeDrop Props:
- 新增
dropHeight
Prop 控制下拉内容高度 - 新增
dropDisabled
Prop 控制是否禁用 - 新增
placement
Prop 控制下拉框弹出位置 - 新增
transfer
Prop 实现将下拉框 DOM 移动到 body 中 - 新增
dropdownClassName
Prop 给下拉框添加 class
CTreeDrop Slots:
- 新增默认 Slot 自定义展示输入框
- 新增
clear
Slot 自定义清空图标
CTree Props:
value
不再接收对象类型的值,改为只接收单个 key 或字符串或 key 数组filterMethod
参数固定为 2 个selectMode
改为checkable
和selectable
,支持单选与多选并存disabled
更名为disableAll
expand
更名为defaultExpandAll
CTree Events:
- 目前事件所触发出来的数据均为 TreeNode 类型数据,请不要在外部直接修改(除了点击和拖拽不是完整的节点数据)
CTree Methods:
getCheckedNodes
方法参数变为 1 个,同时不再返回未加载的节点,可以用getCheckedKeys
获取全量选中的 keyloadRootNodes
不再接收参数,需要清空选中请直接清空value
setChecked
方法只接收 2 个参数
CTree Data Fields:
level
更名为_level
CTreeSearch Props:
placeholder
更名为searchPlaceholder
searchInputDisabled
更名为searchDisabled
CTreeSearch Methods:
getValidSearchKeyword
更名为getKeyword
,同时不再保证是有效的搜索关键字,而是返回当前搜索输入框内 v-model 绑定的值
CTreeDrop Props:
displayPlaceholder
更名为dropPlaceholder
allowClear
更名为clearable
功能移除:
- 移除 CTreeDrop 展示动画,展示框统一展示为
已选 x 个
CTree Props:
- 移除
uncheckUnloadedMethod
- 移除
selectMode
CTree Methods:
- 移除
getInitChecked
方法 - 移除
setCheckedNodes
方法
CTreeSearch Props:
- 移除
value
,可正常使用 v-model ,请放心 - 移除
width
- 移除
treeHeight
- 移除
showActionBar
- 移除
showSearchInput
- 移除
ignoreMode
- 移除
showTreeBorder
CTreeDrop Props:
- 移除
value
,可正常使用 v-model ,请放心 - 移除
displayWidth
- 移除
displayHeight
- 移除
treeHeight