DropTargetMonitor
DropTargetMonitor
是传递给DropTarget
放置目标的对象。它提供了一些方法,让你可以获取到有关放置目标的一些状态信息。绑定到该监视器的特定放置目标在下面称为监视器的所有者。
方法
方法名 | 类型 | 说明 |
---|---|---|
canDrop() | () => boolean | 如果有正在进行的拖动操作,并且所有者useDrop 的canDrop() 方法返回true 或者undefined ,则返回true ,否则返回false 。 |
isOver() | (options?: { shallow: boolean }) => boolean | 如果有正在进行的拖动操作,并且指针当前悬停在所有者的上方,则返回true。你可以选择通过{shallow: true} 来严格检查是否只有所有者被悬浮,而不是嵌套的目标。 |
getItemType() | () => (string | null) | 返回标识当前拖动项的类型type 。如果没有项目被拖动,则返回null 。 |
getItem() | () => (object | null) | 返回表示当前拖动项的普通对象。每个拖动源必须通过从其item 属性来指定它。如果没有项目被拖动,则返回null 。 |
getDropResult() | () => (object | null) | 返回一个表示最后记录的放置结果的普通对象。 放置目标可以通过从它们的 drop() 方法返回一个对象来指定它。当放置目标为嵌套目标时,任何显式地从 drop() 返回自己的结果的父对象都会覆盖之前由子对象设置的drop 结果。它只能在 drop() 内部调用,如果在drop() 外部调用,则返回null 。 |
didDrop() | () => boolean | 如果某个拖放目标已经处理了拖放事件则返回true ,否则返回false 。即使目标没有返回放置结果,didDrop() 也会返回true 。可以在 drop() 中使用它来检查是否有放置目标已经处理了这次拖拽。如果在drop() 外部调用,则返回false 。 |
getInitialClientOffset() | () => { x: number, y: number } | 返回当前拖动开始时鼠标指针相对于客户端的初始位置{x, y} 。如果没有项目被拖动,则返回null。 |
getInitialSourceClientOffset() | () => { x: number, y: number } | 返回当前拖动开始时,拖动源的根DOM节点相对于客户端的初始位置{x, y} 。如果没有项目被拖动,则返回null。 |
getClientOffset() | () => { x: number, y: number } | 返回当前拖动中鼠标指针相对于客户端的偏移量{x, y} 。如果没有项目被拖动,则返回null。 |
getDifferenceFromInitialOffset() | () => { x: number, y: number } | 返回当前拖动中鼠标指针相对于开始拖动时的鼠标指针位置的偏移量{x, y} 。如果没有项目被拖动,则返回null。 |
getSourceClientOffset() | () => { x: number, y: number } | 返回当前拖动源的根DOM节点相对于客户端的偏移量{x, y} 。如果没有项目被拖动,则返回null。 |