@types/d3-drag

  • Version 2.0.0
  • Published
  • 26 kB
  • 1 dependency
  • MIT license

Install

npm i @types/d3-drag
yarn add @types/d3-drag
pnpm add @types/d3-drag

Overview

TypeScript definitions for D3JS d3-drag module

Index

Functions

function drag

drag: {
<GElement extends Element, Datum>(): DragBehavior<
GElement,
Datum,
Datum | SubjectPosition
>;
<GElement extends Element, Datum, Subject>(): DragBehavior<
GElement,
Datum,
Subject
>;
};
  • Creates a new drag behavior. The returned behavior, drag, is both an object and a function, and is typically applied to selected elements via selection.call.

    Use this signature when using the default subject accessor.

    The first generic refers to the type of element to be dragged. The second generic refers to the type of the datum of the dragged element.

  • Creates a new drag behavior. The returned behavior, drag, is both an object and a function, and is typically applied to selected elements via selection.call.

    Use this signature when using a custom subject accessor.

    The first generic refers to the type of element to be dragged. The second generic refers to the type of the datum of the dragged element. The third generic refers to the type of the drag behavior subject.

function dragDisable

dragDisable: (window: Window) => void;
  • Prevents native drag-and-drop and text selection on the specified window. As an alternative to preventing the default action of mousedown events, this method prevents undesirable default actions following mousedown. In supported browsers, this means capturing dragstart and selectstart events, preventing the associated default actions, and immediately stopping their propagation. In browsers that do not support selection events, the user-select CSS property is set to none on the document element. This method is intended to be called on mousedown, followed by d3.dragEnable on mouseup.

    Parameter window

    The window for which drag should be disabled.

function dragEnable

dragEnable: (window: Window, noClick?: boolean) => void;
  • Allows native drag-and-drop and text selection on the specified window; undoes the effect of d3.dragDisable. This method is intended to be called on mouseup, preceded by d3.dragDisable on mousedown. If noclick is true, this method also temporarily suppresses click events. The suppression of click events expires after a zero-millisecond timeout, such that it only suppress the click event that would immediately follow the current mouseup event, if any.

    Parameter window

    The window for which drag should be (re-)enabled.

    Parameter noClick

    An optional flag. If noclick is true, this method also temporarily suppresses click events.

Interfaces

interface D3DragEvent

interface D3DragEvent<GElement extends DraggedElementBaseType, Datum, Subject> {}
  • D3 Drag event

    The first generic refers to the type of element to be dragged. The second generic refers to the type of the datum of the dragged element. The third generic refers to the type of the drag behavior subject.

property active

active: number;
  • The number of currently active drag gestures (on start and end, not including this one).

    The event.active field is useful for detecting the first start event and the last end event in a sequence of concurrent drag gestures: it is zero when the first drag gesture starts, and zero when the last drag gesture ends.

property dx

dx: number;
  • The change in x-coordinate since the previous drag event.

property dy

dy: number;
  • The change in y-coordinate since the previous drag event.

property identifier

identifier: 'mouse' | number;
  • The string “mouse”, or a numeric touch identifier.

property sourceEvent

sourceEvent: any;
  • The underlying input event, such as mousemove or touchmove.

property subject

subject: Subject;
  • The drag subject, defined by drag.subject.

property target

target: DragBehavior<GElement, Datum, Subject>;
  • The DragBehavior associated with the event

property type

type: 'start' | 'drag' | 'end' | string;
  • The event type for the DragEvent

property x

x: number;
  • The new x-coordinate of the subject, relative to the container

property y

y: number;
  • The new y-coordinate of the subject, relative to the container

method on

