如何使用Vue3+elementPlus的Tree组件实现一个拖拽文件夹管理

 更新时间:2023年09月26日 09:08:31   作者:鹏多多  
最近在做一个文件夹管理的功能,要实现一个树状的拖拽文件夹面板,里面包含两种元素,文件夹以及文件,这篇文章主要介绍了使用Vue3+elementPlus的Tree组件实现一个拖拽文件夹管理 ,需要的朋友可以参考下

最近在做一个文件夹管理的功能,要实现一个树状的拖拽文件夹面板。里面包含两种元素,文件夹以及文件

1、前言

最近在做一个文件夹管理的功能,要实现一个树状的文件夹面板。里面包含两种元素,文件夹以及文件。交互要求如下:

创建、删除,重命名文件夹和文件可以拖拽,拖拽文件到文件夹中,或着拖拽文件夹到文件夹中文件夹可展开,显示里面全部文件拖拽的时候要有辅助线显示

2、分析

根据这个要求,我先找到了vue.draggable.next这个库,结合elementPlus的Collapse折叠面板,以及Vue 3的递归组件封装了一个组件 drag-folder ,结果测试发现,这个库太久没维护了,很多事件不支持,导致功能很难实现。比如,拖动的时候拿不到拖动对象所选中的目标、没有辅助线、Collapse折叠面板关闭后无法拖入等问题。

就在头疼之时,我不小心看到了elementPlus的Tree组件,发现它也支持拖拽,而且有辅助线,有丰富的回调事件,于是,我准备魔改一下。

3、 实现

Tree组件只需要准备一个树状数据,然后根据数据渲染出Tree组件即可,可以自定义子节点的键名,也可以使用插槽自定义内容,于是一番操作后,我完成了第二版的 drag-folder 组件:

<template>
	<div class="drag_folder_box">
		<el-tree
			draggable
			node-key="uid"
			:default-expanded-keys="defaultExpanded"
			:data="interiorList"
			:allow-drop="handleDragBehavior"
			:allow-drag="handleAllowDrag"
			@node-drag-start="handleDragStart"
			@node-drag-enter="handleDragEnter"
			@node-drag-leave="handleDragLeave"
			@node-drag-over="handleDragOver"
			@node-drag-end="handleDragEnd"
			@node-drop="handleDrop"
			@node-click="handleSwitchBillboard"
		>
			<template #default="{ data }">
				<div class="tree_item">
					<div class="item_title">{{ data.label }}</div>
					<div class="item_operate">
						<div class="operate_item" title="编辑" @click.stop="editBillboard(data)">
							<el-icon :size="16">
								<ele-Edit />
							</el-icon>
						</div>
						<div class="operate_item" title="删除" @click.stop="deleteBillboard(data)">
							<el-icon :size="16">
								<ele-Delete />
							</el-icon>
						</div>
					</div>
				</div>
			</template>
		</el-tree>
	</div>
