我們是袋鼠云數堆疊 UED 團隊，致力于打造優秀的一站式資料中臺產品，我們始終保持工匠精神，探索前端道路，為社區積累并傳播經驗價值，，

本文作者：霽明

一、背景

1、業務背景

業務中會有一些需要實作拖拽的場景，尤其是偏視覺方向以及移動端較多，拖拽在一定程度上能讓互動更加便捷，能大大提升用戶體驗，以業務中心子產品配置功能為例，產品模塊通過拖拽來調整順序，的確會更加方便一些，

file

2、React DnD 介紹

參考官網介紹：
React DnD 是一組 React 實用程式，可幫助您構建復雜的拖放界面，同時保持組件分離，它非常適合 Trello 和 Storify 等應用程式，在應用程式的不同部分之間拖動可以傳輸資料，組件會根據拖放事件更改其外觀和應用程式狀態，
React-DnD 特點：

使用包裹及注入的方式使組件實作拖拽
可用于構建復雜的拖放界面，同時保持組件分離
采用單向資料流
抹平了不同瀏覽器平臺的差異
可擴展可測驗
支持觸屏操作

二、使用方式

1、安裝

安裝 react-dnd, react-dnd-html5-backend

npm install react-dnd react-dnd-html5-backend

2、DndProvider

將需要拖拽的組件使用DndProvider進行包裹

import { DndProvider } from 'react-dnd';
import { HTML5Backend } from 'react-dnd-html5-backend';
import Container from '../components/container';

export default function App() {
  return (
    <DndProvider backend={HTML5Backend}>
      <Container />
    </DndProvider>
  );
}

看下Container組件，主要是管理資料，并渲染Card串列

function Container() {
  // ...
  return (
    <div style={{ width: 400 }}>
      {cards.map((card, index) => (
        <Card
          key={card.id}
          index={index}
          id={card.id}
          text={card.text}
          moveCard={moveCard}
        />
      ))}
    </div>
  );
}

3、useDrag和useDrop

接下來看下Card組件，

import { useRef } from 'react';
import { useDrag, useDrop } from 'react-dnd';
import styles from '../styles/home.module.css';

function Card({ id, text, index, moveCard }: ICardProps) {
  const ref = useRef<HTMLDivElement>(null);

  const [{ handlerId }, drop] = useDrop({
    accept: CARD,
    collect(monitor) {
      return {
        handlerId: monitor.getHandlerId(),
      };
    },
    hover(item: IDragItem, monitor) {
      if (!ref.current) {
        return;
      }
      const dragIndex = item.index;
      const hoverIndex = index;
      // ...
      // 更新元素的位置
      moveCard(dragIndex, hoverIndex);
      // ...
    },
  });

  const [{ isDragging }, drag] = useDrag({
    type: CARD,
    item: { id, index },
    collect: (monitor: any) => ({
      isDragging: monitor.isDragging(),
    }),
  });

  drag(drop(ref));
  const opacity = isDragging ? 0 : 1;

  return (
    <div
      ref={ref}
      className={styles.card}
      style={{ opacity }}
      data-handler-id={handlerId}
    >
      {text}
    </div>
  );
}

至此一個簡單的拖拽排序串列就實作了，實作的效果類似于React DnD官網的這個示例：https://react-dnd.github.io/react-dnd/examples/sortable/simple，接下來我們來看看實作原理，

三、原理決議

1、總體架構

主要代碼代碼目錄結構

file

核心代碼主要分三個部分：

dnd-core：核心邏輯，定義了拖拽介面、管理方式、資料流向
backend：抽象出來的后端概念，主要處理DOM事件
react-dnd：封裝React組件，提供api，相當于接入層

核心實作原理：
dnd-core向backend提供資料的更新方法，backend在拖拽時更新dnd-core中的資料，dnd-core通過react-dnd更新業務組件，

file

2、DndProvider

先看一下原始碼

/**
 * A React component that provides the React-DnD context
 */
export const DndProvider: FC<DndProviderProps<unknown, unknown>> = memo(
  function DndProvider({ children, ...props }) {
    const [manager, isGlobalInstance] = getDndContextValue(props) // memoized from props
    // ...
    return <DndContext.Provider value=https://www.cnblogs.com/dtux/archive/2023/06/09/{manager}>{children}
  },
)

