Class EdgeHandler

Graph event handler that reconnects edges, modifies control points and the edge label location.

Uses CellMarker for finding and highlighting new source and target vertices.

This handler is automatically created in Graph.createHandler for each selected edge.

Some elements of this handler and its subclasses can be configured using EdgeHandlerConfig.

Hierarchy (View Summary)

Constructors

constructor

Properties

abspoints active allowHandleBoundsCheck bends cloneEnabled constraintHandler currentPoint customHandles dblClickRemoveEnabled error escapeHandler graph handleImage index isLabel isSource isTarget label labelHandleImage labelShape manageLabelHandle marker mergeRemoveEnabled outline outlineConnect parentHighlight parentHighlightEnabled points preferHtml shape snapPoint snapToTerminals startX startY state straightRemoveEnabled tolerance virtualBends

Methods

addPoint addPointAt changePoints changeTerminalPoint checkLabelHandle clonePreviewState connect convertPoint createBends createCustomHandles createHandleShape createLabelHandleShape createMarker createParentHighlightShape createSelectionShape createVirtualBends destroyBends drawPreview getCellAt getHandleFillColor getHandleForEvent getPointForEvent getPreviewPoints getPreviewTerminalState getSelectionColor getSelectionPoints getSelectionStrokeWidth getSnapToTerminalTolerance initBend isAddPointEvent isAddVirtualBendEvent isCellEnabled isConnectableCell isCustomHandleEvent isCustomHandleVisible isDestroyed isHandleEnabled isHandleVisible isOutlineConnectEvent isParentHighlightVisible isRemovePointEvent isSelectionDashed isSnapToTerminalsEvent isVirtualBendsEnabled mouseDown mouseMove mouseUp moveLabel onDestroy redraw redrawHandles redrawInnerBends refresh removeHint removePoint reset roundLength setHandlesVisible setPreviewColor start updateHint updateParentHighlight updatePreviewState validateConnection

Constructors

constructor

Properties

abspoints

abspoints: (null | Point)[] = []

active

active: boolean = true

allowHandleBoundsCheck

allowHandleBoundsCheck: boolean = true

Specifies if the bounds of handles should be used for hit-detection in IE.

Default

true

bends

bends: Shape[] = []

Holds the Shapes that represent the points.

cloneEnabled

cloneEnabled: boolean = true

Specifies if cloning by control-drag is enabled.

Default

true

constraintHandler

constraintHandler: ConstraintHandler

Holds the ConstraintHandler used for drawing and highlighting constraints.

currentPoint

currentPoint: null | Point = null

customHandles

customHandles: undefined | CellHandle[]

dblClickRemoveEnabled

dblClickRemoveEnabled: boolean = false

Specifies if removing bends by double click is enabled.

Default

false

error

error: null | string = null

Holds the current validation error while a connection is being changed.

escapeHandler

escapeHandler: (sender: Listenable, evt: Event) => void

graph

graph: Graph

Reference to the enclosing Graph.

handleImage

handleImage: null | ImageBox = null

Optional Image to be used as handles.

Default

null

index

index: null | number = null

isLabel

isLabel: boolean = false

isSource

isSource: boolean = false

isTarget

isTarget: boolean = false

label

label: Point

labelHandleImage

labelHandleImage: null | ImageBox = null

labelShape

labelShape: Shape

Holds the Shape that represents the label position.

manageLabelHandle

manageLabelHandle: boolean = false

Specifies if the label handle should be moved if it intersects with another handle. Uses checkLabelHandle for checking and moving.

Default

false

marker

marker: CellMarker

Holds the CellMarker which is used for highlighting terminals.

mergeRemoveEnabled

mergeRemoveEnabled: boolean = false

Specifies if removing bends by dropping them on other bends is enabled.

Default

false

outline

outline: boolean = true

outlineConnect

outlineConnect: boolean = false

Specifies if connections to the outline of a highlighted target should be enabled. This will allow to place the connection point along the outline of the highlighted target.

Default

false

parentHighlight

parentHighlight: null | RectangleShape = null

parentHighlightEnabled

parentHighlightEnabled: boolean = false

Specifies if the parent should be highlighted if a child cell is selected.

