Class Cell

Cells are the elements of the graph model. They represent the state of the groups, vertices and edges in a graph.

Custom attributes

For custom attributes we recommend using an XML node as the value of a cell. The following code can be used to create a cell with an XML node as the value:

var doc = mxUtils.createXmlDocument();
var node = doc.createElement('MyNode')
node.setAttribute('label', 'MyLabel');
node.setAttribute('attribute1', 'value1');
graph.insertVertex(graph.getDefaultParent(), null, node, 40, 40, 80, 30);

For the label to work, graph.convertValueToString and graph.cellLabelChanged should be overridden as follows:

graph.convertValueToString(cell)
{
  if (mxUtils.isNode(cell.value))
  {
    return cell.getAttribute('label', '')
  }
};

var cellLabelChanged = graph.cellLabelChanged;
graph.cellLabelChanged(cell, newValue, autoSize)
{
  if (mxUtils.isNode(cell.value))
  {
    // Clones the value for correct undo/redo
    var elt = cell.value.cloneNode(true);
    elt.setAttribute('label', newValue);
    newValue = elt;
  }

  cellLabelChanged.apply(this, arguments);
};

Cell

Hierarchy (view full)

Cell
- GraphAbstractHierarchyCell

Implements

IdentityObject

Index

Constructors

constructor

Properties

children collapsed connectable edge edges geometry id invalidating mxTransient onInit overlays parent source style target value vertex visible

Constructors

constructor

new Cell(value?, geometry?, style?): Cell
Parameters
- value: any = null
- geometry: null | Geometry = null
- style: CellStyle = {}
Returns Cell
- Defined in view/cell/Cell.ts:82

Properties

children

children: Cell[] = []

Holds the child cells.

collapsed

collapsed: boolean = false

Specifies whether the cell is collapsed. Default is false.

connectable

connectable: boolean = true

Specifies whether the cell is connectable. Default is true.

edge

edge: boolean = false

Specifies whether the cell is an edge. Default is false.

edges

edges: Cell[] = []

Holds the edges.

geometry

geometry: null | Geometry = null

Holds the Geometry. Default is null.

id

id: null | string = null

Holds the Id. Default is null.

invalidating

invalidating: boolean = false

mxTransient

mxTransient: string[] = ...

List of members that should not be cloned inside . This field is passed to Utils#clone and is not made persistent in . This is not a convention for all classes, it is only used in this class to mark transient fields since transient modifiers are not supported by the language.

onInit

onInit: null | (() => void) = null

overlays

overlays: CellOverlay[] = []

parent

parent: null | Cell = null

Reference to the parent cell.

source

source: null | Cell = null

Reference to the source terminal.

style

style: CellStyle = {}

Holds the style as a string of the form [(stylename|key=value);]. Default is null.

target

target: null | Cell = null

Reference to the target terminal.

value

value: any = null

Holds the user object. Default is null.

vertex

vertex: boolean = false

Specifies whether the cell is a vertex. Default is false.

visible

visible: boolean = true

Specifies whether the cell is visible. Default is true.

Methods

clone

clone(): Cell
Returns a clone of the cell.

Uses cloneValue to clone the user object.

All fields in mxTransient are ignored during the cloning.

Returns Cell
- Defined in view/cell/Cell.ts:622

cloneValue

cloneValue(): any
Returns a clone of the cell's user object.

Returns any
- Defined in view/cell/Cell.ts:631

filterDescendants

filterDescendants(filter): Cell[]
Visits all cells recursively and applies the specified filter function to each cell. If the function returns true then the cell is added to the resulting array. The parent and result paramters are optional. If parent is not specified then the recursion starts at root.

Example: The following example extracts all vertices from a given model:
```
var filter(cell)
{
	return model.isVertex(cell);
}
var vertices = model.filterDescendants(filter);
```
Parameters
- filter: null | FilterFunction
  JavaScript function that takes an Cell as an argument and returns a boolean.
Returns Cell[]
- Defined in view/cell/Cell.ts:865

getAttribute

getAttribute(name, defaultValue?): any
Returns the specified attribute from the user object if it is an XML node.
Parameters
- name: string
  Name of the attribute whose value should be returned.