</template>
<script setup lang="ts">
import { ref, onMounted, watch } from 'vue'
import type Node from 'element-plus/es/components/tree/src/model/node'
import type { DragEvents } from 'element-plus/es/components/tree/src/model/useDragNode'
import type { AllowDropType, NodeDropType } from 'element-plus/es/components/tree/src/tree.type'
import type { IGetBillboardListTreeItem } from '@/types/data-billboard'
// #region 组件逻辑
interface IProps {
	list?: Array<IGetBillboardListTreeItem>
}
const props = withDefaults(defineProps<IProps>(), {
	list: () => []
})
const emit = defineEmits(['edit', 'delete', 'switch', 'change'])
const interiorList = ref<Array<IGetBillboardListTreeItem>>([])
// #endregion
// #region 拖拽逻辑
watch(
	() => props.list,
	(newValue) => {
		interiorList.value = newValue
	},
	{
		deep: true,
		immediate: true
	}
)
// 节点开始拖拽时
const handleDragStart = (node: Node, ev: DragEvents) => {}
// 拖拽进入其他节点时
const handleDragEnter = (draggingNode: Node, dropNode: Node, ev: DragEvents) => {}
// 拖拽离开某个节点时
const handleDragLeave = (draggingNode: Node, dropNode: Node, ev: DragEvents) => {}
// 在拖拽节点时
const handleDragOver = (draggingNode: Node, dropNode: Node, ev: DragEvents) => {}
// 拖拽结束时
const handleDragEnd = (draggingNode: Node, dropNode: Node, dropType: NodeDropType, ev: DragEvents) => {}
// 拖拽成功时
const handleDrop = (draggingNode: Node, dropNode: Node, dropType: NodeDropType, ev: DragEvents) => {
	emit('change', interiorList.value)
}
// 是否允许拖拽
const handleAllowDrag = (draggingNode: Node) => {
	return true
}
// 拖拽行为判断
const handleDragBehavior = (draggingNode: Node, dropNode: Node, type: AllowDropType) => {
	// 如果选中的节点不是看板 则不允许拖动到内部,只能是 'prev' 或 'next'
	if (dropNode.data.type === 'billboard') {
		return type !== 'inner'
	}
	return true
}
// 编辑看板/文件夹
const editBillboard = (data: IGetBillboardListTreeItem) => {
	emit('edit', data)
}
// 删除看板/文件夹
const deleteBillboard = (data: IGetBillboardListTreeItem) => {
	emit('delete', data)
}
// 选择看板
const handleSwitchBillboard = (data: IGetBillboardListTreeItem) => {
	if (data.type === 'dir') return
	if (data.id === props.billboardId) return
	emit('switch', data)
}
// #endregion
// #region 生命周期
onMounted(() => {
	interiorList.value = props?.list || []
})
// #endregion
</script>

这个组件,使用起来很简单,只需要引入组件,然后绑定list就行了,下面我讲一下这里面的一些坑。

4、踩坑

这里面有几个坑,但是基本都解决了。

4.1、拖拽辅助线的坑

Tree组件没有itemSize属性,它的辅助线,默认是26px,而我的每一项,是36px的高度,所以就会导致辅助线不能对准。

最开始我想着修改样式,给height和line-height,发现不起作用。于是我去翻源码,发现源码:node_modules\element-plus\lib\components\tree\src\model\useDragNode.js里,treeNodeDragOver方法是给辅助线设置top的,这个top是根据前面的iconPosition的高度来的,所以我设置了icon的height和line-height,一顿操纵如下:

.el-tree-node__expand-icon {
	line-height: 36px !important;
	height: 36px !important;
	padding: 0px 2px !important;
}

改完发现,面板折叠起来是正常的,但是打开后就还是不正常,审查元素发现,这个icon会旋转,打开面板后会添加一个expanded的类名,该类名添加了transform: rotate(90deg)的属性,导致高度不对了,于是我又一顿操作:

.el-tree-node__expand-icon {
	line-height: 36px !important;
	height: 36px !important;
	padding: 0px 2px !important;
}
.el-tree-node__expand-icon.expanded {
	transform: rotate(0deg);
	& svg {
		transform: rotate(90deg);
	}
}

4.2、数据的坑

这个是我们后端设计的锅。文件夹和文件的ID,会出现一样的,没有唯一ID,没办法,谁让我们前端就是这么善解人意,写个递归函数,拼接一个唯一ID出来咯。

const formatBillboardList = (list: Array<IBillboardTreeItem>, pid: number): Array<IBillboardTreeItem> => {
	return list.map((item, index) => {
		// 唯一ID
		const uid = `${item.type}_${item.id}`
		// 父ID
		const parentId = pid === 0 ? item.id : pid
		// 子层
		const children = Array.isArray(item.children) ? formatBillboardList(item.children, item.id) : []
		return {
			...item,
			uid,
			order: index,
			parentId,
			children
		}
	})
}
const list = formatBillboardList(res.data, 0)

4.3、限制拖拽

文件夹和文件,都是可以拖拽的,但是文件可以拖拽到文件夹上,文件夹不能拖拽到文件里。这里我们用到了Tree组件的allow-drop处理函数,它又三个参数,分别是拖拽对象,目标对象,拖拽类型。

const handleDragBehavior = (draggingNode: Node, dropNode: Node, type: AllowDropType) => {
	// 如果选中的节点不是看板 则不允许拖动到内部,只能是 'prev' 或 'next'
	if (dropNode.data.type === 'billboard') {
		return type !== 'inner'
	}
	return true
}