Default

false

points

points: Point[] = []

preferHtml

preferHtml: boolean = false

Specifies if bends should be added to the graph container. This is updated in constructor based on whether the edge or one of its terminals has an HTML label in the container.

shape

shape: Shape

Holds the Shape that represents the preview edge.

snapPoint

snapPoint: null | Point = null

snapToTerminals

snapToTerminals: boolean = false

Specifies if waypoints should snap to the routing centers of terminals.

Default

false

startX

startX: number = 0

startY

startY: number = 0

state

state: CellState

Reference to the CellState being modified.

straightRemoveEnabled

straightRemoveEnabled: boolean = false

Specifies if removing bends by creating straight segments should be enabled. If enabled, this can be overridden by holding down the alt key while moving.

Default

false

tolerance

tolerance: number = 0

Optional tolerance for hit-detection in getHandleForEvent.

Default

0

virtualBends

virtualBends: undefined | Shape[]

Methods

addPoint

addPointAt

changePoints

changeTerminalPoint

checkLabelHandle

clonePreviewState

connect

  • connect(
        edge: Cell,
        terminal: Cell,
        isSource: boolean,
        _isClone: boolean,
        _me: InternalMouseEvent,
    ): Cell

  • Changes the terminal or terminal point of the given edge in the graph model.

    Parameters

    • edge: Cell

      Cell that represents the edge to be reconnected.

    • terminal: Cell

      Cell that represents the new terminal.

    • isSource: boolean

      Boolean indicating if the new terminal is the source or target terminal.

    • _isClone: boolean

      Boolean indicating if the new connection should be a clone of the old edge.

    • _me: InternalMouseEvent

      MouseEvent that contains the mouse up event.

    Returns Cell

convertPoint

  • convertPoint(point: Point, gridEnabled: boolean): Point

  • Converts the given point in-place from screen to unscaled, untranslated graph coordinates and applies the grid. Returns the given, modified point instance.

    Parameters

    • point: Point

      Point to be converted.

    • gridEnabled: boolean

      Boolean that specifies if the grid should be applied.

    Returns Point

createBends

createCustomHandles

createHandleShape

  • createHandleShape(_index?: number): Shape

  • Creates the shape used to display the given bend. Note that the index

    Only images and rectangles should be returned if support for HTML labels with not foreign objects is required.

    Parameters

    • Optional_index: number

    Returns Shape

createLabelHandleShape

createMarker

createParentHighlightShape

createSelectionShape

createVirtualBends

destroyBends

drawPreview

getCellAt

getHandleFillColor

  • getHandleFillColor(index: number): string

  • Returns the fillcolor for the handle at the given index.

    Parameters

    • index: number

    Returns string

getHandleForEvent

getPointForEvent

getPreviewPoints

getPreviewTerminalState

getSelectionColor

getSelectionPoints

getSelectionStrokeWidth

getSnapToTerminalTolerance

  • getSnapToTerminalTolerance(): number

  • Returns the tolerance for the guides. Default value is gridSize * scale / 2.

    Returns number

initBend

  • initBend(bend: Shape, dblClick?: (evt: MouseEvent) => void): void

  • Helper method to initialize the given bend.

    Parameters

    • bend: Shape

      Shape that represents the bend to be initialized.

    • OptionaldblClick: (evt: MouseEvent) => void

      Optional function to be called on double click.

    Returns void

isAddPointEvent

  • isAddPointEvent(evt: MouseEvent): boolean

  • Returns true if the given event is a trigger to add a new Point. This implementation returns true if shift is pressed.

    Parameters

    • evt: MouseEvent

    Returns boolean

isAddVirtualBendEvent

isCellEnabled

  • isCellEnabled(cell: Cell): boolean

  • Returns true if the given cell allows new connections to be created. This implementation always returns true.

    Parameters

    Returns boolean

isConnectableCell

  • isConnectableCell(cell: Cell): boolean

  • Returns true if the given cell is connectable. This is a hook to disable floating connections. This implementation returns true.

    Parameters

    Returns boolean

isCustomHandleEvent

isCustomHandleVisible

isDestroyed