- OptionaldefaultValue: any
  Optional default value to use if the attribute has no value.
Returns any
- Defined in view/cell/Cell.ts:591

getChildAt

getChildAt(index): Cell
Returns the child at the specified index.
Parameters
- index: number
Returns Cell
- Defined in view/cell/Cell.ts:424

getChildCells

getChildCells(vertices?, edges?): Cell[]
Returns the children of the given cell that are vertices and/or edges depending on the arguments.
Parameters
- vertices: boolean = false
  Boolean indicating if child vertices should be returned. Default is false.
- edges: boolean = false
  Boolean indicating if child edges should be returned. Default is false.
Returns Cell[]
- Defined in view/cell/Cell.ts:719

getChildCount

getChildCount(): number
Returns the number of child cells.

Returns number
- Defined in view/cell/Cell.ts:405

getChildEdges

getChildEdges(): Cell[]
Returns the child edges of the given parent.

Returns Cell[]
- Defined in view/cell/Cell.ts:706

getChildren

getChildren(): Cell[]
Returns Cell[]
- Defined in view/cell/Cell.ts:96

getChildVertices

getChildVertices(): Cell[]
Returns the child vertices of the given parent.

Returns Cell[]
- Defined in view/cell/Cell.ts:699

getClonedStyle

getClonedStyle(): CellStyle
Use this method to get the style object to later update it and propagate changes to the view.

See GraphDataModel.setStyle for more details.

Returns CellStyle
- Defined in view/cell/Cell.ts:267

getConnections

getConnections(): Cell[]
Returns all edges of the given cell without loops.

Returns Cell[]
- Defined in view/cell/Cell.ts:763

getDescendants

getDescendants(): Cell[]
Returns all descendants of the given cell and the cell itself in an array.

Returns Cell[]
- Defined in view/cell/Cell.ts:842

getDirectedEdgeCount

getDirectedEdgeCount(outgoing, ignoredEdge?): number
Returns the number of incoming or outgoing edges, ignoring the given edge.
Parameters
- outgoing: boolean
  Boolean that specifies if the number of outgoing or incoming edges should be returned.
- ignoredEdge: null | Cell = null
  that represents an edge to be ignored.
Returns number
- Defined in view/cell/Cell.ts:746

getEdgeAt

getEdgeAt(index): Cell
Returns the edge at the specified index in .
Parameters
- index: number
Returns Cell
- Defined in view/cell/Cell.ts:508

getEdgeCount

getEdgeCount(): number
Returns the number of edges in the edge array.

Returns number
- Defined in view/cell/Cell.ts:490

getEdgeIndex

getEdgeIndex(edge): number
Returns the index of the specified edge in .
Parameters
- edge: Cell
Returns number
- Defined in view/cell/Cell.ts:499

getEdges

getEdges(incoming?, outgoing?, includeLoops?): Cell[]
Returns all distinct edges connected to this cell as a new array of Cell. If at least one of incoming or outgoing is true, then loops are ignored, otherwise if both are false, then all edges connected to the given cell are returned including loops.
Parameters
- incoming: boolean = true
  Optional boolean that specifies if incoming edges should be returned. Default is true.
- outgoing: boolean = true
  Optional boolean that specifies if outgoing edges should be returned. Default is true.
- includeLoops: boolean = true
  Optional boolean that specifies if loops should be returned. Default is true.
Returns Cell[]
- Defined in view/cell/Cell.ts:794

getGeometry

getGeometry(): null | Geometry
Returns the Geometry that describes the .

Returns null | Geometry
- Defined in view/cell/Cell.ts:242

getId

getId(): null | string
Returns the Id of the cell as a string.

Returns null | string
- Defined in view/cell/Cell.ts:200

getIncomingEdges

getIncomingEdges(): Cell[]
Returns the incoming edges of the given cell without loops.

Returns Cell[]
- Defined in view/cell/Cell.ts:770

getIndex

getIndex(child): number
Returns the index of the specified child in the child array.
Parameters
- child: null | Cell
  Child whose index should be returned.
Returns number
- Defined in view/cell/Cell.ts:414

getNearestCommonAncestor

