前沿
最近发现公司的产品好几个模块用到了拖拽功能,之前拖拽组件是通过Html5 drag Api 实现的但体验并不是很好,顺便将原来的拖拽组建稍做修改,写一个自定义hook,方便大家使用拖拽功能。
正文
拖拽功能原理:
1、拖拽元素通过addEventListener监听器添加鼠标按下,鼠标移动,以及鼠标抬起事件。
2、再通过getBoundingClientRect() 得到拖拽元素四周相对于可拖拽区域边界的距离。
3、鼠标移动时计算x轴和y轴的移动偏移量。
4、通过element.style.transform 设置元素移动。
5、每次拖拽完成后,都将此次偏移量保存,下次再次拖拽时,可以保证位置的实时性。
代码开发:
useDrag.jsx
import { useEffect, useState } from "react"; /* * @drag: 添加拖拽事件的元素(支持传入元素的drager,id,class等)必填参数 * @draggerBox: 被拖拽的整体元素(支持传入元素的dragger,id,class等)可选参数 * @container: 可拖拽的区域(支持传入元素的dragger,id,class等)可选参数 * @maring: 离外部元素的间隔 可选参数 */ export default function useDrag({ dragger, draggerBox = dragger, container = document.body, maring = [0, 0, 0, 0] }) { const [translateX, setTranslateX] = useState(0); // 水平方向偏移量 const [translateY, setTranslateY] = useState(0); // 垂直方向偏移量 useEffect(() => { if (!dragger) return; if (!draggerBox) return; if (!container) return; dragger = typeof dragger === 'string' ? document.querySelector(dragger) : dragger; // 根据传入的值类型,去查找使用元素 draggerBox = typeof draggerBox === 'string' ? document.querySelector(draggerBox) : draggerBox; container = typeof container === 'string' ? document.querySelector(container) : container; const { left: containerL, top: containerT, right: containerR, bottom: containerB } = container.getBoundingClientRect(); // 获取可拖拽区域边界位置 const onMouseDown = event => { const initMouseX = event.clientX; // 元素初始水平坐标值 const initMouseY = event.clientY;// 元素初始垂直坐标 const { left: boxL, top: boxT, right: boxR, bottom: boxB } = draggerBox.getBoundingClientRect(); // 获取拖拽实体的位置 let deltaMouseX; // 实际水平偏移量 let deltaMouseY; // 实际垂直增量值 const onMouseMove = event => { const moveMouseX = event.clientX; // 元素移动后水平坐标值 const moveMouseY = event.clientY; // 元素移动后垂直坐标值 let deltaX = moveMouseX - initMouseX; // 当前移动水平相对移动距离 let deltaY = moveMouseY - initMouseY; // 当前移动垂直相对移动距离 if (boxL + deltaX < containerL + maring[0]) { // 当元素左边框+水平相对移动距离 < 可拖拽区域左边界+左边距时 (说明元素已经超出左侧边界) deltaX = containerL + maring[0] - boxL; } if (boxR + deltaX > containerR - maring[1]) { // 当元素右边框+水平相对移动距离 > 可拖拽区域右边界+右边距时 (说明元素已经超出右侧边界) deltaX = containerR - maring[1] - boxR; } if (boxB + deltaY > containerB - maring[2]) { // 当元素下边框+垂直相对移动距离 > 可拖拽区域下边界+下边距时 (说明元素已经超出下侧边界) deltaY = containerB - maring[2] - boxB; } if (boxT + deltaY < containerT + maring[3]) { // 当元素上边框+垂直相对移动距离 < 可拖拽区域上边界+上边距时 (说明元素已经超出上侧边界) deltaY = containerT + maring[3] - boxT } deltaMouseX = deltaX + translateX; // 实际水平偏移量 deltaMouseY = deltaY + translateY; // 实际垂直偏移量 draggerBox.style.transform = `translate(${deltaMouseX}px, ${deltaMouseY}px)`; }; const onMouseUp = () => { setTranslateX(deltaMouseX); // 保存上次水平偏移量 setTranslateY(deltaMouseY); // 保存上次垂直偏移量 window.removeEventListener('mousemove', onMouseMove); window.removeEventListener('mouseup', onMouseUp); } window.addEventListener('mousemove', onMouseMove); window.addEventListener('mouseup', onMouseUp); } dragger.addEventListener('mousedown', onMouseDown); return () => dragger.removeEventListener('mouseup', onMouseDown); }, [dragger, draggerBox, container, maring]) }
使用方法:
import React from 'react'; import useDrag from '../hooks/useDrag' import './index.less'; function Test() { useDrag({ dragger: '.dragger', draggerBox: '.draggerBox', container: '.container', maring: [10, 10, 10, 10]}) return ( <div className='container'> <div className='draggerBox'> <div className='dragger'> </div> </div> </div> ) } export default Test;
.container{ width: 800px; height: 800px; position: absolute; top: 50%; left: 50%; margin: -400px 0 0 -400px; border: 2px solid green; } .draggerBox{ width: 200px; height: 300px; border: 1px solid red; } .dragger{ width: 100%; height: 50px; background: blue; }
效果展示
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持阿兔在线工具。