on: {
(typenames: string): (this: GElement, event: any, d: Datum) => void;
(typenames: string, listener: null): this;
(
typenames: string,
listener: (this: GElement, event: any, d: Datum) => void
): this;
};
  • Return the first currently-assigned listener matching the specified typenames, if any.

    Equivalent to drag.on, but only applies to the current drag gesture. Before the drag gesture starts, a copy of the current drag event listeners is made. This copy is bound to the current drag gesture and modified by event.on. This is useful for temporary listeners that only receive events for the current drag gesture.

    Parameter typenames

    The typenames is a string containing one or more typename separated by whitespace. Each typename is a type, optionally followed by a period (.) and a name, such as "drag.foo"" and "drag.bar"; the name allows multiple listeners to be registered for the same type. The type must be one of the following: start (after a new pointer becomes active [on mousedown or touchstart]), drag (after an active pointer moves [on mousemove or touchmove], or end (after an active pointer becomes inactive [on mouseup, touchend or touchcancel].)

  • Remove the current event listeners for the specified typenames, if any, return the drag behavior.

    Equivalent to drag.on, but only applies to the current drag gesture. Before the drag gesture starts, a copy of the current drag event listeners is made. This copy is bound to the current drag gesture and modified by event.on. This is useful for temporary listeners that only receive events for the current drag gesture.

    Parameter typenames

    The typenames is a string containing one or more typename separated by whitespace. Each typename is a type, optionally followed by a period (.) and a name, such as "drag.foo"" and "drag.bar"; the name allows multiple listeners to be registered for the same type. The type must be one of the following: start (after a new pointer becomes active [on mousedown or touchstart]), drag (after an active pointer moves [on mousemove or touchmove], or end (after an active pointer becomes inactive [on mouseup, touchend or touchcancel].)

    Parameter listener

    Use null to remove the listener.

  • Set the event listener for the specified typenames and return the drag behavior. If an event listener was already registered for the same type and name, the existing listener is removed before the new listener is added. When a specified event is dispatched, each listener will be invoked with the same context and arguments as selection.on listeners.

    Equivalent to drag.on, but only applies to the current drag gesture. Before the drag gesture starts, a copy of the current drag event listeners is made. This copy is bound to the current drag gesture and modified by event.on. This is useful for temporary listeners that only receive events for the current drag gesture.

    Parameter typenames

    The typenames is a string containing one or more typename separated by whitespace. Each typename is a type, optionally followed by a period (.) and a name, such as "drag.foo"" and "drag.bar"; the name allows multiple listeners to be registered for the same type. The type must be one of the following: start (after a new pointer becomes active [on mousedown or touchstart]), drag (after an active pointer moves [on mousemove or touchmove], or end (after an active pointer becomes inactive [on mouseup, touchend or touchcancel].)

    Parameter listener

    An event listener function which is evaluated for each selected element, in order, being passed the current event (event) and datum d, with the this context as the current DOM element.

interface DragBehavior

interface DragBehavior<GElement extends DraggedElementBaseType, Datum, Subject>
extends Function {}
  • A D3 Drag Behavior

    The first generic refers to the type of element to be dragged. The second generic refers to the type of the datum of the dragged element. The third generic refers to the type of the drag behavior subject.

    The subject of a drag gesture represents the thing being dragged. It is computed when an initiating input event is received, such as a mousedown or touchstart, immediately before the drag gesture starts. The subject is then exposed as event.subject on subsequent drag events for this gesture.

    The default subject is the datum of the element in the originating selection (see drag) that received the initiating input event; if this datum is undefined, an object representing the coordinates of the pointer is created. When dragging circle elements in SVG, the default subject is thus the datum of the circle being dragged. With Canvas, the default subject is the canvas element’s datum (regardless of where on the canvas you click). In this case, a custom subject accessor would be more appropriate, such as one that picks the closest circle to the mouse within a given search radius.

method clickDistance

clickDistance: { (): number; (distance: number): this };
  • Return the current click distance threshold, which defaults to zero.

  • Set the maximum distance that the mouse can move between mousedown and mouseup that will trigger a subsequent click event. If at any point between mousedown and mouseup the mouse is greater than or equal to distance from its position on mousedown, the click event following mouseup will be suppressed.

    Parameter distance

    The distance threshold between mousedown and mouseup measured in client coordinates (event.clientX and event.clientY). The default is zero.

method container