從以上代碼可以看出，生成了一個manager，并將其放到DndContext.Provider中，先看下DndContext的代碼：

import { createContext } from 'react'
// ...
export const DndContext = createContext<DndContextType>({
  dragDropManager: undefined,
})

就是使用 React 的createContext創建的背景關系容器組件，

接下來看下這個manager，主要是用來控制拖拽行為，通過Provider讓子節點也可以訪問，我們看下創建manager的getDndContextValue方法：

import type { BackendFactory, DragDropManager } from 'dnd-core'
import { createDragDropManager } from 'dnd-core'
// ...
function getDndContextValue(props: DndProviderProps<unknown, unknown>) {
  if ('manager' in props) {
     const manager = { dragDropManager: props.manager }
     return [manager, false]
  }

   const manager = createSingletonDndContext(
     props.backend,
     props.context,
     props.options,
     props.debugMode,
    )
   const isGlobalInstance = !props.context

   return [manager, isGlobalInstance]
}

function createSingletonDndContext<BackendContext, BackendOptions>(
   backend: BackendFactory,
   context: BackendContext = getGlobalContext(),
   options: BackendOptions,
   debugMode?: boolean,
) {
   const ctx = context as any
   if (!ctx[INSTANCE_SYM]) {
     ctx[INSTANCE_SYM] = {
       dragDropManager: createDragDropManager(
        backend,
	context,
	options,
	debugMode,
       ),
     }
   }
   return ctx[INSTANCE_SYM]
}

從以上代碼可以看出，getDndContextValue方法又呼叫了createSingletonDndContext方法，并傳入了backend、context、options、debugMode這幾個屬性，然后通過dnd-core中的createDragDropManager來創建manager，

3、DragDropManager

看下createDragDropManager.js中的主要代碼

import type { Store } from 'redux'
import { createStore } from 'redux'
// ...
import { reduce } from './reducers/index.js'

export function createDragDropManager(
  backendFactory: BackendFactory,
  globalContext: unknown = undefined,
  backendOptions: unknown = {},
  debugMode = false,
): DragDropManager {
  const store = makeStoreInstance(debugMode)
  const monitor = new DragDropMonitorImpl(store, new HandlerRegistryImpl(store))
  const manager = new DragDropManagerImpl(store, monitor)
  const backend = backendFactory(manager, globalContext, backendOptions)
  manager.receiveBackend(backend)
  return manager
}

function makeStoreInstance(debugMode: boolean): Store<State> {
  // ...
  return createStore(
    reduce,
    debugMode &&
    reduxDevTools &&
    reduxDevTools({
      name: 'dnd-core',
      instanceId: 'dnd-core',
    }),
  )
}

可以看到使用了redux的createStore創建了store，并創建了monitor和manager實體，通過backendFactory創建backend后端實體并安裝到manager總實體，

看一下DragDropManagerImpl的主要代碼

export class DragDropManagerImpl implements DragDropManager {
  private store: Store<State>
  private monitor: DragDropMonitor
  private backend: Backend | undefined
  private isSetUp = false

  public constructor(store: Store<State>, monitor: DragDropMonitor) {
    this.store = store
    this.monitor = monitor
    store.subscribe(this.handleRefCountChange)
   }

   // ...

  public getActions(): DragDropActions {
  /* eslint-disable-next-line @typescript-eslint/no-this-alias */
    const manager = this
    const { dispatch } = this.store

    function bindActionCreator(actionCreator: ActionCreator<any>) {
      return (...args: any[]) => {
        const action = actionCreator.apply(manager, args as any)
        if (typeof action !== 'undefined') {
          dispatch(action)
        }
      }
  }

  const actions = createDragDropActions(this)

  return Object.keys(actions).reduce(
    (boundActions: DragDropActions, key: string) => {
      const action: ActionCreator<any> = (actions as any)[
        key
      ] as ActionCreator<any>
      ;(boundActions as any)[key] = bindActionCreator(action)
        return boundActions
      },
      {} as DragDropActions,
    )
  }

  public dispatch(action: Action<any>): void {
    this.store.dispatch(action)
  }

  private handleRefCountChange = (): void => {
    const shouldSetUp = this.store.getState().refCount > 0
    if (this.backend) {
      if (shouldSetUp && !this.isSetUp) {
	this.backend.setup()
	this.isSetUp = true
      } else if (!shouldSetUp && this.isSetUp) {
	this.backend.teardown()
	this.isSetUp = false
      }
    }
  }
}