getNearestCommonAncestor(cell2): null | Cell
Returns the nearest common ancestor for the specified cells to this.
Parameters
- cell2: Cell
  that specifies the second cell in the tree.
Returns null | Cell
- Defined in view/cell/Cell.ts:648

getOrigin

getOrigin(): Point
Returns the absolute, accumulated origin for the children inside the given parent as an Point.

Returns Point
- Defined in view/cell/Cell.ts:819

getOutgoingEdges

getOutgoingEdges(): Cell[]
Returns the outgoing edges of the given cell without loops.

Returns Cell[]
- Defined in view/cell/Cell.ts:777

getParent

getParent(): null | Cell
Returns the cell's parent.

Returns null | Cell
- Defined in view/cell/Cell.ts:363

getRoot

getRoot(): Cell
Returns the root of the model or the topmost parent of the given cell.

Returns Cell
- Defined in view/cell/Cell.ts:888

getStyle

getStyle(): CellStyle
Returns a string that describes the style.

IMPORTANT: if you want to get the style object to later update it and propagate changes to the view, use getClonedStyle instead.

Returns CellStyle
- Defined in view/cell/Cell.ts:258

getTerminal

getTerminal(source?): null | Cell
Returns the source or target terminal.
Parameters
- source: boolean = false
  Boolean that specifies if the source terminal should be returned.
Returns null | Cell
- Defined in view/cell/Cell.ts:382

getValue

getValue(): any
Returns the user object of the cell. The user object is stored in .

Returns any
- Defined in view/cell/Cell.ts:215

hasAttribute

hasAttribute(name): boolean
Returns true if the user object is an XML node that contains the given attribute.
Parameters
- name: string
  Name nameName of the attribute.
Returns boolean
- Defined in view/cell/Cell.ts:573

insert

insert(child, index?): null | Cell
Inserts the specified child into the child array at the specified index and updates the parent reference of the child. If not childIndex is specified then the child is appended to the child array. Returns the inserted child.
Parameters
- child: Cell
- Optionalindex: number
Returns null | Cell
- Defined in view/cell/Cell.ts:438

insertEdge

insertEdge(edge, isOutgoing?): Cell
Inserts the specified edge into the edge array and returns the edge. Will update the respective terminal reference of the edge.
Parameters
- edge: Cell
  to be inserted into the edge array.
- isOutgoing: boolean = false
  Boolean that specifies if the edge is outgoing.
Returns Cell
- Defined in view/cell/Cell.ts:519

isAncestor

isAncestor(child): boolean
Returns true if the given parent is an ancestor of the given child. Note returns true if child == parent.
Parameters
- child: null | Cell
  that specifies the child.
Returns boolean
- Defined in view/cell/Cell.ts:688

isCollapsed

isCollapsed(): boolean
Returns true if the cell is collapsed.

Returns boolean
- Defined in view/cell/Cell.ts:347

isConnectable

isConnectable(): boolean
Returns true if the cell is connectable.

Returns boolean
- Defined in view/cell/Cell.ts:315

isEdge

isEdge(): boolean
Returns true if the cell is an edge.

Returns boolean
- Defined in view/cell/Cell.ts:298

isVertex

isVertex(): boolean
Returns true if the cell is a vertex.

Returns boolean
- Defined in view/cell/Cell.ts:281

isVisible

isVisible(): boolean
Returns true if the cell is visibile.

Returns boolean
- Defined in view/cell/Cell.ts:331

remove

remove(index): null | Cell
Removes the child at the specified index from the child array and returns the child that was removed. Will remove the parent reference of the child.
Parameters
- index: number
Returns null | Cell
- Defined in view/cell/Cell.ts:463

removeEdge

removeEdge(edge, isOutgoing?): null | Cell
Removes the specified edge from the edge array and returns the edge. Will remove the respective terminal reference from the edge.
Parameters
- edge: null | Cell
- isOutgoing: boolean = false
  Boolean that specifies if the edge is outgoing.
Returns null | Cell
- Defined in view/cell/Cell.ts:541

removeFromParent

removeFromParent(): void
Removes the cell from its parent.

Returns void
- Defined in view/cell/Cell.ts:480

removeFromTerminal