container: {
(): any;
(accessor: any): this;
(container: DragContainerElement): this;
};
  • Returns the current container accessor function.

  • Sets the container accessor to the specified function and returns the drag behavior.

    The container of a drag gesture determines the coordinate system of subsequent drag events, affecting event.x and event.y. The element returned by the container accessor is subsequently passed to d3.pointer to determine the local coordinates of the pointer.

    The default container accessor returns the parent node of the element in the originating selection (see drag) that received the initiating input event. This is often appropriate when dragging SVG or HTML elements, since those elements are typically positioned relative to a parent. For dragging graphical elements with a Canvas, however, you may want to redefine the container as the initiating element itself, using "this" in the accessor function.

    Parameter accessor

    A container accessor function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. The function returns the container element.

  • Sets the container accessor to the specified object and returns the drag behavior.

    The container of a drag gesture determines the coordinate system of subsequent drag events, affecting event.x and event.y. The element returned by the container accessor is subsequently passed to d3.pointer to determine the local coordinates of the pointer.

    The default container accessor returns the parent node of the element in the originating selection (see drag) that received the initiating input event. This is often appropriate when dragging SVG or HTML elements, since those elements are typically positioned relative to a parent. For dragging graphical elements with a Canvas, however, you may want to redefine the container as the initiating element itself, such as drag.container(canvas).

    Parameter container

    Container element for the drag gesture.

method filter

filter: {
(): (this: GElement, event: any, d: Datum) => boolean;
(filterFn: (this: GElement, event: any, d: Datum) => boolean): this;
};
  • Returns the current filter function.

  • Sets the event filter to the specified filter function and returns the drag behavior.

    If the filter returns falsey, the initiating event is ignored and no drag gesture is started. Thus, the filter determines which input events are ignored. The default filter ignores mousedown events on secondary buttons, since those buttons are typically intended for other purposes, such as the context menu.

    Parameter filterFn

    A filter function which is evaluated for each selected element, in order, being passed the current event (event) and datum d, with the this context as the current DOM element. The function returns a boolean value.

method on

on: {
(typenames: string): (this: GElement, event: any, d: Datum) => void;
(typenames: string, listener: null): this;
(
typenames: string,
listener: (this: GElement, event: any, d: Datum) => void
): this;
};
  • Return the first currently-assigned listener matching the specified typenames, if any.

    Parameter typenames

    The typenames is a string containing one or more typename separated by whitespace. Each typename is a type, optionally followed by a period (.) and a name, such as "drag.foo"" and "drag.bar"; the name allows multiple listeners to be registered for the same type. The type must be one of the following: start (after a new pointer becomes active [on mousedown or touchstart]), drag (after an active pointer moves [on mousemove or touchmove], or end (after an active pointer becomes inactive [on mouseup, touchend or touchcancel].)

  • Remove the current event listeners for the specified typenames, if any, return the drag behavior.

    Parameter typenames

    The typenames is a string containing one or more typename separated by whitespace. Each typename is a type, optionally followed by a period (.) and a name, such as "drag.foo"" and "drag.bar"; the name allows multiple listeners to be registered for the same type. The type must be one of the following: start (after a new pointer becomes active [on mousedown or touchstart]), drag (after an active pointer moves [on mousemove or touchmove], or end (after an active pointer becomes inactive [on mouseup, touchend or touchcancel].)

    Parameter listener

    Use null to remove the listener.

  • Set the event listener for the specified typenames and return the drag behavior. If an event listener was already registered for the same type and name, the existing listener is removed before the new listener is added. When a specified event is dispatched, each listener will be invoked with the same context and arguments as selection.on listeners.

    Changes to registered listeners via drag.on during a drag gesture do not affect the current drag gesture. Instead, you must use event.on, which also allows you to register temporary event listeners for the current drag gesture. Separate events are dispatched for each active pointer during a drag gesture. For example, if simultaneously dragging multiple subjects with multiple fingers, a start event is dispatched for each finger, even if both fingers start touching simultaneously.

    Parameter typenames

    The typenames is a string containing one or more typename separated by whitespace. Each typename is a type, optionally followed by a period (.) and a name, such as "drag.foo"" and "drag.bar"; the name allows multiple listeners to be registered for the same type. The type must be one of the following: start (after a new pointer becomes active [on mousedown or touchstart]), drag (after an active pointer moves [on mousemove or touchmove], or end (after an active pointer becomes inactive [on mouseup, touchend or touchcancel].)

    Parameter listener

    An event listener function which is evaluated for each selected element, in order, being passed the current event (event) and datum d, with the this context as the current DOM element.

method subject