4.4、样式调整

文件夹和文件的样式不一样,要区分,这里我们用Tree组件的props属性,定制class实现

const treeOption = {
	class: (data: IGetBillboardListTreeItem, node: Node) => {
		if (data.id === props.billboardId && data.type === 'billboard') {
			return 'on_tree_item'
		} else if (data.type === 'dir') {
			return 'folder'
		} else {
			return 'billboard'
		}
	}
}

每一层,要有不同的缩进,比如第一层缩进10,第二层20,以此类推,这里我们用Tree组件的indent属性实现,直接绑定即可。

<el-tree :indent="10"></el-tree>

修改hover和focus时候的背景色

.drag_folder_box {
  &:deep(.el-tree-node__content) {
		width: 100%;
		height: auto;
		border-bottom: 1px solid #c1c1c1;
		&:hover {
			background-color: #e4f2ff !important;
		}
		&:focus {
			background-color: #e4f2ff !important;
		}
	}
}

如上,基本的样式和功能就全部完成了。

到此这篇关于使用Vue3+elementPlus的Tree组件实现一个拖拽文件夹管理的文章就介绍到这了,更多相关Vue3 elementPlus拖拽文件夹内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue中input标签上传本地文件或图片后获取完整路径的解决方法

    vue中input标签上传本地文件或图片后获取完整路径的解决方法

    本文给大家介绍vue中input标签上传本地文件或图片后获取完整路径,如E:\medicineOfCH\stageImage\xxx.jpg,本文给大家分享完美解决方案,感兴趣的朋友跟随小编一起看看吧
    2023-04-04
  • 在Vue中创建可重用的 Transition的方法

    在Vue中创建可重用的 Transition的方法

    这篇文章主要介绍了在Vue中创建可重用的 Transition,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-06-06
  • vue项目中使用高德地图的超详细步骤

    vue项目中使用高德地图的超详细步骤

    在vue项目中添加高德地图,对开发地图的开发人员有一定帮助,下面这篇文章主要给大家介绍了关于vue项目中使用高德地图的超详细步骤,文中通过图文以及实例代码介绍的非常详细,需要的朋友可以参考下
    2023-03-03
  • 从vue-router看前端路由的两种实现

    从vue-router看前端路由的两种实现

    本文由浅入深观摩vue-router源码是如何通过hash与History interface两种方式实现前端路由,介绍了相关原理,并对比了两种方式的优缺点与注意事项。最后分析了如何实现可以直接从文件系统加载而不借助后端服务器的Vue单页应用。
    2021-05-05
  • 浅析Vue中Virtual DOM和Diff原理及实现

    浅析Vue中Virtual DOM和Diff原理及实现

    这篇文章主要为大家详细介绍了Vue中Virtual DOM和Diff原理及实现的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以了解一下
    2023-03-03
  • vue element-ui el-tooltip组件失效问题及解决

    vue element-ui el-tooltip组件失效问题及解决

    这篇文章主要介绍了vue element-ui el-tooltip组件失效问题及解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-10-10
  • vant中如何修改用户的头像

    vant中如何修改用户的头像

    这篇文章主要介绍了vant中如何修改用户的头像,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-08-08
  • 详解解决Vue相同路由参数不同不会刷新的问题

    详解解决Vue相同路由参数不同不会刷新的问题

    这篇文章主要介绍了详解解决Vue相同路由参数不同不会刷新的问题,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-10-10
  • 一文带你搞懂V8垃圾回收系统

    一文带你搞懂V8垃圾回收系统

    在V8中,JavaScript的内存空间分为栈(Stack)和堆(Heap)两部分,垃圾回收的基本思路是:查找内存中的所有变量,看哪些已经不再需要,然后释放这些变量所占用的内存,本文就给大家梳理一下V8垃圾回收系统,需要的朋友可以参考下
    2023-07-07
  • vuex实现简单的购物车功能

    vuex实现简单的购物车功能

    这篇文章主要为大家详细介绍了vuex实现简单的购物车功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-07-07

最新评论