Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface IDragEvent

A custom event type used for drag-drop operations.

Notes

In order to receive 'lm-dragover', 'lm-dragleave', or 'lm-drop' events, a drop target must cancel the 'lm-dragenter' event by calling the event's preventDefault() method.

This interface will be deprecated in @lumino/dragdrop@^2.0.0 in favor of Drag.Event.

Hierarchy

  • MouseEvent
    • IDragEvent

Index

Properties

AT_TARGET

AT_TARGET: number

BUBBLING_PHASE

BUBBLING_PHASE: number

CAPTURING_PHASE

CAPTURING_PHASE: number

MouseEvent

MouseEvent: object

Type declaration

NONE

NONE: number

altKey

altKey: boolean

bubbles

bubbles: boolean

Returns true or false depending on how event was initialized. True if event goes through its target's ancestors in reverse tree order, and false otherwise.

button

button: number

buttons

buttons: number

cancelBubble

cancelBubble: boolean

cancelable

cancelable: boolean

Returns true or false depending on how event was initialized. Its return value does not always carry meaning, but true can indicate that part of the operation during which event was dispatched, can be canceled by invoking the preventDefault() method.

clientX

clientX: number

clientY

clientY: number

composed

composed: boolean

Returns true or false depending on how event was initialized. True if event invokes listeners past a ShadowRoot node that is the root of its target, and false otherwise.

ctrlKey

ctrlKey: boolean

currentTarget

currentTarget: EventTarget | null

Returns the object whose event listener's callback is currently being invoked.

defaultPrevented

defaultPrevented: boolean

Returns true if preventDefault() was invoked successfully to indicate cancelation, and false otherwise.

detail

detail: number

dropAction

dropAction: DropAction

The drop action supported or taken by the drop target.

Notes

At the start of each event, this value will be 'none'. During a 'lm-dragover' event, the drop target must set this value to one of the supported actions, or the drop event will not occur.

When handling the drop event, the drop target should set this to the action which was actually taken. This value will be reported back to the drag initiator.

eventPhase

eventPhase: number

Returns the event's phase, which is one of NONE, CAPTURING_PHASE, AT_TARGET, and BUBBLING_PHASE.

isTrusted

isTrusted: boolean

Returns true if event was dispatched by the user agent, and false otherwise.

metaKey

metaKey: boolean

mimeData

mimeData: MimeData

The mime data associated with the event.

Notes

This is mime data provided by the drag initiator. Drop targets should use this data to determine if they can handle the drop.

movementX

movementX: number

movementY

movementY: number

offsetX

offsetX: number

offsetY

offsetY: number

pageX

pageX: number

pageY

pageY: number

proposedAction

proposedAction: DropAction

The drop action proposed by the drag initiator.

Notes

This is the action which is preferred by the drag initiator. The drop target is not required to perform this action, but should if it all possible.

relatedTarget

relatedTarget: EventTarget | null

returnValue

returnValue: boolean

screenX

screenX: number

screenY

screenY: number

shiftKey

shiftKey: boolean

source

source: any

The source object of the drag, as provided by the drag initiator.

Notes

For advanced applications, the drag initiator may wish to expose a source object to the drop targets. That will be provided here if given by the drag initiator, otherwise it will be null.

srcElement

srcElement: EventTarget | null
deprecated

supportedActions

supportedActions: SupportedActions

The drop actions supported by the drag initiator.

Notes

If the dropAction is not set to one of the supported actions during the 'lm-dragover' event, the drop event will not occur.

target

target: EventTarget | null

Returns the object to which event is dispatched (its target).

timeStamp

timeStamp: number

Returns the event's timestamp as the number of milliseconds measured relative to the time origin.

type

type: string

Returns the type of event, e.g. "click", "hashchange", or "submit".

view

view: Window | null

which

which: number
deprecated

x

x: number

y

y: number

Methods

composedPath

  • composedPath(): EventTarget[]
  • Returns the invocation target objects of event's path (objects on which listeners will be invoked), except for any nodes in shadow trees of which the shadow root's mode is "closed" that are not reachable from event's currentTarget.

    Returns EventTarget[]

getModifierState

  • getModifierState(keyArg: string): boolean
  • Parameters

    • keyArg: string

    Returns boolean

initEvent

  • initEvent(type: string, bubbles?: undefined | false | true, cancelable?: undefined | false | true): void
  • Parameters

    • type: string
    • Optional bubbles: undefined | false | true
    • Optional cancelable: undefined | false | true

    Returns void

initMouseEvent

  • initMouseEvent(typeArg: string, canBubbleArg: boolean, cancelableArg: boolean, viewArg: Window, detailArg: number, screenXArg: number, screenYArg: number, clientXArg: number, clientYArg: number, ctrlKeyArg: boolean, altKeyArg: boolean, shiftKeyArg: boolean, metaKeyArg: boolean, buttonArg: number, relatedTargetArg: EventTarget | null): void
  • Parameters

    • typeArg: string
    • canBubbleArg: boolean
    • cancelableArg: boolean
    • viewArg: Window
    • detailArg: number
    • screenXArg: number
    • screenYArg: number
    • clientXArg: number
    • clientYArg: number
    • ctrlKeyArg: boolean
    • altKeyArg: boolean
    • shiftKeyArg: boolean
    • metaKeyArg: boolean
    • buttonArg: number
    • relatedTargetArg: EventTarget | null

    Returns void

preventDefault

  • preventDefault(): void
  • If invoked when the cancelable attribute value is true, and while executing a listener for the event with passive set to false, signals to the operation that caused event to be dispatched that it needs to be canceled.

    Returns void

stopImmediatePropagation

  • stopImmediatePropagation(): void
  • Invoking this method prevents event from reaching any registered event listeners after the current one finishes running and, when dispatched in a tree, also prevents event from reaching any other objects.

    Returns void

stopPropagation

  • stopPropagation(): void
  • When dispatched in a tree, invoking this method prevents event from reaching any objects other than the current object.

    Returns void

Generated using TypeDoc