subject: {
(): (this: GElement, event: any, d: Datum) => Subject;
(accessor: (this: GElement, event: any, d: Datum) => Subject): this;
};
  • Returns the current subject accessor functions.

  • Sets the subject accessor to the specified function and returns the drag behavior.

    The subject of a drag gesture represents the thing being dragged. It is computed when an initiating input event is received, such as a mousedown or touchstart, immediately before the drag gesture starts. The subject is then exposed as event.subject on subsequent drag events for this gesture.

    The default subject is the datum of the element in the originating selection (see drag) that received the initiating input event; if this datum is undefined, an object representing the coordinates of the pointer is created. When dragging circle elements in SVG, the default subject is thus the datum of the circle being dragged. With Canvas, the default subject is the canvas element’s datum (regardless of where on the canvas you click). In this case, a custom subject accessor would be more appropriate, such as one that picks the closest circle to the mouse within a given search radius.

    The subject of a drag gesture may not be changed after the gesture starts.

    During the evaluation of the subject accessor, event is a beforestart drag event. Use event.sourceEvent to access the initiating input event and event.identifier to access the touch identifier. The event.x and event.y are relative to the container, and are computed using d3.pointer.

    Parameter accessor

    An extent accessor function which is evaluated for each selected element, in order, being passed the current event (event) and datum d, with the this context as the current DOM element. The returned subject should be an object that exposes x and y properties, so that the relative position of the subject and the pointer can be preserved during the drag gesture. If the subject is null or undefined, no drag gesture is started for this pointer; however, other starting touches may yet start drag gestures.

method touchable

touchable: { (): any; (touchable: boolean): this; (touchable: any): this };
  • Returns the current touch support detector, which defaults to a function returning true, if the "ontouchstart" event is supported on the current element.

  • Sets the touch support detector to the specified boolean value and returns the drag behavior.

    Touch event listeners are only registered if the detector returns truthy for the corresponding element when the drag behavior is applied. The default detector works well for most browsers that are capable of touch input, but not all; Chrome’s mobile device emulator, for example, fails detection.

    Parameter touchable

    A boolean value. true when touch event listeners should be applied to the corresponding element, otherwise false.

  • Sets the touch support detector to the specified function and returns the drag behavior.

    Touch event listeners are only registered if the detector returns truthy for the corresponding element when the drag behavior is applied. The default detector works well for most browsers that are capable of touch input, but not all; Chrome’s mobile device emulator, for example, fails detection.

    Parameter touchable

    A touch support detector function, which returns true when touch event listeners should be applied to the corresponding element. The function is evaluated for each selected element to which the drag behavior was applied, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. The function returns a boolean value.

call signature

(selection: Selection<GElement, Datum, any, any>, ...args: any[]): void;
  • Applies the drag behavior to the selected elements. This function is typically not invoked directly, and is instead invoked via selection.call.

    For details see: https://github.com/d3/d3-drag#_drag

    Parameter selection

    A D3 selection of elements.

    Parameter args

    Optional arguments to be passed in.

interface SubjectPosition

interface SubjectPosition {}
  • The subject datum should at a minimum expose x and y properties, so that the relative position of the subject and the pointer can be preserved during the drag gesture.

property x

x: number;
  • x-coordinate

property y

y: number;
  • y-coordinate

Type Aliases

type DragContainerElement

type DragContainerElement = HTMLElement | SVGSVGElement | SVGGElement;
  • Container element type usable for mouse/touch functions

type DraggedElementBaseType

type DraggedElementBaseType = Element;
  • DraggedElementBaseType serves as an alias for the 'minimal' data type which can be selected without 'd3-drag' (and related code in 'd3-selection') trying to use properties internally which would otherwise not be supported.

Package Files (1)

Dependencies (1)

Dev Dependencies (0)

No dev dependencies.

Peer Dependencies (0)

No peer dependencies.

Badge

To add a badge like this onejsDocs.io badgeto your package's README, use the codes available below.

You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/@types/d3-drag.

  • Markdown
    [![jsDocs.io](https://img.shields.io/badge/jsDocs.io-reference-blue)](https://www.jsdocs.io/package/@types/d3-drag)
  • HTML
    <a href="https://www.jsdocs.io/package/@types/d3-drag"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>