先說一下這個handleRefCountChange方法，在建構式里通過store進行訂閱，在第一次使用useDrop或useDrag時會執行setup方法初始化backend，在拖拽源和放置源都被卸載時則會執行teardown銷毀backend，

接下來看一下createDragDropActions方法

export function createDragDropActions(
  manager: DragDropManager,
): DragDropActions {
  return {
    beginDrag: createBeginDrag(manager),
    publishDragSource: createPublishDragSource(manager),
    hover: createHover(manager),
    drop: createDrop(manager),
    endDrag: createEndDrag(manager),
  }
}

可以看到系結一些action：

beginDrag（開始拖動）
publishDragSource（發布當前拖動源）
hover（是否經過）
drop（落下動作）
endDrag（拖拽結束）

manager包含了之前生成的 monitor、store、backend，manager 創建完成，表示此時我們有了一個 store 來管理拖拽中的資料，有了 monitor 來監聽資料和控制行為，能通過 manager 進行注冊，可以通過 backend 將 DOM 事件轉換為 action，接下來便可以注冊拖拽源和放置源了，

4、useDrag

/**
 * useDragSource hook
 * @param sourceSpec The drag source specification (object or function, function preferred)
 * @param deps The memoization deps array to use when evaluating spec changes
 */
export function useDrag<
  DragObject = unknown,
  DropResult = unknown,
  CollectedProps = unknown,
>(
  specArg: FactoryOrInstance<
    DragSourceHookSpec<DragObject, DropResult, CollectedProps>
  >,
  deps?: unknown[],
): [CollectedProps, ConnectDragSource, ConnectDragPreview] {
  const spec = useOptionalFactory(specArg, deps)
  invariant(
    !(spec as any).begin,
    'useDrag::spec.begin was deprecated in v14. Replace spec.begin() with spec.item(). (see more here - https://react-dnd.github.io/react-dnd/docs/api/use-drag)',
  )

  const monitor = useDragSourceMonitor<DragObject, DropResult>()
  const connector = useDragSourceConnector(spec.options, spec.previewOptions)
  useRegisteredDragSource(spec, monitor, connector)

  return [
    useCollectedProps(spec.collect, monitor, connector),
    useConnectDragSource(connector),
    useConnectDragPreview(connector),
  ]
}

可以看到useDrag方法回傳了一個包含3個元素的陣列，CollectedProps（collect方法回傳的物件）、ConnectDragSource（拖拽源連接器）、ConnectDragPreview（拖拽源預覽），

monitor是從前面Provider中的manager中獲取的，主要看下connector

export function useDragSourceConnector(
  dragSourceOptions: DragSourceOptions | undefined,
  dragPreviewOptions: DragPreviewOptions | undefined,
): SourceConnector {
  const manager = useDragDropManager()
  const connector = useMemo(
    () => new SourceConnector(manager.getBackend()),
    [manager],
  )
  // ...
  return connector
}

可以看到connector獲取了manager.getBackend后端的資料，

useRegisteredDragSource方法會對拖動源進行注冊，會保存拖動源實體，并記錄注冊的數量，

5、useDrop

看下useDrop原始碼

/**
 * useDropTarget Hook
 * @param spec The drop target specification (object or function, function preferred)
 * @param deps The memoization deps array to use when evaluating spec changes
 */
export function useDrop<
  DragObject = unknown,
  DropResult = unknown,
  CollectedProps = unknown,
>(
  specArg: FactoryOrInstance<
    DropTargetHookSpec<DragObject, DropResult, CollectedProps>
  >,
  deps?: unknown[],
): [CollectedProps, ConnectDropTarget] {
  const spec = useOptionalFactory(specArg, deps)
  const monitor = useDropTargetMonitor<DragObject, DropResult>()
  const connector = useDropTargetConnector(spec.options)
  useRegisteredDropTarget(spec, monitor, connector)

  return [
    useCollectedProps(spec.collect, monitor, connector),
    useConnectDropTarget(connector),
  ]
}

useDrop回傳了一個包含2個元素的陣列，CollectedProps（collect方法回傳的物件）, ConnectDropTarget（放置源連接器），monitor和connector的獲取都和useDrag類似，

