Last updated

API / geotoolkit / report / elements / CompositeElement / CompositeElement

Class: CompositeElement

elements.CompositeElement.CompositeElement

Define representation of Composite DOM element

Hierarchy

Implements

Table of contents

Constructors
Methods
addBaseLayeraddChildaddCssClass
addInvalidateHandleraddOverlayadjustPosition
applyOpacityapplyResponsiveStylechangeBaseLayerOrder
changeChildOrderchangeOverlayOrdercheckCollision
clearBaseLayersclearCacheclearChildren
clearOverlayscloneconnectStyle
copyConstructordisconnectStyledispose
drawBorderdropCacheenableClipping
enableEventPropagationenablePickingChildrenenumerateNodes
executeexportToImagefilter
getAnimationStylegetAutoModelLimitsModegetAutoModelLimitsStrategy
getBaseLayergetBaseLayersgetBaseLayersCount
getBoundsgetCachegetChild
getChildrengetChildrenCountgetClassName
getClipStylegetContentElementgetContentOrientation
getContentsAreagetContentsTransformgetCss
getCssClassgetCssClassesgetCssTransform
getDesiredHeightgetDesiredWidthgetDeviceLimits
getDomElementgetElementStylegetElementTransformations
getFillStylegetIdgetInfiniteMode
getInvalidateMethodgetLayoutgetLayoutStyle
getLineStylegetLocalTransformgetMarginsStyle
getModelLimitsgetNamegetOpacity
getOpacityBlendModegetOverlaygetOverlayAt
getOverlaysgetOverlaysCountgetPaddingStyle
getParentgetPreferredElementBoundsgetPreferredSize
getPropertiesgetPropertygetPropertyKeys
getRenderingFiltergetResponsiveStylegetRoot
getScaleScrollStrategygetSceneTransformgetTag
getTextStylegetVisiblegetVisibleDeviceLimits
getVisibleModelLimitsgetWireModegetWorldTransform
getZIndexhasCssClasshasEventListener
indexOfBaseLayerindexOfChildindexOfOverlay
insertBaseLayerinsertChildinsertOverlay
invalidateinvalidateLayoutinvalidateParent
isClippingEnabledisDisposedisEventPropagationEnabled
isHorizontalFlipisLayoutInvalidatedisNotificationEnabled
isPickingChildrenEnabledisSelectableisSilent
isVerticalFlipmoveTonotify
notifyRootoffon
onBoundsChangedonChildAddedonChildRemoved
onDomElementChangedonParentChangedonVisibilityChanged
postRenderingpreRenderingrebuild
rebuildDomLayoutregisterAnimationStyleremoveBaseLayer
removeChildremoveCssClassremoveInvalidateHandler
removeOverlayrenderrenderAsync
renderBackgroundrenderBaseLayersrenderBaseLayersAsync
renderChildrenrenderChildrenAsyncrenderContent
renderContentAsyncrenderOverlaysrenderOverlaysAsync
resumeUpdaterotatescale
setAnimationStylesetAutoModelLimitsModesetAutoModelLimitsStrategy
setBoundssetCachesetChild
setClipStylesetContentOrientationsetCss
setCssClasssetCssTransformsetDesiredHeight
setDesiredWidthsetDomElementsetElementStyle
setFillStylesetHorizontalFlipsetId
setInfiniteModesetLayoutsetLayoutInvalidated
setLayoutStylesetLineStylesetLocalTransform
setMarginsStylesetModelLimitssetName
setNotificationsetOpacitysetPaddingStyle
setPropertiessetPropertysetRenderingFilter
setResponsiveStylesetScaleScrollStrategysetSelectable
setSilentsetTagsetTextStyle
setVerticalFlipsetVisiblesetVisibleModelLimits
setWireModesetZIndexshear
suspendUpdatetoStringtranslate
unregisterAnimationStyleupdateLayoutupdateSceneTransformation
updateStateupdateSuspendedupdateTimeStamp
enableSceneGraphNotificationfindParentgetClassName
isSceneGraphNotificationEnabledrebuildDomLayout
Css Properties
Name Type Description
automodellimitsmodebooleanAuto model limits mode
boundsRectDefine position of the group in the parent
bounds-heightnumberHeight
bounds-readonlybooleanReadonly
bounds-widthnumberWidth
bounds-xnumberLeft
bounds-ynumberTop
clippingbooleanEnable clipping, this does not consider the clipstyle, it is related to bounds-clipping
clipstyleClipStyleClipping style
clipstyle-evenoddbooleanTrue if evenodd mode is on ('nonzero' mode otherwise)
clipstyle-geometryGraphicsPathClipping geometry
clipstyle-geometry-boundsRectBounds
clipstyleGraphicsPathClipping style
contentorientationOrientationContent orientation
cssclassstringThe css class name of this node
csscursorstringCSS cursor associated with node
cssstylestringCSS style to be applied to inserted elements
fillstylestringFill style
fillstyleFillStyleFill style
fillstyle-colorstringColor in CSS form
fillstyle-evenoddmodebooleanEven-odd fill mode
fillstyle-fillpatternPatternPattern
fillstyle-fillpattern-containernamestringAn optional container name, which creates an image pattern. This parameter is used for serialization if you want to save are reference to pattern instead of the pattern itself
fillstyle-fillpattern-patternnamestringName of this pattern for indexing
fillstyle-fillpattern-scalablebooleanFlag that sets scalability of the pattern coordinates, or relative to the shape it is filling (It is not supported)
fillstyle-foregroundstringForeground color
fillstyle-patternPatternPattern
horizontalflipbooleanHorizontal axis goes from right to left
idstring | numberId of the node, its a unique identifier
infinitybooleanMode to render outside the model limits
layoutstyleLayoutStyleLayout style to be used for parent layout
layoutstyle-constraintSizeConstraintLayout constrains
layoutstyle-flexgrownumberNumber specifying how much the item will grow relative to the rest of the items inside the same container
layoutstyle-flexshrinknumberNumber specifying how much the item will shrink relative to the rest of the items inside the same container
layoutstyle-floatstringFloat position
layoutstyle-positionstringLayout position
layoutstyle-sizenumber | stringLayout size
linestylestringLine style
linestyleLineStyleLine style
linestyle-colorstringColor in CSS form
linestyle-fillstringOptional fill style to be used to fill lines generated with this style
linestyle-fillFillStyleOptional fill style to be used to fill lines generated with this style
linestyle-linecapCapStyleThe line cap style
linestyle-linedashoffsetnumberLine dash offset of dashed line
linestyle-linejoinJoinStyleThe line join style
linestyle-pixelsnapmodebooleanPixel Snap Mode, default(
linestyle-scalablebooleanTrue if width should depend on transformation
linestyle-unitstringOptional unit for the width
linestyle-widthnumber | stringThe line thickness
localtransformTransformationLocal transformation
localtransform-dxnumberX axis translation
localtransform-dynumberY axis translation
localtransform-xxnumberX scale
localtransform-xynumberXy skew
localtransform-yxnumberYx skew
localtransform-yynumberY scale
marginsnumber | stringIt has properties for specifying the margins for each side
modellimitsRectDefine inner model coordinates of the group
namestringName of the node. It is often used for debugging purposes or to simplify queries
opacitynumberNode opacity (from 0 to 1). If it is undefined or null it inherits property from the parent. It changes globalAlpha on the rendering context
opacityblendmodeBlendModeNode opacity mode to blend it
paddingnumber | stringIt has properties for specifying the padding for each side
pickingchildrenbooleanEnable picking children
scalescrollstrategyScaleScrollStrategyScale scroll strategy
scalescrollstrategy-enabledbooleanEnable flag
selectablebooleanSelectable node, a boolean to determine if selection should consider this node
taganyCustom information associated with node. It is a user object which can be used by client code to store information or attach an application object to the shape
transformstringAdditional CSS transformation applied to node or 'none'
transformTransformationAdditional CSS transformation applied to node or 'none'
verticalflipbooleanVertical axis goes from bottom to top
viewcachebooleanView cache to cache child nodes
visiblebooleanVisibility of the node, a boolean to determine if the node should be rendered or not
z-indexnumberDefine node z-index

Contents

Constructors

new CompositeElement(options)

new CompositeElement(options?)

Parameters

Name Type Description
Optional optionsElementContent | Optionsoptions object

Overrides

Element.constructor

Methods

addBaseLayer

addBaseLayer(baseLayer): CompositeElement

Add baseLayer to container

Parameters

Name Type Description
baseLayerNode | Node[]baseLayer to be added

Returns

CompositeElement

this

Inherited from

Element.addBaseLayer


addChild

addChild(node): CompositeElement

Add a child node

Parameters

Name Type Description
nodeNode | Iterator<Node> | Node[]the child node to be added

Returns

CompositeElement

this

Inherited from

Element.addChild


addCssClass

addCssClass(cssclass): CompositeElement

Adds new css class to node

Parameters

Name Type Description
cssclassstring | string[]css class name('s)

Returns

CompositeElement

this

Inherited from

Element.addCssClass


addInvalidateHandler

addInvalidateHandler(handler): CompositeElement

Add invalidate handler

Deprecated

since 4.0, use Node.on instead

Parameters

Name Type Description
handlerFunctionhandler to be notified about invalidation

Returns

CompositeElement

this

Inherited from

Element.addInvalidateHandler


addOverlay

addOverlay(overlay): CompositeElement

Add overlay to container

Parameters

Name Type Description
overlayNode | Node[]overlay to be added

Returns

CompositeElement

this

Inherited from

Element.addOverlay


adjustPosition

adjustPosition(area?, vAlign?, hAlign?): CompositeElement

Adjust position of node to specified area

Parameters

Name Type Description
Optional areaRectspecified area. Default to Parent Model Limits
Optional vAlignstringvertical alignment. It can be "top", "bottom", "center". Defaults to "top".
Optional hAlignstringhorizontal alignment It can be "left", "right", "center". Defaults to "left".

Returns

CompositeElement

this

Inherited from

Element.adjustPosition


applyOpacity

Protected applyOpacity(context): CompositeElement

This method is called to apply opacity if it is specified on the rendering context. The default implementation sets global alpha on the rendering context

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

CompositeElement

this

Inherited from

Element.applyOpacity


applyResponsiveStyle

Protected applyResponsiveStyle(): void

Apply a responsive style rules it is exists

Returns

void

Inherited from

Element.applyResponsiveStyle


changeBaseLayerOrder

changeBaseLayerOrder(overlay, order, anchor?): CompositeElement

Changes the z-order of the baseLayer.

Parameters

Name Type Description
overlayNode
orderNodeOrderposition to be added
Optional anchorNodeanchor node to specify changeOrder with respect to this node

Returns

CompositeElement

this

Inherited from

Element.changeBaseLayerOrder


changeChildOrder

changeChildOrder(node, order, anchor?): CompositeElement

changes the z-order of the nodes being rendered.

Parameters

Name Type Description
nodeNodeany child added in the Composite node
orderNodeOrderposition to be added
Optional anchorNodeanchor node to specify changeOrder with respect to this node

Returns

CompositeElement

this

Inherited from

Element.changeChildOrder


changeOverlayOrder

changeOverlayOrder(overlay, order, anchor?): CompositeElement

Changes the z-order of the overlay.

Parameters

Name Type Description
overlayNodechild overlay
orderNodeOrderposition to be added
Optional anchorNodeanchor node to specify changeOrder with respect to this node

Returns

CompositeElement

this

Inherited from

Element.changeOverlayOrder


checkCollision

checkCollision(context): boolean

Check culling Returns true if object is inside of renderable area

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

boolean

true if node is collided

Inherited from

Element.checkCollision


clearBaseLayers

clearBaseLayers(disposeBaseLayers?): CompositeElement

Remove all child baseLayers from group

Parameters

Name Type Description
Optional disposeBaseLayersbooleanautomatically dispose baseLayers. If it is true then method dispose is called for each baseLayer, false by default

Returns

CompositeElement

this

Inherited from

Element.clearBaseLayers


clearCache

clearCache(): CompositeElement

Clear cache

Returns

CompositeElement

this

Inherited from

Element.clearCache


clearChildren

clearChildren(disposeChildren?): CompositeElement

Remove all child nodes from this composite group

Parameters

Name Type Description
Optional disposeChildrenbooleanautomatically dispose children. If it is true then method dispose is called for each child.

Returns

CompositeElement

this

Inherited from

Element.clearChildren


clearOverlays

clearOverlays(disposeOverlays?): CompositeElement

Remove all child overlays from group

Parameters

Name Type Description
Optional disposeOverlaysbooleanautomatically dispose overlays. If it is true then method dispose is called for each overlay, false by default

Returns

CompositeElement

this

Inherited from

Element.clearOverlays


clone

clone(): CompositeElement

All subclasses should override copyConstructor or provide custom implementation for this method

Returns

CompositeElement

clone

Overrides

Element.clone


connectStyle

connectStyle(style, type, callback): CompositeElement

Connects style.

This convenience method subscribes a listener to given style for the specified type.
And automatically un-subscribes listener if node is disposed to prevent memory leaks

Parameters

Name Type Description
styleEventDispatcherconnect style
typestringtype of event or property
callbackAttributeCallback<EventDispatcher>function to be called

Returns

CompositeElement

this

Inherited from

Element.connectStyle


copyConstructor

Protected copyConstructor(src, deepCopy?): CompositeElement

Copy constructor function.
Function used as part of the cloning mechanism.
Implementations should copy the given instance state to this instance.

Parameters

Name Type Description
srcCompositeElementSource to copy from
Optional deepCopybooleandeep copy

Returns

CompositeElement

this

Overrides

Element.copyConstructor


disconnectStyle

disconnectStyle(style, type, callback): CompositeElement

Disconnect style
This convenience method un-subscribes a listener to given style for the specified type.

Parameters

Name Type Description
styleEventDispatcherconnect style
typestringtype of event or property
callbackAttributeCallback<EventDispatcher>function to be called

Returns

CompositeElement

this

Inherited from

Element.disconnectStyle


dispose

dispose(): void

Dispose node. Clear all listeners and disconnect style to avoid memory leaks

Returns

void

Inherited from

Element.dispose


drawBorder

Protected drawBorder(localContext, bounds?): CompositeElement

Draws a rectangle at the bounding box (in parent coordinates)

Parameters

Name Type Description
localContextRenderingContextThe local rendering context
Optional boundsRectgroup bounds

Returns

CompositeElement

this

Inherited from

Element.drawBorder


dropCache

dropCache(): CompositeElement

Rebuild layout

Returns

CompositeElement

Inherited from

Element.dropCache


enableClipping

enableClipping(doClip): CompositeElement

Enables or disables clipping of this node. If enabled, shapes will not be rendered outside of its bounds.

Parameters

Name Type Description
doClipbooleanenable clipping on this node

Returns

CompositeElement

this

Inherited from

Element.enableClipping


enableEventPropagation

enableEventPropagation(enable): CompositeElement

Enable event propagation from the node hierarchy from bottom to top

This option is similar to DOM Event bubbling, which allows to get any event from child node. By default it is disabled for better performance.

Example

import {Group} from '@int/geotoolkit/scene/Group';
import {Events as SceneEvents} from '@int/geotoolkit/scene/Node';
const parentGroup = new Group()
.setName('ParentGroup')
.enableEventPropagation(true);
const childGroup = new Group()
.setName('ChildGroup');

parentGroup.addChild(childGroup);
parentGroup.on(SceneEvents.Invalidate, (eventName, sender, args) => {
// Got notifications from all children of parent group
});
childGroup.invalidate();

Parameters

Name Type Description
enablebooleanenable

Returns

CompositeElement

this

Inherited from

Element.enableEventPropagation


enablePickingChildren

enablePickingChildren(enable): CompositeElement

Enables or disables picking children

Parameters

Name Type Description
enablebooleanenable picking children

Returns

CompositeElement

this

Inherited from

Element.enablePickingChildren


enumerateNodes

enumerateNodes(callback, target?): void

Executes a provided function once for each child node

Parameters

Name Type Description
callbackCallback<Node>provided function
Optional targetQueryBuilder<any>target to pass to callback as a second parameter

Returns

void

Inherited from

Element.enumerateNodes


execute

execute(delegate): CompositeElement

Executes delegate and return the result. It allows us to keep all initialization calls in one place,
and we do not need to scroll up or down in IDE to find how and where it was initialized.

Example

// All setters (.setName() for example) returns reference to the this.
// In order to modify inner object like LineStyle or Pattern, to get this object (property) we should call getter to get object reference.
// Then modify it as shown below in Option 1 or you can use execute methods shown in Option 2.
import {Group} from '@int/geotoolkit/scene/Group';
import {Rect} from '@int/geotoolkit/util/Rect';
// Option 1
const group = new Group()
.setName('MyGroup')
.setBounds(new Rect(0, 0, 42, 16))
.enableClipping(true)
.setTag({'type': 'sometype'});

group.getLineStyle().setPattern('pattern');
return group;

// Options 2 ( using execute method )
return group
.execute(function () {
this.getLineStyle()
.setPattern("pattern");
});

Parameters

Name Type Description
delegate(this: CompositeElement) => voidFunction to execute

Returns

CompositeElement

The result if any or this

Inherited from

Element.execute

execute<T>(delegate): T

Type parameters

Name
T

Parameters

Name Type
delegate(this: CompositeElement) => T

Returns

T

Inherited from

Element.execute


exportToImage

exportToImage(showWireBorder?): Image

Export element to image (without rotation)

Parameters

Name Type Description
Optional showWireBorderbooleanshow wire border

Returns

Image

image

Inherited from

Element.exportToImage


filter

Protected filter(context): boolean

Filter node

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

boolean

flag filter flag ("true" to render node; "false" otherwise)

Inherited from

Element.filter


getAnimationStyle

getAnimationStyle(): AnimationStyle

Return animation style

Returns

AnimationStyle

animationStyle current animation style

Inherited from

Element.getAnimationStyle


getAutoModelLimitsMode

getAutoModelLimitsMode(): boolean

Get Model Limits Logics to use when no Model Limits have been set set to true: will use parents width and height, starting at 0 set to false: will use parents bounds

Returns

boolean

mode

Inherited from

Element.getAutoModelLimitsMode


getAutoModelLimitsStrategy

getAutoModelLimitsStrategy(): ModelLimitsStrategy

Get Model Limits Logics Strategy

Returns

ModelLimitsStrategy

strategy

Inherited from

Element.getAutoModelLimitsStrategy


getBaseLayer

getBaseLayer(index): Node

Return baseLayer at specified index

Parameters

Name Type Description
indexnumberindex at which to get the baseLayer for

Returns

Node

track

Inherited from

Element.getBaseLayer


getBaseLayers

getBaseLayers<S>(predicate, modify?): Iterator<Node>

Return iterator by baseLayers nodes

Type parameters

NameType
Sextends Node<S>

Parameters

Name Type Description
predicate(value: Node) => value is Sa filter function
Optional modifybooleanAn option to specify if the iterator supports adding/removing items from the collection. false by default.

Returns

Iterator<Node>

Inherited from

Element.getBaseLayers

getBaseLayers(filter?, modify?): Iterator<Node>

Returns an iterator for child baseLayers. The iterator does not support adding or deleting items from overlays by default. If it is necessary to modify a collection of overlays, pass true as the last parameter.

Example

// Gets a writable iterator
const it = node.getOverlays(null, true);

Parameters

Name Type Description
Optional filter(node: Node) => booleanA filter function. Returns all overlays if null.
Optional modifybooleanAn option to specify if the iterator supports adding/removing items from the collection. false by default.

Returns

Iterator<Node>

An iterator for child overlays.

Inherited from

Element.getBaseLayers


getBaseLayersCount

getBaseLayersCount(): number

Returns amount of baseLayers

Returns

number

Inherited from

Element.getBaseLayersCount


getBounds

getBounds(): Rect

Get the bounds in the parents model space. If bounds are not set, then parent model limits are used.

Returns

Rect

current bounds

Inherited from

Element.getBounds


getCache

getCache(): Cache

Return cache strategy to be used to cache children nodes

Returns

Cache

cache

Inherited from

Element.getCache


getChild

getChild(i): Node

Return node by index

Parameters

Name Type Description
inumberindex of the node

Returns

Node

Inherited from

Element.getChild


getChildren

getChildren<S>(predicate, modify?): Iterator<S>

Return iterator by child nodes

Type parameters

NameType
Sextends Node<S>

Parameters

Name Type Description
predicate(value: Node) => value is Sa filter function
Optional modifybooleanAn option to specify if the iterator supports adding/removing items from the collection. false by default.

Returns

Iterator<S>

Inherited from

Element.getChildren

getChildren(filter?, modify?): Iterator<Node>

Returns an iterator for child nodes. The iterator does not support adding or deleting items from children by default. If it is necessary to modify a collection of children, pass true as the last parameter.

Example

// Gets a writable iterator
const it = node.getChildren(null, true);

Parameters

Name Type Description
Optional filter(node: Node) => booleanA filter function. Returns all nodes if null.
Optional modifybooleanAn option to specify if the iterator supports adding/removing items from the collection. false by default.

Returns

Iterator<Node>

An iterator for child nodes.

Inherited from

Element.getChildren


getChildrenCount

getChildrenCount(): number

Return number of child nodes

Returns

number

Inherited from

Element.getChildrenCount


getClassName

getClassName(): string

Returns

string

Inherited from

Element.getClassName


getClipStyle

getClipStyle(): ClipStyle

Gets the current clipping style

Returns

ClipStyle

clipping style

Inherited from

Element.getClipStyle


getContentElement

getContentElement(): ElementContent

Return inner content element

Returns

ElementContent

Inherited from

Element.getContentElement


getContentOrientation

getContentOrientation(): Orientation

Return content orientation

Returns

Orientation

content orientation

Inherited from

Element.getContentOrientation


getContentsArea

getContentsArea(transformation?): Rect

Return area without paddings. Model limits are mapped to content area, where children are layout.

Parameters

Name Type Description
Optional transformationTransformationscene transformation

Returns

Rect

Inherited from

Element.getContentsArea


getContentsTransform

getContentsTransform(): Transformation

getContentsTransform() retrieves the world transformation of the node.

Returns

Transformation

transformation from model coordinates to bounds of the group

Inherited from

Element.getContentsTransform


getCss

getCss(): CssStyle

Return CSS style

Returns

CssStyle

Inherited from

Element.getCss


getCssClass

getCssClass(): string

Returns css class name to be used to apply CSS style

Returns

string

the css class name

Inherited from

Element.getCssClass


getCssClasses

getCssClasses(): string[]

Gets list of css class names which applied to this node

Returns

string[]

Inherited from

Element.getCssClasses


getCssTransform

getCssTransform(): string

Returns CSS transformation

Returns

string

Inherited from

Element.getCssTransform


getDesiredHeight

getDesiredHeight(): string | number

Returns desired height of the group as a layoutable object This method is a helper method to get access to getLayoutStyle()

Returns

string | number

desired height ("undefined" by default)

Inherited from

Element.getDesiredHeight


getDesiredWidth

getDesiredWidth(): string | number

Returns desired width of the group as a layoutable object. This method is a helper method to get access to getLayoutStyle()

Returns

string | number

desired width ("undefined" by default)

Inherited from

Element.getDesiredWidth


getDeviceLimits

getDeviceLimits(): Rect

Return device limits

Returns

Rect

Inherited from

Element.getDeviceLimits


getDomElement

getDomElement(): AbstractElement

Returns DOM element

Returns

AbstractElement

return DOM element

Implementation of

IElement.getDomElement

Inherited from

Element.getDomElement


getElementStyle

getElementStyle(): ElementStyle

Returns element style

Returns

ElementStyle

return element style

Implementation of

IElement.getElementStyle

Inherited from

Element.getElementStyle

getElementStyle(elementStyle): any

Parameters

Name Type
elementStylestring

Returns

any

Implementation of

IElement.getElementStyle

Inherited from

Element.getElementStyle


getElementTransformations

getElementTransformations(bounds?): Transformation[]

Return array of transformations

Parameters

Name Type Description
Optional boundsRectelement bounds

Returns

Transformation[]

array of transformations

Inherited from

Element.getElementTransformations


getFillStyle

getFillStyle(): FillStyle

Return fill style

Returns

FillStyle

fillStyle current fill style

Inherited from

Element.getFillStyle


getId

getId(): string | number

Returns the associated identifier of the node

Returns

string | number

The node's id

Inherited from

Element.getId


getInfiniteMode

getInfiniteMode(): boolean

Return infinity mode flag

Returns

boolean

flag

Inherited from

Element.getInfiniteMode


getInvalidateMethod

Protected getInvalidateMethod(): AttributeCallback<EventDispatcher>

Gets invalidate method

Returns

AttributeCallback<EventDispatcher>

method to invalidate this object

Inherited from

Element.getInvalidateMethod


getLayout

getLayout(): Layout

Returns layout associated with the group

Returns

Layout

layout

Inherited from

Element.getLayout


getLayoutStyle

getLayoutStyle(): LayoutStyle<string | number>

return desired layout style

Returns

LayoutStyle<string | number>

Inherited from

Element.getLayoutStyle


getLineStyle

getLineStyle(): LineStyle

Return border style

Returns

LineStyle

Inherited from

Element.getLineStyle


getLocalTransform

getLocalTransform(): Transformation

Retrieves the transformation of bounds to parent

Returns

Transformation

transform the local transform.

Inherited from

Element.getLocalTransform


getMarginsStyle

getMarginsStyle(): SpaceStyle<string | number>

Return margins style

Returns

SpaceStyle<string | number>

Inherited from

Element.getMarginsStyle


getModelLimits

getModelLimits(): Rect

Gets model limits, the limits of this groups inside space

Returns

Rect

the current model limits

Inherited from

Element.getModelLimits


getName

getName(): string

Returns the node name

Returns

string

The node name

Inherited from

Element.getName


getOpacity

getOpacity(): number

Returns current node opacity

Returns

number

opacity

Inherited from

Element.getOpacity


getOpacityBlendMode

getOpacityBlendMode(): BlendMode

Returns current node opacity

Returns

BlendMode

opacity blend mode

Inherited from

Element.getOpacityBlendMode


getOverlay

getOverlay(index): Node

Return overlay at specified index

Parameters

Name Type Description
indexnumberindex at which to get the overlay for

Returns

Node

track

Inherited from

Element.getOverlay


getOverlayAt

getOverlayAt(index): Node

Return overlay at specified index

Deprecated

since 4.2 use getOverlay instead

Parameters

Name Type Description
indexnumberindex at which to get the overlay for

Returns

Node

track

Inherited from

Element.getOverlayAt


getOverlays

getOverlays<S>(predicate, modify?): Iterator<Node>

Return iterator by overlays nodes

Type parameters

NameType
Sextends Node<S>

Parameters

Name Type Description
predicate(value: Node) => value is Sa filter function
Optional modifybooleanAn option to specify if the iterator supports adding/removing items from the collection. false by default.

Returns

Iterator<Node>

Inherited from

Element.getOverlays

getOverlays(filter?, modify?): Iterator<Node>

Returns an iterator for child overlays. The iterator does not support adding or deleting items from overlays by default. If it is necessary to modify a collection of overlays, pass true as the last parameter.

Example

// Gets a writable iterator
const it = node.getOverlays(null, true);

Parameters

Name Type Description
Optional filter(node: Node) => booleanA filter function. Returns all overlays if null.
Optional modifybooleanAn option to specify if the iterator supports adding/removing items from the collection. false by default.

Returns

Iterator<Node>

An iterator for child overlays.

Inherited from

Element.getOverlays


getOverlaysCount

getOverlaysCount(): number

Returns amount of overlays

Returns

number

Inherited from

Element.getOverlaysCount


getPaddingStyle

getPaddingStyle(): SpaceStyle<string | number>

Return padding style

Returns

SpaceStyle<string | number>

padding

Inherited from

Element.getPaddingStyle


getParent

getParent(): ElementContent

Return parent node

Returns

ElementContent

parent node

Inherited from

Element.getParent


getPreferredElementBounds

getPreferredElementBounds(limits, cssLayout): Rect

Calculate layout bounds

Parameters

Name Type Description
limitsRectcontainer limits
cssLayoutLayoutStyle<string | number>element layout

Returns

Rect

preferred bounds

Inherited from

Element.getPreferredElementBounds


getPreferredSize

getPreferredSize(): Rect

Return preferred size to layout children

Returns

Rect

Inherited from

Element.getPreferredSize


getProperties

getProperties(context?): OptionsOut<Node>

Gets all the properties pertaining to this object

Parameters

Name Type Description
Optional contextISerializationContextserialization context

Returns

OptionsOut<Node>

properties object

Inherited from

Element.getProperties


getProperty

getProperty(name): any

Gets dynamic property by name. These properties can be used as a property bags

Parameters

Name Type Description
namestringproperty name

Returns

any

Inherited from

Element.getProperty


getPropertyKeys

getPropertyKeys(): string[]

Returns known properties keys

Returns

string[]

Inherited from

Element.getPropertyKeys


getRenderingFilter

getRenderingFilter(): IFilter

Return filter to be used for rendering and picking

Returns

IFilter

current filter

Inherited from

Element.getRenderingFilter


getResponsiveStyle

getResponsiveStyle(): ResponsiveStyle

Return responsive style

Returns

ResponsiveStyle

Inherited from

Element.getResponsiveStyle


getRoot

getRoot(): CompositeNode<Node>

Returns root node.
If node doesn't have parent then it returns itself.

Returns

CompositeNode<Node>

the root node

Inherited from

Element.getRoot


getScaleScrollStrategy

getScaleScrollStrategy(): Delegate

Gets scale scroll strategy

Returns

Delegate

scale scroll strategy

Inherited from

Element.getScaleScrollStrategy


getSceneTransform

getSceneTransform(): Transformation

Returns transformation from node to root scene

Returns

Transformation

a transformation from node to root scene

Inherited from

Element.getSceneTransform


getTag

getTag(): any

Returns the object associated with the node by user.

Returns

any

The node's user-object

Inherited from

Element.getTag


getTextStyle

getTextStyle(): TextStyle

Return text style

Returns

TextStyle


getVisible

getVisible(): boolean

Return visibility of the node

Returns

boolean

true if node is visible

Inherited from

Element.getVisible


getVisibleDeviceLimits

getVisibleDeviceLimits(ignoreModelLimits?): Rect

Return visible device limits

Parameters

Name Type Description
Optional ignoreModelLimitsbooleanflag defines whether to ignore ModelLimits or not

Returns

Rect

Inherited from

Element.getVisibleDeviceLimits


getVisibleModelLimits

getVisibleModelLimits(ignoreModelLimits?): Rect

Return visible model limits

Parameters

Name Type Description
Optional ignoreModelLimitsbooleanflag defines whether to ignore ModelLimits or not

Returns

Rect

Inherited from

Element.getVisibleModelLimits


getWireMode

getWireMode(): boolean

Returns Wire mode

Returns

boolean

return wire mode

Implementation of

IWireElement.getWireMode

Inherited from

Element.getWireMode


getWorldTransform

getWorldTransform(): Transformation

Retrieves the local transformation of the node which represents multiplication of parent to bounds and contents transformations.

Returns

Transformation

Inherited from

Element.getWorldTransform


getZIndex

getZIndex(): number

Returns node z-index (null if not set)

Returns

number

Inherited from

Element.getZIndex


hasCssClass

hasCssClass(cssClass): boolean

Check if node has specified css class

Parameters

Name Type Description
cssClassstringcss class name

Returns

boolean

Inherited from

Element.hasCssClass


hasEventListener

hasEventListener(type, callback?): boolean

Check if a list of event listeners for this type contains this listener

Parameters

Name Type Description
typestringtype of event or property
Optional callbackFunctionto be called, if null, check if any callback is registered

Returns

boolean

Inherited from

Element.hasEventListener


indexOfBaseLayer

indexOfBaseLayer(baseLayer): number

Return index of overlay ( index of the specified child or -1 if baseLayer is not found)

Parameters

Name Type Description
baseLayerNodebaseLayer to check index

Returns

number

Inherited from

Element.indexOfBaseLayer


indexOfChild

indexOfChild(node): number

Return index of child ( index of the specified child or -1 if node is not found)

Parameters

Name Type Description
nodeNodenode to check index

Returns

number

Inherited from

Element.indexOfChild


indexOfOverlay

indexOfOverlay(overlay): number

Return index of overlay ( index of the specified child or -1 if overlay is not found)

Parameters

Name Type Description
overlayNodeoverlay to check index

Returns

number

Inherited from

Element.indexOfOverlay


insertBaseLayer

insertBaseLayer(index, baseLayer): CompositeElement

Insert child baseLayer at specified index

Parameters

Name Type Description
indexnumberspecified index
baseLayerNodea baseLayer to add

Returns

CompositeElement

this

Inherited from

Element.insertBaseLayer


insertChild

insertChild(index, node): CompositeElement

Insert child node at specified index

Parameters

Name Type Description
indexnumberspecified index
nodeNodea child node to add

Returns

CompositeElement

this

Inherited from

Element.insertChild


insertOverlay

insertOverlay(index, overlay): CompositeElement

Insert child overlay at specified index

Parameters

Name Type Description
indexnumberspecified index
overlayNodea overlay to add

Returns

CompositeElement

this

Inherited from

Element.insertOverlay


invalidate

invalidate(bounds?, force?): CompositeElement

Invalidate node

Parameters

Name Type Description
Optional boundsRectoptional rectangular area to be invalidated, or force flag if rectangle is empty
Optional forcebooleanoptional boolean parameter that can force invalidation

Returns

CompositeElement

this

Inherited from

Element.invalidate


invalidateLayout

invalidateLayout(propagate?): CompositeElement

Notify that layout is invalidated. Send event Events.LayoutInvalidated

Parameters

Name Type Description
Optional propagatebooleanpropagate invalidate layout to parent

Returns

CompositeElement

this

Inherited from

Element.invalidateLayout


invalidateParent

invalidateParent(bounds?, force?): CompositeElement

Invalidate parent area

Parameters

Name Type Description
Optional boundsRectarea to invalidate
Optional forcebooleanforce

Returns

CompositeElement

this

Inherited from

Element.invalidateParent


isClippingEnabled

isClippingEnabled(): boolean

Returns if clipping is enabled or not for this node.

Returns

boolean

Inherited from

Element.isClippingEnabled


isDisposed

isDisposed(): boolean

Returns whether this object has been disposed

Returns

boolean

Inherited from

Element.isDisposed


isEventPropagationEnabled

isEventPropagationEnabled(): boolean

Return true if event propagation is enabled from child to parent

Returns

boolean

Inherited from

Element.isEventPropagationEnabled


isHorizontalFlip

isHorizontalFlip(): boolean

Return true if the representation is flipped horizontally

Returns

boolean

flip

Inherited from

Element.isHorizontalFlip


isLayoutInvalidated

isLayoutInvalidated(): boolean

Return true if layout is invalid

Returns

boolean

Inherited from

Element.isLayoutInvalidated


isNotificationEnabled

isNotificationEnabled(): boolean

return state of notification

Returns

boolean

current notification state

Inherited from

Element.isNotificationEnabled


isPickingChildrenEnabled

isPickingChildrenEnabled(): boolean

Returns if picking children is enabled or not for this node.

Returns

boolean

pickingChildren

Inherited from

Element.isPickingChildrenEnabled


isSelectable

isSelectable(): boolean

Returns true if node can be picked/selected.

Returns

boolean

The selectable flag

Inherited from

Element.isSelectable


isSilent

isSilent(): boolean

Return true if the event dispatcher doesn't notify any events

Returns

boolean

Inherited from

Element.isSilent


isVerticalFlip

isVerticalFlip(): boolean

Return true if the representation is flipped vertically

Returns

boolean

flip

Inherited from

Element.isVerticalFlip


moveTo

moveTo(area, vAlign?, hAlign?): CompositeElement

MoveTo position of node to specified area

Parameters

Name Type Description
areaRectspecified area
Optional vAlignstringvertical alignment. It can be "top", "bottom", "center".
Optional hAlignstringhorizontal alignment It can be "left", "right", "center".

Returns

CompositeElement

this

Inherited from

Element.moveTo


notify

notify<E>(type, source, args?): CompositeElement

Notify listeners of the Node

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEtype of event
sourceGroup<Node>source who called the event
Optional argsEventMap<Node>[E]event arguments

Returns

CompositeElement

this

Inherited from

Element.notify


notifyRoot

Protected notifyRoot(event, source, args?): Node

Notify an even to root node

Parameters

Name Type Description
eventstringtype of event
sourceNodesource who called the event
Optional argsanyevent arguments

Returns

Node

this

Inherited from

Element.notifyRoot


off

off<E>(type?, callback?): CompositeElement

Detach listener on event. Calling .off() with no arguments removes all attached listeners. Calling .off(type) with no callback removes all attached listeners for specific type.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
Optional typeEtype of the event
Optional callback(eventType: E, sender: CompositeElement, args: EventMap<Node>[E]) => voidfunction to be called

Returns

CompositeElement

this

Inherited from

Element.off


on

on<E>(type, callback): CompositeElement

Attach listener on event that will be called whenever the specified event is delivered to the target

If the callback function is already in the list of event listeners for this target, the function is not added a second time.

If a particular anonymous function is in the list of event listeners registered for a certain target, and then later in the code, an identical anonymous function is given in an "on" call, the second function will also be added to the list of event listeners for that target.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEtype of event or property
callback(eventType: E, sender: CompositeElement, args: EventMap<Node>[E]) => voidto be called

Returns

CompositeElement

this

Inherited from

Element.on


onBoundsChanged

Protected onBoundsChanged(bounds): CompositeElement

Occurs when bounds has been changed

Parameters

Name Type Description
boundsRectbound of the node in the parent coordinates

Returns

CompositeElement

this

Inherited from

Element.onBoundsChanged


onChildAdded

Protected onChildAdded(child): void

This method is called it child or children are added

Parameters

Name Type Description
childNode | Iterator<Node>added child

Returns

void

Inherited from

Element.onChildAdded


onChildRemoved

Protected onChildRemoved(child): void

This method is called it child or children are removed

Parameters

Name Type Description
childNoderemoved child

Returns

void

Inherited from

Element.onChildRemoved


onDomElementChanged

Protected onDomElementChanged(eventType, sender, eventArgs): CompositeElement

Update element from domElement

Parameters

Name Type Description
eventTypestringevent type
senderElement
eventArgsNodeEventArgsargument args

Returns

CompositeElement

Inherited from

Element.onDomElementChanged


onParentChanged

Protected onParentChanged(node): CompositeElement

This method is called when parent changes. Do not call it directly.

Parameters

Name Type Description
nodeNodenode to change parent

Returns

CompositeElement

this

Inherited from

Element.onParentChanged


onVisibilityChanged

Protected onVisibilityChanged(): void

This method is called if visibility is changed. Send event Events.VisibilityChanged

Returns

void

Inherited from

Element.onVisibilityChanged


postRendering

Protected postRendering(context, callback?): void

To be called after rendering, used for PDF output

Parameters

Name Type Description
contextRenderingContextRendering Context
Optional callback() => voidcallback to be called after rendering

Returns

void

Inherited from

Element.postRendering


preRendering

Protected preRendering(context, callback?): void

Occurs before child rendering

Parameters

Name Type Description
contextRenderingContextRendering Context
Optional callback() => voidcallback to be called after rendering of geometry

Returns

void

Inherited from

Element.preRendering


rebuild

rebuild(force?, changes?): CompositeElement

Rebuild node. This method resets state, cache, and invalidate node.

Parameters

Name Type Description
Optional forcebooleanoptional boolean parameter that can force invalidation
Optional changesStateChangesoptional parameter to specify a reason of changes

Returns

CompositeElement

this

Inherited from

Element.rebuild


rebuildDomLayout

rebuildDomLayout(): CompositeElement

Rebuild element DOM layout

Returns

CompositeElement

Implementation of

IElement.rebuildDomLayout

Inherited from

Element.rebuildDomLayout


registerAnimationStyle

registerAnimationStyle(root): void

Register animation style.

Parameters

Name Type Description
rootNoderoot node for node

Returns

void

Inherited from

Element.registerAnimationStyle


removeBaseLayer

removeBaseLayer(baseLayer): CompositeElement

Remove child baseLayer

Parameters

Name Type Description
baseLayerNode | Node[]baseLayer or array of nodes to be removed

Returns

CompositeElement

this

Inherited from

Element.removeBaseLayer


removeChild

removeChild(node, disposeChildren?): CompositeElement

Remove child node

Parameters

Name Type Description
nodeNode | Node[]node or array of nodes to be removed
Optional disposeChildrenbooleanautomatically dispose children. If it is true then method dispose is called for each child.

Returns

CompositeElement

this

Inherited from

Element.removeChild


removeCssClass

removeCssClass(cssclass): CompositeElement

Removes css class from node

Parameters

Name Type Description
cssclassstring | string[]css class name('s)

Returns

CompositeElement

this

Inherited from

Element.removeCssClass


removeInvalidateHandler

removeInvalidateHandler(handler): CompositeElement

Remove invalidate handler

Deprecated

since 4.0, use Node.off instead

Parameters

Name Type Description
handlerFunctionhandler to be notified about invalidation

Returns

CompositeElement

this

Inherited from

Element.removeInvalidateHandler


removeOverlay

removeOverlay(overlay): CompositeElement

Remove child overlay

Parameters

Name Type Description
overlayNode | Node[]overlay or array of nodes to be removed

Returns

CompositeElement

this

Inherited from

Element.removeOverlay


render

render(context): void

Render group

Parameters

Name Type Description
contextRenderingContextcontext to render group

Returns

void

Inherited from

Element.render


renderAsync

renderAsync(context, callback): void

Render node in asynchronous mode. This implementation doesn't support cache for now.

Parameters

Name Type Description
contextRenderingContextThe rendering context to be used to draw the node
callback() => voidcallback function

Returns

void

Inherited from

Element.renderAsync


renderBackground

Protected renderBackground(context, bounds): CompositeElement

Render background

Parameters

Name Type Description
contextRenderingContextcontext to render background
boundsRectgroup bounds

Returns

CompositeElement

this

Inherited from

Element.renderBackground


renderBaseLayers

Protected renderBaseLayers(context): CompositeElement

Render baseLayers on bottom of cache. This method does nothing, but can be implemented to render graphics on bottom of cache and between borders

Parameters

Name Type Description
contextRenderingContextcontext to render baseLayers

Returns

CompositeElement

this

Inherited from

Element.renderBaseLayers


renderBaseLayersAsync

Protected renderBaseLayersAsync(context, callback): void

Render baseLayers on bottom of cache in asynchronous mode. This method calls renderBaseLayers

Parameters

Name Type Description
contextRenderingContextcontext to render overlays
callback() => voidcallback function

Returns

void

Inherited from

Element.renderBaseLayersAsync


renderChildren

Protected renderChildren(context): void

Render children

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

void

Inherited from

Element.renderChildren


renderChildrenAsync

Protected renderChildrenAsync(context, callback): void

Render children async

Parameters

Name Type Description
contextRenderingContextRendering Context
callback() => voidcallback function to be called then all children are rendered

Returns

void

Inherited from

Element.renderChildrenAsync


renderContent

Protected renderContent(context): void

render to specified context. This method calls preRendering, renderChildren, postRendering

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

void

Inherited from

Element.renderContent


renderContentAsync

Protected renderContentAsync(context, callback): void

Render children in asynchronous mode

Parameters

Name Type Description
contextRenderingContextThe rendering context to be used to draw the node
callback() => voidcallback function to be called then all children are rendered

Returns

void

Inherited from

Element.renderContentAsync


renderOverlays

Protected renderOverlays(context): CompositeElement

Render overlays on top of cache. This method does nothing, but can be implemented to render graphics on top of cache and between borders

Parameters

Name Type Description
contextRenderingContextcontext to render overlays

Returns

CompositeElement

this

Inherited from

Element.renderOverlays


renderOverlaysAsync

Protected renderOverlaysAsync(context, callback): void

Render overlays on top of cache in asynchronous mode. This method calls renderOverlays

Parameters

Name Type Description
contextRenderingContextcontext to render overlays
callback() => voidcallback function

Returns

void

Inherited from

Element.renderOverlaysAsync


resumeUpdate

resumeUpdate(rebuild?, changes?): CompositeElement

Resume auto update

Parameters

Name Type Description
Optional rebuildbooleanforce rebuild
Optional changesStateChangesoptional parameter to specify a reason of changes

Returns

CompositeElement

this

Inherited from

Element.resumeUpdate


rotate

rotate(theta, x, y): CompositeElement

Rotate bounds around a given coordinate

Parameters

Name Type Description
thetanumberangle to rotate node, in radians
xnumberx coordinate to rotate around
ynumbery coordinate to rotate around

Returns

CompositeElement

this

Inherited from

Element.rotate


scale

scale(xx, yy): CompositeElement

Scale node

Parameters

Name Type Description
xxnumberx scale factor
yynumbery scale factor

Returns

CompositeElement

this

Inherited from

Element.scale


setAnimationStyle

setAnimationStyle(animationStyle): CompositeElement

Sets animation style

Parameters

Name Type Description
animationStyleTypeanimation style

Returns

CompositeElement

Inherited from

Element.setAnimationStyle


setAutoModelLimitsMode

setAutoModelLimitsMode(mode): CompositeElement

Set Model Limits Logics to use when no Model Limits have been set set to true: will use parents width and height, starting at 0 set to false: will use parents bounds. This is convenient method. It creates AutoModelLimitsStrategy

Parameters

Name Type Description
modebooleanModel Limits Logics to be used

Returns

CompositeElement

this

Inherited from

Element.setAutoModelLimitsMode


setAutoModelLimitsStrategy

setAutoModelLimitsStrategy(strategy): CompositeElement

Set Model Limits Logics Strategy

Parameters

Name Type Description
strategyModelLimitsStrategyModel Limits logic strategy to use

Returns

CompositeElement

this

Inherited from

Element.setAutoModelLimitsStrategy


setBounds

setBounds(bounds): CompositeElement

Sets bounds of the node in the parent coordinates

Parameters

Name Type Description
boundsTypebound of the node in the parent coordinates

Returns

CompositeElement

this

Inherited from

Element.setBounds


setCache

setCache(cache, rebuild?): CompositeElement

Sets cache to be used to cache

Parameters

Name Type Description
cacheCachecache to be used
Optional rebuildbooleanrebuild cache

Returns

CompositeElement

this

Inherited from

Element.setCache


setChild

setChild(index, node): CompositeElement

Replace child node by index

Parameters

Name Type Description
indexnumberindex of the node
nodeNodenode

Returns

CompositeElement

this

Inherited from

Element.setChild


setClipStyle

setClipStyle(style): CompositeElement

Sets a new clipping style

Parameters

Name Type Description
styleGraphicsPath | ClipStyle | Optionsa new clipping style

Returns

CompositeElement

this

Inherited from

Element.setClipStyle


setContentOrientation

setContentOrientation(orientation): CompositeElement

Set content orientation

Parameters

Name Type Description
orientationOrientationcontent orientation

Returns

CompositeElement

this

Inherited from

Element.setContentOrientation


setCss

setCss(style, merge?): CompositeElement

Sets CSS style. This style will be applied for all inserted elements

Parameters

Name Type Description
styleTypeCSS style to be applied to inserted elements
Optional mergebooleanmerge flag

Returns

CompositeElement

this

Inherited from

Element.setCss


setCssClass

setCssClass(name): CompositeElement

Sets css class name of the node to be used to apply CSS style

Parameters

Name Type Description
namestringcss class name of the node

Returns

CompositeElement

this

Inherited from

Element.setCssClass


setCssTransform

setCssTransform(transform): CompositeElement

Set CSS transformation

Parameters

Name Type Description
transformstring | Transformationtransformation css transformation instruction or Transformation instance

Returns

CompositeElement

this

Inherited from

Element.setCssTransform


setDesiredHeight

setDesiredHeight(value, silent?): CompositeElement

Sets desired height of the group as a layoutable object

Parameters

Name Type Description
valuestring | numberdesired height to set, use 'auto' for automatic desired height
Optional silentbooleansilent setting

Returns

CompositeElement

this

Inherited from

Element.setDesiredHeight


setDesiredWidth

setDesiredWidth(value, silent?): CompositeElement

Sets desired width of the group as a layoutable object

Parameters

Name Type Description
valuestring | numberdesired width to set
Optional silentbooleansilent setting

Returns

CompositeElement

this

Inherited from

Element.setDesiredWidth


setDomElement

setDomElement(domElement): CompositeElement

Set DOM element

Parameters

Name Type Description
domElementElementDOM element

Returns

CompositeElement

this

Implementation of

IElement.setDomElement

Inherited from

Element.setDomElement


setElementStyle

setElementStyle(elementStyle, styleValue?): CompositeElement

Set element style

Parameters

Name Type Description
elementStylestring | Record<string, any> | ElementStyleelement style
Optional styleValueanyobject of value for element style

Returns

CompositeElement

this

Implementation of

IElement.setElementStyle

Inherited from

Element.setElementStyle


setFillStyle

setFillStyle(fillStyle, merge?): CompositeElement

Sets fill style

Parameters

Name Type Description
fillStyleTypea new fill style
Optional mergebooleantrue if you want to merge fillStyle with existing attribute, false by default

Returns

CompositeElement

this

Inherited from

Element.setFillStyle


setHorizontalFlip

setHorizontalFlip(enable): CompositeElement

Set horizontal flip of the representation

Parameters

Name Type Description
enablebooleanenable flip

Returns

CompositeElement

this

Inherited from

Element.setHorizontalFlip


setId

setId(id): CompositeElement

Allows the user to associate any identifier

Parameters

Name Type Description
idstring | numberobject id

Returns

CompositeElement

this

Inherited from

Element.setId


setInfiniteMode

setInfiniteMode(infinityMode): CompositeElement

Set infinity mode flag to draw composite without collision check

Parameters

Name Type Description
infinityModebooleaninfinity mode flag

Returns

CompositeElement

this

Inherited from

Element.setInfiniteMode


setLayout

setLayout(layout): CompositeElement

Associate layout with a group.

Parameters

Name Type Description
layoutRecord<string, any> | Layoutlayout instance to be set or layout properties to apply

Returns

CompositeElement

this

Inherited from

Element.setLayout


setLayoutInvalidated

Protected setLayoutInvalidated(invalidated): void

Set invalidation status

Parameters

Name Type Description
invalidatedbooleaninvalidated layout

Returns

void

Inherited from

Element.setLayoutInvalidated


setLayoutStyle

setLayoutStyle(layoutStyle, silent?, merge?): CompositeElement

specify desired layout style

Parameters

Name Type Description
layoutStyleLayoutStyle<string | number> | Options<string | number>desired layout style
Optional silentbooleansilent setting
Optional mergebooleantrue if you want to merge layoutStyle with existing attribute, false by default

Returns

CompositeElement

this

Inherited from

Element.setLayoutStyle


setLineStyle

setLineStyle(lineStyle, merge?): CompositeElement

Sets border color Returns this

Parameters

Name Type Description
lineStyleTypeline style or options
Optional mergebooleantrue if you want to merge lineStyle with existing attribute, false by default

Returns

CompositeElement

this

Inherited from

Element.setLineStyle


setLocalTransform

setLocalTransform(localTransform, force?): CompositeElement

Sets local transformation to be used to transform from local to parent coordinate

Parameters

Name Type Description
localTransformTransformationlocal transformation for this node
Optional forcebooleanboolean flag to force update event if transformations are equal, false by default

Returns

CompositeElement

this

Inherited from

Element.setLocalTransform


setMarginsStyle

setMarginsStyle(margins, merge?): CompositeElement

Sets margins style

Parameters

Name Type Description
marginsType<string | number>margins style
Optional mergebooleantrue if you want to merge marginsStyle with existing attribute, false by default

Returns

CompositeElement

this

Inherited from

Element.setMarginsStyle


setModelLimits

setModelLimits(limits): CompositeElement

Sets inner model limits

Parameters

Name Type Description
limitsTypeinner limits

Returns

CompositeElement

this

Inherited from

Element.setModelLimits


setName

setName(name): CompositeElement

Sets name of the node

Parameters

Name Type Description
namestringThe node name

Returns

CompositeElement

this

Inherited from

Element.setName


setNotification

setNotification(notify, force?): CompositeElement

set notification state

Parameters

Name Type Description
notifybooleanflag set to invalidate parent or not
Optional forcebooleantrue if parent should be invalidated immediately

Returns

CompositeElement

this

Implementation of

IElement.setNotification

Inherited from

Element.setNotification


setOpacity

setOpacity(opacity, blendMode?): CompositeElement

Sets node opacity

Parameters

Name Type Description
opacitynumbernode opacity from 0 to 1
Optional blendModeBlendModeopacity blend mode. If it is normal, opacity will be replaced.

Returns

CompositeElement

this

Inherited from

Element.setOpacity


setPaddingStyle

setPaddingStyle(paddingStyle, merge?): CompositeElement

Sets padding style

Parameters

Name Type Description
paddingStyleType<string | number>padding style
Optional mergebooleantrue if you want to merge paddingStyle with existing attribute, false by default

Returns

CompositeElement

this

Inherited from

Element.setPaddingStyle


setProperties

setProperties(properties?): CompositeElement

Sets all the properties pertaining to this object

Parameters

Name Type Description
Optional propertiesOptions<Node>An object containing the properties to set

Returns

CompositeElement

this

Inherited from

Element.setProperties


setProperty

setProperty(name, value): CompositeElement

Sets dynamic property by name

Parameters

Name Type Description
namestringproperty name
valueanyproperty value

Returns

CompositeElement

this

Inherited from

Element.setProperty


setRenderingFilter

setRenderingFilter(filter): CompositeElement

Sets filter to be applied before rendering and picking

Parameters

Name Type Description
filterIFilterfilter to set

Returns

CompositeElement

this

Inherited from

Element.setRenderingFilter


setResponsiveStyle

setResponsiveStyle(style): CompositeElement

Sets responsive style.

Parameters

Name Type Description
styleOptions | ResponsiveStyleresponsive style

Returns

CompositeElement

this

Inherited from

Element.setResponsiveStyle


setScaleScrollStrategy

setScaleScrollStrategy(strategy?): CompositeElement

Sets scale scroll strategy

Parameters

Name Type Description
Optional strategyDelegatescale scroll strategy

Returns

CompositeElement

this

Inherited from

Element.setScaleScrollStrategy


setSelectable

setSelectable(selectable): CompositeElement

Allows to select node. If node is not selectable then child node is not selectable.

Parameters

Name Type Description
selectablebooleanflag to allow node selection

Returns

CompositeElement

this

Inherited from

Element.setSelectable


setSilent

setSilent(bool): CompositeElement

Set silent mode

Parameters

Name Type Description
boolbooleanflag to enable silent mode

Returns

CompositeElement

this

Implementation of

IElement.setSilent

Inherited from

Element.setSilent


setTag

setTag(tag): CompositeElement

Allows the user to associate any arbitrary object with the node.

Parameters

Name Type Description
taganyThe object to be associated with the node.

Returns

CompositeElement

this

Inherited from

Element.setTag


setTextStyle

setTextStyle(textStyle, merge?): CompositeElement

Sets text style

Parameters

Name Type Description
textStyleTypea new shape text style
Optional mergebooleantrue if you want to merge textStyle with existing attribute, false by default

Returns

CompositeElement


setVerticalFlip

setVerticalFlip(flip): CompositeElement

Set vertical flip of the representation

Parameters

Name Type Description
flipbooleanflag to set the vertical flip of the representation

Returns

CompositeElement

this

Inherited from

Element.setVerticalFlip


setVisible

setVisible(value): CompositeElement

Sets visibility of the node. Send event Events.VisibilityChanged

Parameters

Name Type Description
valuebooleanflag specifying visibility of the node

Returns

CompositeElement

this

Inherited from

Element.setVisible


setVisibleModelLimits

setVisibleModelLimits(visibleModelBounds, deviceBounds?): CompositeElement

Set visible model limits

Parameters

Name Type Description
visibleModelBoundsRectvisible model limits or bounds
Optional deviceBoundsRectdevice bounds

Returns

CompositeElement

this

Inherited from

Element.setVisibleModelLimits


setWireMode

setWireMode(enabled): CompositeElement

Set Wire mode

Parameters

Name Type Description
enabledbooleanwire mode

Returns

CompositeElement

this

Implementation of

IWireElement.setWireMode

Inherited from

Element.setWireMode


setZIndex

setZIndex(value): CompositeElement

Sets z-index for node (set null for default)

Parameters

Name Type Description
valuenumberindex determining node z-position

Returns

CompositeElement

this

Inherited from

Element.setZIndex


shear

shear(shx, shy): CompositeElement

Shear this node's bounds

Parameters

Name Type Description
shxnumberx-axis shear
shynumbery-axis shear

Returns

CompositeElement

this

Inherited from

Element.shear


suspendUpdate

suspendUpdate(): CompositeElement

Suspend auto update

Returns

CompositeElement

this

Inherited from

Element.suspendUpdate


toString

toString(): string

Returns a string representation of this object (generally the classname)

Returns

string

A string representation

Inherited from

Element.toString


translate

translate(tx, ty): CompositeElement

Translate bounds

Parameters

Name Type Description
txnumberx translation
tynumbery translation

Returns

CompositeElement

this

Inherited from

Element.translate


unregisterAnimationStyle

unregisterAnimationStyle(root): void

Unregister animation style.

Parameters

Name Type Description
rootAnimatedNoderoot node for node

Returns

void

Inherited from

Element.unregisterAnimationStyle


updateLayout

updateLayout(targets?): CompositeElement

Updates layout(s)

Fires

Events.LayoutUpdated

Parameters

Name Type Description
Optional targetsILayoutable[]optional parameter about which element to layout

Returns

CompositeElement

this

Inherited from

Element.updateLayout


updateSceneTransformation

updateSceneTransformation(): CompositeElement

Update scene transformation

Returns

CompositeElement

this

Inherited from

Element.updateSceneTransformation


updateState

updateState(regions?, changes?): CompositeElement

Update state. These methods reset node state and update state for children. this method is useful to refresh a scene graph

Parameters

Name Type Description
Optional regionsRect[]optional array to return invalid rectangles in the parent coordinates
Optional changesStateChangesoptional parameter to specify a reason of changes

Returns

CompositeElement

this

Inherited from

Element.updateState


updateSuspended

updateSuspended(): boolean

Return state of suspend state

Returns

boolean

state of update

Inherited from

Element.updateSuspended


updateTimeStamp

Protected updateTimeStamp(): CompositeElement

Update time stamp to indicate that Node or Children has been changed.

Returns

CompositeElement

this

Inherited from

Element.updateTimeStamp


enableSceneGraphNotification

Static enableSceneGraphNotification(enabled): void

Enable / disable all notifications

Parameters

Name Type Description
enabledbooleansets if this object sends notifications

Returns

void

Inherited from

Element.enableSceneGraphNotification


findParent

Static findParent<T>(node, classType, filter?): InstanceType<T>

Find root of the node with specified type

Type parameters

NameType
Textends Constructor<any>

Parameters

Name Type Description
nodeNodenode to start search
classTypeTtype of the class to search for
Optional filter(node: Node) => booleanadditional filter to apply

Returns

InstanceType<T>

Inherited from

Element.findParent

Static findParent(node, classType, filter?): Node

Find root of the node with specified type

Parameters

Name Type Description
nodeNodenode to start search
classTypestringinterface name to search for
Optional filter(node: Node) => booleanadditional filter to apply

Returns

Node

Inherited from

Element.findParent


getClassName

Static getClassName(): string

Returns

string

Inherited from

Element.getClassName


isSceneGraphNotificationEnabled

Static isSceneGraphNotificationEnabled(): boolean

Return status of the global notification for all nodes.

Returns

boolean

Inherited from

Element.isSceneGraphNotificationEnabled


rebuildDomLayout

Static rebuildDomLayout(element): IElement & Node

Rebuild DOM layout

Parameters

Name Type Description
elementIElement & Nodeelement

Returns

IElement & Node

Inherited from

Element.rebuildDomLayout