如何使用Vue3+elementPlus的Tree組件實現一個拖拽文件夾管理
最近在做一個文件夾管理的功能,要實現一個樹狀的拖拽文件夾面板。里面包含兩種元素,文件夾以及文件
1、前言
最近在做一個文件夾管理的功能,要實現一個樹狀的文件夾面板。里面包含兩種元素,文件夾以及文件。交互要求如下:
創(chuàng)建、刪除,重命名文件夾和文件可以拖拽,拖拽文件到文件夾中,或著拖拽文件夾到文件夾中文件夾可展開,顯示里面全部文件拖拽的時候要有輔助線顯示
2、分析
根據這個要求,我先找到了vue.draggable.next這個庫,結合elementPlus的Collapse折疊面板,以及Vue 3的遞歸組件封裝了一個組件 drag-folder
,結果測試發(fā)現,這個庫太久沒維護了,很多事件不支持,導致功能很難實現。比如,拖動的時候拿不到拖動對象所選中的目標、沒有輔助線、Collapse折疊面板關閉后無法拖入等問題。
就在頭疼之時,我不小心看到了elementPlus的Tree組件,發(fā)現它也支持拖拽,而且有輔助線,有豐富的回調事件,于是,我準備魔改一下。
3、 實現
Tree組件只需要準備一個樹狀數據,然后根據數據渲染出Tree組件即可,可以自定義子節(jié)點的鍵名,也可以使用插槽自定義內容,于是一番操作后,我完成了第二版的 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 } ) // 節(jié)點開始拖拽時 const handleDragStart = (node: Node, ev: DragEvents) => {} // 拖拽進入其他節(jié)點時 const handleDragEnter = (draggingNode: Node, dropNode: Node, ev: DragEvents) => {} // 拖拽離開某個節(jié)點時 const handleDragLeave = (draggingNode: Node, dropNode: Node, ev: DragEvents) => {} // 在拖拽節(jié)點時 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) => { // 如果選中的節(jié)點不是看板 則不允許拖動到內部,只能是 '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,發(fā)現不起作用。于是我去翻源碼,發(fā)現源碼: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; }
改完發(fā)現,面板折疊起來是正常的,但是打開后就還是不正常,審查元素發(fā)現,這個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) => { // 如果選中的節(jié)點不是看板 則不允許拖動到內部,只能是 'prev' 或 'next' if (dropNode.data.type === 'billboard') { return type !== 'inner' } return true }
4.4、樣式調整
文件夾和文件的樣式不一樣,要區(qū)分,這里我們用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拖拽文件夾內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
Vue Element前端應用開發(fā)之Vuex中的API Store View的使用
這篇文章主要介紹了Vue Element前端應用開發(fā)之Vuex中的API Store View的使用,對Vue感興趣的同學,可以參考下2021-05-05解決vue bus.$emit觸發(fā)第一次$on監(jiān)聽不到問題
這篇文章主要介紹了解決vue bus.$emit觸發(fā)第一次$on監(jiān)聽不到問題,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2020-07-07vue-cli5.0?webpack?采用?copy-webpack-plugin?打包復制文件的方法
今天就好好說說vue-cli5.0種使用copy-webpack-plugin插件該如何配置的問題。這里我們安裝的 copy-webpack-plugin 的版本是 ^11.0.0,感興趣的朋友一起看看吧2022-06-06