6、HTML5Backend

HTML5Backend使用了HTML5 拖放 API，先了解下HTML拖拽事件：

file

一個簡單拖拽操作程序，會依次觸發拖拽事件：dragstart -> drag -> dragenter -> dragover (-> dragleave) -> drop -> dragend，

drag事件會在dragstar觸發后持續觸發，直至drop，

dragleave事件會在拖拽元素離開一個可釋放目標時觸發，

接下來介紹一下HTML5Backend，是React DnD 主要支持的后端，使用HTML5 拖放 API，它會截取拖動的 DOM 節點并將其用作開箱即用的“拖動預覽”，React DnD 中以可插入的方式實作 HTML5 拖放支持，可以根據觸摸事件、滑鼠事件或其他完全不同的事件撰寫不同的實作，這種可插入的實作在 React DnD 中稱為后端，官網提供了HTML5Backend和TouchBackend，分別用來支持web端和移動端，

后端擔任與 React 的合成事件系統類似的角色：它們抽象出瀏覽器差異并處理原生DOM 事件，盡管有相似之處，但 React DnD 后端并不依賴于 React 或其合成事件系統，在后臺，后端所做的就是將 DOM 事件轉換為 React DnD 可以處理的內部 Redux 操作，

前面給DndProvider傳遞的HTML5backend，看一下其代碼實作：

export const HTML5Backend: BackendFactory = function createBackend(
  manager: DragDropManager,
  context?: HTML5BackendContext,
  options?: HTML5BackendOptions,
): HTML5BackendImpl {
  return new HTML5BackendImpl(manager, context, options)
}

可以看到其實是個回傳HTML5BackendImpl實體的函式，在創建manager實體時會執行createBackend方法創建真正的backend，

如下是 Backend 需要被實作的方法：

export interface Backend {
  setup(): void
  teardown(): void
  connectDragSource(sourceId: any, node?: any, options?: any): Unsubscribe
  connectDragPreview(sourceId: any, node?: any, options?: any): Unsubscribe
  connectDropTarget(targetId: any, node?: any, options?: any): Unsubscribe
  profile(): Record<string, number>
}

setup 是 backend 的初始化方法，teardown 是 backend 銷毀方法，connectDragSource方法將元素轉換為可拖拽元素，并添加監聽事件，connectDropTarget方法會給元素添加監聽事件，connectDragPreview方法會將preview元素保存以供監聽函式使用，profile方法用于回傳一些簡要的統計資訊，

以上這幾個方法都在HTML5BackendImpl中，我們先看一下setup方法：

public setup(): void {
  const root = this.rootElement as RootNode | undefined
  if (root === undefined) {
    return
  }

  if (root.__isReactDndBackendSetUp) {
    throw new Error('Cannot have two HTML5 backends at the same time.')
  }
  root.__isReactDndBackendSetUp = true
  this.addEventListeners(root)
}

root默認是windows，通過addEventListeners方法把監聽事件都系結到windows上，這提高了性能也降低了事件銷毀的難度，

看下addEventListeners方法：

private addEventListeners(target: Node) {
  if (!target.addEventListener) {
    return
  }
  target.addEventListener(
    'dragstart',
    this.handleTopDragStart as EventListener,
  )
  target.addEventListener('dragstart', this.handleTopDragStartCapture, true)
  target.addEventListener('dragend', this.handleTopDragEndCapture, true)
  target.addEventListener(
    'dragenter',
    this.handleTopDragEnter as EventListener,
  )
  target.addEventListener(
    'dragenter',
    this.handleTopDragEnterCapture as EventListener,
    true,
  )
  target.addEventListener(
    'dragleave',
    this.handleTopDragLeaveCapture as EventListener,
    true,
  )
  target.addEventListener('dragover', this.handleTopDragOver as EventListener)
  target.addEventListener(
    'dragover',
    this.handleTopDragOverCapture as EventListener,
    true,
  )
  target.addEventListener('drop', this.handleTopDrop as EventListener)
  target.addEventListener(
    'drop',
    this.handleTopDropCapture as EventListener,
    true,
  )
}

以上代碼中監聽了一些拖拽事件，這些監聽函式會獲得拖拽事件的物件、拿到相應的引數，并執行相應的action方法，HTML5Backend 通過 manager 拿到一個 DragDropActions 的實體，執行其中的方法，DragDropActions 本質就是根據引數將其封裝為一個 action，最終通過 redux 的 dispatch 將 action 分發，改變 store 中的資料，