removeFromTerminal(isSource): void
Removes the edge from its source or target terminal.
Parameters
- isSource: boolean
  Boolean that specifies if the edge should be removed from its source or target terminal.
Returns void
- Defined in view/cell/Cell.ts:560

setAttribute

setAttribute(name, value): void
Sets the specified attribute on the user object if it is an XML node.
Parameters
- name: string
  Name of the attribute whose value should be set.
- value: any
  New value of the attribute.
Returns void
- Defined in view/cell/Cell.ts:607

setCollapsed

setCollapsed(collapsed): void
Sets the collapsed state.
Parameters
- collapsed: boolean
  Boolean that specifies the new collapsed state.
Returns void
- Defined in view/cell/Cell.ts:356

setConnectable

setConnectable(connectable): void
Sets the connectable state.
Parameters
- connectable: boolean
  Boolean that specifies the new connectable state.
Returns void
- Defined in view/cell/Cell.ts:324

setEdge

setEdge(edge): void
Specifies if the cell is an edge. This should only be assigned at construction of the cell and not be changed during its lifecycle.
Parameters
- edge: boolean
  Boolean that specifies if the cell is an edge.
Returns void
- Defined in view/cell/Cell.ts:308

setGeometry

setGeometry(geometry): void
Sets the Geometry to be used as the .
Parameters
- geometry: null | Geometry
Returns void
- Defined in view/cell/Cell.ts:249

setId

setId(id): void
Sets the Id of the cell to the given string.
Parameters
- id: string
Returns void
- Defined in view/cell/Cell.ts:207

setParent

setParent(parent): void
Sets the parent cell.
Parameters
- parent: null | Cell
Returns void
- Defined in view/cell/Cell.ts:372

setStyle

setStyle(style): void
Sets the string to be used as the style.
Parameters
- style: CellStyle
Returns void
- Defined in view/cell/Cell.ts:274

setTerminal

setTerminal(terminal, isSource): null | Cell
Sets the source or target terminal and returns the new terminal.
Parameters
- terminal: null | Cell
  Cell that represents the new source or target terminal.
- isSource: boolean
  boolean that specifies if the source or target terminal should be set.
Returns null | Cell
- Defined in view/cell/Cell.ts:392

setValue

setValue(value): void
Sets the user object of the cell. The user object is stored in .
Parameters
- value: any
Returns void
- Defined in view/cell/Cell.ts:223

setVertex

setVertex(vertex): void
Specifies if the cell is a vertex. This should only be assigned at construction of the cell and not be changed during its lifecycle.
Parameters
- vertex: boolean
  Boolean that specifies if the cell is a vertex.
Returns void
- Defined in view/cell/Cell.ts:291

setVisible

setVisible(visible): void
Specifies if the cell is visible.
Parameters
- visible: boolean
  Boolean that specifies the new visible state.
Returns void
- Defined in view/cell/Cell.ts:340

valueChanged

valueChanged(newValue): any
Changes the user object after an in-place edit and returns the previous value. This implementation replaces the user object with the given value and returns the old user object.
Parameters
- newValue: any
Returns any
- Defined in view/cell/Cell.ts:233

Class Cell

Custom attributes

Hierarchy (view full)

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns Cell

Properties

children

collapsed

connectable

edge

edges

geometry

id

invalidating

mxTransient

onInit

overlays

parent

source

style

target

value

vertex

visible

Methods

clone

Returns Cell

cloneValue

Returns any

filterDescendants

Parameters

Returns Cell[]

getAttribute

Parameters

Returns any

getChildAt

Parameters

Returns Cell

getChildCells

Parameters

Returns Cell[]

getChildCount

Returns number

getChildEdges

Returns Cell[]

getChildren

Returns Cell[]

getChildVertices

Returns Cell[]

getClonedStyle

Returns CellStyle

getConnections

Returns Cell[]

getDescendants

Returns Cell[]

getDirectedEdgeCount

Parameters

Returns number

getEdgeAt

Parameters

Returns Cell

getEdgeCount

Returns number

getEdgeIndex

Parameters

Returns number

getEdges

Parameters

Returns Cell[]

getGeometry

Returns null | Geometry

getId

Returns null | string