近期在工作中遇到了一个新的需求,该需求需要实现某个组件的拖拽,面对这个需求的第一个项目肯定是问问度娘和用最大同性交友网站进行搜索,最终皇天不负有心人,让我找到了这个17k star的React拖拽库——React DnD。
鹤峰网站制作公司哪家好,找创新互联公司!从网页设计、网站建设、微信开发、APP开发、响应式网站等网站项目制作,到程序开发,运营维护。创新互联公司自2013年起到现在10年的时间,我们拥有了丰富的建站经验和运维经验,来保证我们的工作的顺利进行。专注于网站建设就选创新互联公司。
npm install react-dnd -S // react-dnd包,其核心包
npm install react-dnd-html5-backend -S // 拖拽的底层实现所需要的库通过使用React DnD这个库,我认为里面最有用的部分包含一个组件和两个Hook API,它们分别是:
如果想让某一内容使用React DnD的能力,需要将该部分用DndProvider进行包裹,其接收参数如下所示:
下面来一起看看该组件的简单使用:
import {DndProvider} from 'react-dnd';
import {HTML5Backend} from 'react-dnd-html5-backend';
function App() {
  return (
    
      
        此处将放拖拽相关内容
       
    
  );
}
export default App;既然知道了整个操纵空间,接下来需要了解的就是从什么位置进行拖拽,该库提供了useDrag hook API,该元素可以让一个DOM元素实现拖拽效果。
参数:
spec:创建规范对象的规范对象或函数,其详细内容如下所示:
type:
必须,是一个字符串或Symbol,只有drop和此值相同才可以进行放置;
item:
必须,用于描述被拖动的数据
previewOptions:
可选的,一个简单对象,用于描述拖动预览选项;
options:
可选的,一个简单对象
end(item, monitor):
可选的,当拖拽停止,该函数被调用;
canDrag(monitor):
可选的,使用它指定当前是否允许拖动;
isDragging(monitor):
可选的,默认情况下,只有启动拖动操作的拖动源才被视为拖动;
collect:
可选的,监听功能。
返回值:
返回值是一个数组,数组内容分别为:
collected:一个对象,包含从collect函数收集的属性,如果collect未定义函数,则返回一个空对象;drag:拖动器的连接器功能,必须附加到DOM的可拖动部分;dragPreview:用于拖动预览的连接器功能,可以附加到DOM的预览部分;
与拖动部分建立连接:
通过ref属性,将drag或dragPreview绑定到拖拽源上。
下面一起来看看useDrag部分的使用
import {useDrag} from 'react-dnd';
const SourceBox = props => {
    const {children} = props;
    /**
     * 返回的参数
     * collected:一个对象,包含从collect函数收集的属性,如果collect未定义函数,则返回一个空对象
     * drag:拖动器的连接器功能,必须附加到DOM的可拖动部分
     * dragPreview:用于拖动预览的连接器功能,可以附加到DOM的预览部分
     */
    const [collected, drag, dragPreview] = useDrag({
        // 只有drop和此值相同才可以进行放置
        type: 'box',
        // 描述要拖动的数据
        item: {
            detail: '我是可以拖动的数据!!!'
        },
        // 拖动停止的手end将会被调用
        end: (item, monitor) => {
            // getDropResult()获取释放后的结果
            console.log('monitor.getDropResult():', monitor.getDropResult());
            // source是否已经drop在target
            console.log('monitor.didDrop()', monitor.didDrop());
        },
        // 指定当前是否允许拖动,默认允许
        canDrag: monitor => {
            return true;
        },
        // 监听功能
        collect: (monitor, props) => {
            return {
                isDragging: monitor.isDragging()
            };
        }
    });
    return (
        
            {children}
        
    );
};
export default SourceBox;为了将内容放置到目标位置,提供了useDrop函数,如下所示:
参数:
spec:创建规范对象的规范对象或函数,其详细内容如下所示:
accept:
必须,一个字符串,此放置目标将仅对于指定类型的拖动源产生的项目作出反应。
options:
可选的,一个普通的对象。
drop(item,monitor):
可选的,当兼容项目放在目标时被调用。
hover(item,monitor):
可选的,将项目悬停在组件时调用。
canDrop(item,monitor):
可选的,用它来指定放置目标是否接受该拖拽内容。
collect:
可选的,监听功能。
返回值:
返回值是一个数组,数组内容分别为:
collected:一个对象,包含从collect函数收集的属性,如果collect未定义函数,则返回一个空对象;drop:一个用于放置目标的连接器函数,必须附加到DOM的放置部分;
与放置部分建立连接:
通过ref属性,将drop与放置部分建立连接。
下面一起来看看useDrop部分的使用
import {useDrop} from "react-dnd";
const TargetBox = () => {
    const [collected, drop] = useDrop({
        //  此放置目标将仅对于指定类型的拖动源产生的项目作出反应
        accept: 'box',
        // 当兼容项目放在目标时调用
        drop: (item, monitor) => {
            console.log('我已经被放到目标!!!')
        },
        // 监听功能
        collect: monitor => {
            return {
                // 是否重叠
                isOver: monitor.isOver(),
                // 是否可以放置
                canDrop: monitor.canDrop(),
                item: monitor.getItem(),
                didDrop: monitor.didDrop()
            };
        }
    });
    return (
        
            
                这是放置的区块
            
        
    );
};
export default TargetBox;useDrag和useDrop上挂载了很多选项,这些选项中很多存在monitor对象,该对象上挂载了很多方法,下面就简要概述几个主要方法,如下所示:
drag上的monitor上的方法:
drop上的monitor上的方法:
拖拽前:
拖拽中:
拖拽中拖拽的内容跟随鼠标移动。
拖拽后:
拖拽释放鼠标后,一些内容被打印出来,打印的结果是先输出drop中的内容再输出end中的内容,所以我们想做一些处理最后在SourceBox中进行处理,如果在drop中改变React相关的数据会报错。
这个库的资料千篇一律,在使用过程中遇到了一些坑,接下来与各位老铁分享一下这些坑,防止后续深陷其中。