export interface DragDropActions {
  beginDrag(
    sourceIds?: Identifier[],
    options?: any,
  ): Action<BeginDragPayload> | undefined
    publishDragSource(): SentinelAction | undefined
    hover(targetIds: Identifier[], options?: any): Action<HoverPayload>
    drop(options?: any): void
    endDrag(): SentinelAction
}

最后我們再看下connectDragSource方法：

public connectDragSource(
  sourceId: string,
  node: Element,
  options: any,
): Unsubscribe {
  // ...
  node.setAttribute('draggable', 'true')
  node.addEventListener('dragstart', handleDragStart)
  node.addEventListener('selectstart', handleSelectStart)

  return (): void => {
    // ...
    node.removeEventListener('dragstart', handleDragStart)
    node.removeEventListener('selectstart', handleSelectStart)
    node.setAttribute('draggable', 'false')
  }
}

可以看到主要是把節點的draggable屬性設定為true，并添加監聽事件，回傳一個Unsubscribe函式用于執行銷毀，

綜上，HTML5Backend 在初始化的時候在 window 物件上系結拖拽事件的監聽函式，拖拽事件觸發時執行對應action，更新 store 中的資料，完成由 Dom 事件到資料的轉變，

7、TouchBackend

HTML5 后端不支持觸摸事件，因此它不適用于平板電腦和移動設備，可以使用react-dnd-touch-backend來支持觸摸設備，簡單看下ToucheBackend，

ToucheBackend主要是為了支持移動端，也支持web端，在web端可以使用 mousedown、mousemove、mouseup，在移動端則使用 touchstart、touchmove、touchend，下面是ToucheBackend中對事件的定義：

const eventNames: Record<ListenerType, EventName> = {
  [ListenerType.mouse]: {
    start: 'mousedown',
    move: 'mousemove',
    end: 'mouseup',
    contextmenu: 'contextmenu',
  },
  [ListenerType.touch]: {
    start: 'touchstart',
    move: 'touchmove',
    end: 'touchend',
  },
  [ListenerType.keyboard]: {
    keydown: 'keydown',
  },
}

8、主要拖拽程序

file

四、總結

React-DnD 采用了分層設計，react-dnd充當接入層，dnd-core實作拖拽介面、定義拖拽行為、管理資料流向，backend將DOM事件通過redux action轉換為資料，

使用可插入的方式引入backend，使拖拽的實作可擴展且更加靈活，

使用了單向資料流，在拖拽時不用處理中間狀態，不用額外對DOM事件進行處理，只需專注于資料的變化，
React-DnD對backend的實作方式、資料的管理方式，以及整體的設計都值得借鑒，

五、參考鏈接：

https://github.com/react-dnd/react-dnd/
https://react-dnd.github.io/react-dnd
https://developer.mozilla.org/zh-CN/docs/Web/API/HTML_Drag_and_Drop_API
https://zhuanlan.zhihu.com/p/429986799
https://juejin.cn/post/6885511137236877325

最后

歡迎關注【袋鼠云數堆疊UED團隊】~
袋鼠云數堆疊UED團隊持續為廣大開發者分享技術成果，相繼參與開源了歡迎star

大資料分布式任務調度系統——Taier
輕量級的 Web IDE UI 框架——Molecule
針對大資料領域的 SQL Parser 專案——dt-sql-parser
袋鼠云數堆疊前端團隊代碼評審工程實踐檔案——code-review-practices
一個速度更快、配置更靈活、使用更簡單的模塊打包器——ko

轉載請註明出處，本文鏈接：https://www.uj5u.com/qiye/554817.html

標籤：其他

上一篇：前端常見的字符編碼方案

下一篇：返回列表

深入決議React DnD拖拽原理，輕松掌握拖放技巧！

一、背景

1、業務背景

2、React DnD 介紹

二、使用方式

1、安裝

2、DndProvider

3、useDrag和useDrop

三、原理決議

1、總體架構

2、DndProvider

3、DragDropManager

4、useDrag

5、useDrop

6、HTML5Backend

7、TouchBackend

8、主要拖拽程序

四、總結

五、參考鏈接：

最后