isHandleEnabled

  • isHandleEnabled(index: number): boolean

  • Creates the shape used to display the given bend.

    Parameters

    • index: number

    Returns boolean

isHandleVisible

  • isHandleVisible(index: number): boolean

  • Returns true if the handle at the given index is visible.

    Parameters

    • index: number

    Returns boolean

isOutlineConnectEvent

isParentHighlightVisible

  • isParentHighlightVisible(): null | boolean

  • Returns true if the parent highlight should be visible. This implementation always returns true.

    Returns null | boolean

isRemovePointEvent

  • isRemovePointEvent(evt: MouseEvent): boolean

  • Returns true if the given event is a trigger to remove a point. This implementation returns true if shift is pressed.

    Parameters

    • evt: MouseEvent

    Returns boolean

isSelectionDashed

isSnapToTerminalsEvent

isVirtualBendsEnabled

  • isVirtualBendsEnabled(evt?: Event): undefined | boolean

  • Returns true if virtual bends should be added. This returns true if virtualBendsEnabled is true and the current style allows and renders custom waypoints.

    Parameters

    • Optionalevt: Event

    Returns undefined | boolean

mouseDown

mouseMove

mouseUp

moveLabel

  • moveLabel(edgeState: CellState, x: number, y: number): void

  • Changes the coordinates for the label of the given edge.

    Parameters

    • edgeState: CellState
    • x: number

      Integer that specifies the x-coordinate of the new location.

    • y: number

      Integer that specifies the y-coordinate of the new location.

    Returns void

onDestroy

  • onDestroy(): void

  • Destroys the handler and all its resources and DOM nodes. This does normally not need to be called as handlers are destroyed automatically when the corresponding cell is deselected.

    Returns void

redraw

  • redraw(ignoreHandles?: boolean): void

  • Redraws the preview, and the bends- and label control points.

    Parameters

    • OptionalignoreHandles: boolean

    Returns void

redrawHandles

redrawInnerBends

refresh

removeHint

removePoint

reset

roundLength

  • roundLength(length: number): number

  • Hook for rounding the unscaled width or height. This uses Math.round.

    Parameters

    • length: number

    Returns number

setHandlesVisible

setPreviewColor

  • setPreviewColor(color: string): void

  • Sets the color of the preview to the given value.

    Parameters

    • color: string

    Returns void

start

  • start(x: number, y: number, index: number): void

  • Starts the handling of the mouse gesture.

    Parameters

    • x: number
    • y: number
    • index: number

    Returns void

updateHint

updateParentHighlight

updatePreviewState

validateConnection

  • validateConnection(source: null | Cell, target: null | Cell): null | string

  • Returns the error message or an empty string if the connection for the given source, target pair is not valid. Otherwise, it returns null. This implementation uses Graph#getEdgeValidationError.

    Parameters

    • source: null | Cell

      Cell that represents the source terminal.

    • target: null | Cell

      Cell that represents the target terminal.

    Returns null | string

Settings

Member Visibility

On This Page

Constructors
Properties
Methods
addPointaddPointAtchangePointschangeTerminalPointcheckLabelHandleclonePreviewStateconnectconvertPointcreateBendscreateCustomHandlescreateHandleShapecreateLabelHandleShapecreateMarkercreateParentHighlightShapecreateSelectionShapecreateVirtualBendsdestroyBendsdrawPreviewgetCellAtgetHandleFillColorgetHandleForEventgetPointForEventgetPreviewPointsgetPreviewTerminalStategetSelectionColorgetSelectionPointsgetSelectionStrokeWidthgetSnapToTerminalToleranceinitBendisAddPointEventisAddVirtualBendEventisCellEnabledisConnectableCellisCustomHandleEventisCustomHandleVisibleisDestroyedisHandleEnabledisHandleVisibleisOutlineConnectEventisParentHighlightVisibleisRemovePointEventisSelectionDashedisSnapToTerminalsEventisVirtualBendsEnabledmouseDownmouseMovemouseUpmoveLabelonDestroyredrawredrawHandlesredrawInnerBendsrefreshremoveHintremovePointresetroundLengthsetHandlesVisiblesetPreviewColorstartupdateHintupdateParentHighlightupdatePreviewStatevalidateConnection