Class: EditorController

Defined in: editor/editorController.tsx:61

Stores, modifies and validates changes from the visual graph authoring (added, deleted or changed graph entities and/or relations).

Properties

Property	Modifier	Type	Description
events	readonly	Events<EditorEvents>	Events for the editor controller.

Accessors

authoringState

Get Signature

get authoringState(): AuthoringState

Defined in: editor/editorController.tsx:150

Graph authoring state snapshot.

Returns

AuthoringState

---

inAuthoringMode

Get Signature

get inAuthoringMode(): boolean

Defined in: editor/editorController.tsx:114

Returns true if the editor is in the graph authoring mode; otherwise false.

Returns

boolean

---

metadataProvider

Get Signature

get metadataProvider(): undefined | MetadataProvider

Defined in: editor/editorController.tsx:136

Provides strategy for the graph authoring mode.

Returns

undefined | MetadataProvider

---

temporaryState

Get Signature

get temporaryState(): TemporaryState

Defined in: editor/editorController.tsx:192

Temporary (transient) state for the graph authoring.

Returns

TemporaryState

---

validationProvider

Get Signature

get validationProvider(): undefined | ValidationProvider

Defined in: editor/editorController.tsx:143

Provides strategy to validate data changes from the graph authoring.

Returns

undefined | ValidationProvider

---

validationState

Get Signature

get validationState(): ValidationState

Defined in: editor/editorController.tsx:176

Validation state snapshot for the data changes from the graph authoring.

Returns

ValidationState

Methods

applyAuthoringChanges()

applyAuthoringChanges(): void

Defined in: editor/editorController.tsx:703

Applies changes from authoringState (including link deletion and entity IRI changes) to the diagram and resets the authoring state to AuthoringState.empty.

The operation puts a command to the command history.

Returns

void

---

changeEntity()

changeEntity(targetIri, newData): void

Defined in: editor/editorController.tsx:338

Changes an existing entity with graph authoring.

If no entities with target IRI found on the diagram, no changes will be applied to the graph authoring state.

The operation puts a command to the command history.

Parameters

Parameter	Type
targetIri	ElementIri
newData	ElementModel

Returns

void

---

changeRelation()

changeRelation(oldData, newData): void

Defined in: editor/editorController.tsx:447

Changes an existing relation with graph authoring.

The operation puts a command to the command history.

Parameters

Parameter	Type
oldData	LinkModel
newData	LinkModel

Returns

void

---

createEntity()

createEntity(data, options): EntityElement

Defined in: editor/editorController.tsx:308

Creates a new entity with graph authoring.

The operation puts a command to the command history.

Parameters

Parameter	Type
data	ElementModel
options	{ temporary?: boolean; }
options.temporary?	boolean

Returns

EntityElement

---

createRelation()

createRelation(base, options): RelationLink

Defined in: editor/editorController.tsx:406

Creates a new relation with graph authoring.

An error will be thrown if the relation with same identity already exists on the diagram.

The operation puts a command to the command history.

Parameters

Parameter	Type
base	RelationLink
options	{ temporary?: boolean; }
options.temporary?	boolean

Returns

RelationLink

---

deleteEntity()

deleteEntity(elementIri): void

Defined in: editor/editorController.tsx:368

Deletes an existing entity with graph authoring.

If no entities with target IRI found on the diagram, no changes will be applied to the graph authoring state.

The operation puts a command to the command history.

Parameters

Parameter	Type
elementIri	ElementIri

Returns

void

---

deleteRelation()

deleteRelation(data): void

Defined in: editor/editorController.tsx:530

Deletes an existing relation with graph authoring.

The operation puts a command to the command history.

Parameters

Parameter	Type
data	LinkModel

Returns

void

---

discardChange()

discardChange(event): void

Defined in: editor/editorController.tsx:614

Discards the specified graph authoring event from the state while reverting associated changes to the diagram:

• new entities and links are removed;
• changed entities and links have their data reverted back.

Parameters

Parameter	Type
event	AuthoringEvent

Returns

void

---

moveRelationSource()

moveRelationSource(params): RelationLink

Defined in: editor/editorController.tsx:481

Changes an existing relation with graph authoring by moving its source to another entity element.

The operation puts a command to the command history.

Parameters

Parameter	Type
params	{ link: RelationLink; newSource: EntityElement; }
params.link	RelationLink
params.newSource	EntityElement

Returns

RelationLink

---

moveRelationTarget()

moveRelationTarget(params): RelationLink

Defined in: editor/editorController.tsx:506

Changes an existing relation with graph authoring by moving its target to another entity element.

The operation puts a command to the command history.

Parameters

Parameter	Type
params	{ link: RelationLink; newTarget: EntityElement; }
params.link	RelationLink
params.newTarget	EntityElement

Returns

RelationLink

---

removeAllTemporaryCells()

removeAllTemporaryCells(): void

Defined in: editor/editorController.tsx:555

Removes all diagram cells from the temporary state for the graph authoring.

Returns

void

See

temporaryState

---

removeItems()

removeItems(items): void

Defined in: editor/editorController.tsx:257

Removes the specified diagram cells from the diagram and discards any associated graph authoring state.

If the link is a relation, it will be removed only if it's marked as "added" in the graph authoring state.

The operation puts a command to the command history.

Parameters

Parameter	Type
items	readonly (Element | Link)[]

Returns

void

---

removeSelectedElements()

removeSelectedElements(): void

Defined in: editor/editorController.tsx:239

Removes all selected diagram elements from the diagram and discards any associated graph authoring state.

The operation puts a command to the command history.

Returns

void

---

removeTemporaryCells()

removeTemporaryCells(cells): void

Defined in: editor/editorController.tsx:585

Removes the specified diagram cells from the temporary state for the graph authoring.

Parameters

Parameter	Type
cells	readonly (Element | Link)[]

Returns

void

See

temporaryState

---

revalidateEntities()

revalidateEntities(entities): void

Defined in: editor/editorController.tsx:220

Forces re-validation for the specified entities.

Parameters

Parameter	Type
entities	ReadonlySet<ElementIri>

Returns

void

---

setAuthoringMode()

setAuthoringMode(value): void

Defined in: editor/editorController.tsx:123

Toggles the graph authoring mode for the editor.

Does nothing if metadataProvider is not set.

Parameters

Parameter	Type
value	boolean

Returns

void

---

setAuthoringState()

setAuthoringState(value): void

Defined in: editor/editorController.tsx:158

Sets graph authoring state.

The operation puts a command to the command history.

Parameters

Parameter	Type
value	AuthoringState

Returns

void

---

setTemporaryState()

setTemporaryState(value): void

Defined in: editor/editorController.tsx:198

Sets temporary (transient) state for the graph authoring.

Parameters

Parameter	Type
value	TemporaryState

Returns

void

---

setValidationState()

setValidationState(value): void

Defined in: editor/editorController.tsx:182

Sets validation state for the data changes from the graph authoring.

Parameters

Parameter	Type
value	ValidationState

Returns

void