Skip to content

BlockSuite API Documentation / @blocksuite/affine-model / ConnectorElementModel

Class: ConnectorElementModel

Extends

Constructors

new ConnectorElementModel()

new ConnectorElementModel(options): ConnectorElementModel

Parameters

options
id

string

model

SurfaceBlockModel

onChange

(payload) => void

stashedStore

Map<unknown, unknown>

yMap

YMap<unknown>

Returns

ConnectorElementModel

Inherited from

SurfaceElementModel.constructor

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:61

Properties

_disposable

protected _disposable: DisposableGroup

Inherited from

SurfaceElementModel._disposable

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:24


_id

protected _id: string

Inherited from

SurfaceElementModel._id

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:25


_local

protected _local: Map<string | symbol, unknown>

Inherited from

SurfaceElementModel._local

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:26


_onChange()

protected _onChange: (payload) => void

Parameters

payload
local

boolean

oldValues

Record<string, unknown>

props

Record<string, unknown>

Returns

void

Inherited from

SurfaceElementModel._onChange

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:27


_preserved

protected _preserved: Map<string, unknown>

Used to store a copy of data in the yMap.

Inherited from

SurfaceElementModel._preserved

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:35


_stashed

protected _stashed: Map<string, unknown>

Inherited from

SurfaceElementModel._stashed

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:36


surface

surface: SurfaceBlockModel

Inherited from

SurfaceElementModel.surface

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:38


updatingPath

updatingPath: boolean = false

Defined in

packages/affine/model/src/elements/connector/connector.ts:107


yMap

yMap: YMap<unknown>

Inherited from

SurfaceElementModel.yMap

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:40

Accessors

absolutePath

Defined in

packages/affine/model/src/elements/connector/connector.ts:405


connectable

Get Signature

get connectable(): false

Returns

false

Overrides

SurfaceElementModel.connectable

Defined in

packages/affine/model/src/elements/connector/connector.ts:110


connected

Get Signature

get connected(): boolean

Returns

boolean

Defined in

packages/affine/model/src/elements/connector/connector.ts:114


deserializedXYWH

Get Signature

get deserializedXYWH(): XYWH

Returns

XYWH

Inherited from

SurfaceElementModel.deserializedXYWH

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:42


display

Inherited from

SurfaceElementModel.display

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:88


elementBound

Get Signature

get elementBound(): Bound

The bound of the element after rotation. The bound without rotation should be created by Bound.deserialize(this.xywh).

Returns

Bound

Overrides

SurfaceElementModel.elementBound

Defined in

packages/affine/model/src/elements/connector/connector.ts:118


externalBound

Get Signature

get externalBound(): null | Bound

Returns

null | Bound

Inherited from

SurfaceElementModel.externalBound

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:48


externalXYWH

In some cases, you need to draw something related to the element, but it does not belong to the element itself. And it is also interactive, you can select element by clicking on it. E.g. the title of the group element. In this case, we need to store this kind of external xywh in order to do hit test. This property should not be synced to the doc. This property should be updated every time it gets rendered.

Inherited from

SurfaceElementModel.externalXYWH

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:95


frontEndpointStyle

Defined in

packages/affine/model/src/elements/connector/connector.ts:408


group

Get Signature

get group(): null | GfxGroupModel

Returns

null | GfxGroupModel

Inherited from

SurfaceElementModel.group

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:49


groups

Get Signature

get groups(): GfxGroupModel[]

Return the ancestor elements in order from the most recent to the earliest.

Returns

GfxGroupModel[]

Inherited from

SurfaceElementModel.groups

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:53


h

Get Signature

get h(): number

Returns

number

Inherited from

SurfaceElementModel.h

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:54


id

Get Signature

get id(): string

Returns

string

Inherited from

SurfaceElementModel.id

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:55


index

Inherited from

SurfaceElementModel.index

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:96


isConnected

Get Signature

get isConnected(): boolean

Returns

boolean

Inherited from

SurfaceElementModel.isConnected

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:56


labelConstraints

Defines the size constraints of the label.

Defined in

packages/affine/model/src/elements/connector/connector.ts:417


labelDisplay

Control display and hide.

Defined in

packages/affine/model/src/elements/connector/connector.ts:423


labelOffset

The offset property specifies the label along the connector path.

Defined in

packages/affine/model/src/elements/connector/connector.ts:432


labelStyle

Defines the style of the label.

Defined in

packages/affine/model/src/elements/connector/connector.ts:445


labelXYWH

Returns a XYWH array providing information about the size of a label and its position relative to the viewport.

Defined in

packages/affine/model/src/elements/connector/connector.ts:452


lableEditing

Local control display and hide, mainly used in editing scenarios.

Defined in

packages/affine/model/src/elements/connector/connector.ts:458


lockedBySelf

Indicates whether the current block is explicitly locked by self. For checking the lock status of the element, use isLocked instead. For (un)locking the element, use (un)lock instead.

Inherited from

SurfaceElementModel.lockedBySelf

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:97


mode

Defined in

packages/affine/model/src/elements/connector/connector.ts:461


opacity

Inherited from

SurfaceElementModel.opacity

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:98


path

Defined in

packages/affine/model/src/elements/connector/connector.ts:471


rearEndpointStyle

Defined in

packages/affine/model/src/elements/connector/connector.ts:474


rotate

Overrides

SurfaceElementModel.rotate

Defined in

packages/affine/model/src/elements/connector/connector.ts:477


rough

Defined in

packages/affine/model/src/elements/connector/connector.ts:480


roughness

Defined in

packages/affine/model/src/elements/connector/connector.ts:483


seed

Inherited from

SurfaceElementModel.seed

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:99


source

Defined in

packages/affine/model/src/elements/connector/connector.ts:486


stroke

Defined in

packages/affine/model/src/elements/connector/connector.ts:491


strokeStyle

Defined in

packages/affine/model/src/elements/connector/connector.ts:494


strokeWidth

Defined in

packages/affine/model/src/elements/connector/connector.ts:497


target

Defined in

packages/affine/model/src/elements/connector/connector.ts:500


text

The content of the label.

Defined in

packages/affine/model/src/elements/connector/connector.ts:508


type

Get Signature

get type(): string

Returns

string

Overrides

SurfaceElementModel.type

Defined in

packages/affine/model/src/elements/connector/connector.ts:126


w

Get Signature

get w(): number

Returns

number

Inherited from

SurfaceElementModel.w

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:58


x

Get Signature

get x(): number

Returns

number

Inherited from

SurfaceElementModel.x

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:59


xywh

Overrides

SurfaceElementModel.xywh

Defined in

packages/affine/model/src/elements/connector/connector.ts:511


y

Get Signature

get y(): number

Returns

number

Inherited from

SurfaceElementModel.y

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:60

Methods

containsBound()

containsBound(bounds): boolean

Parameters

bounds

Bound

Returns

boolean

Overrides

SurfaceElementModel.containsBound

Defined in

packages/affine/model/src/elements/connector/connector.ts:138


getLineIntersections()

getLineIntersections(start, end): null | PointLocation[]

Parameters

start

IVec

end

IVec

Returns

null | PointLocation[]

Overrides

SurfaceElementModel.getLineIntersections

Defined in

packages/affine/model/src/elements/connector/connector.ts:148


getNearestPoint()

getNearestPoint(point): IVec

Calculate the closest point on the curve via a point.

Parameters

point

IVec

Returns

IVec

Overrides

SurfaceElementModel.getNearestPoint

Defined in

packages/affine/model/src/elements/connector/connector.ts:173


getOffsetDistanceByPoint()

getOffsetDistanceByPoint(point, bounds?): number

Calculating the computed distance along a path via a point.

The point is relative to the viewport.

Parameters

point

IVec

bounds?

Bound

Returns

number

Defined in

packages/affine/model/src/elements/connector/connector.ts:201


getPointByOffsetDistance()

getPointByOffsetDistance(offsetDistance, bounds?): IVec

Calculating the computed point along a path via a offset distance.

Returns a point relative to the viewport.

Parameters

offsetDistance

number = 0.5

bounds?

Bound

Returns

IVec

Defined in

packages/affine/model/src/elements/connector/connector.ts:240


getRelativePointLocation()

getRelativePointLocation(point): PointLocation

Parameters

point

IVec

Returns

PointLocation

Overrides

SurfaceElementModel.getRelativePointLocation

Defined in

packages/affine/model/src/elements/connector/connector.ts:270


hasLabel()

hasLabel(): boolean

Returns

boolean

Defined in

packages/affine/model/src/elements/connector/connector.ts:276


includesPoint()

includesPoint(x, y, options?): boolean

Parameters

x

number

y

number

options?

PointTestOptions

Returns

boolean

Overrides

SurfaceElementModel.includesPoint

Defined in

packages/affine/model/src/elements/connector/connector.ts:280


intersectsBound()

intersectsBound(bound): boolean

Parameters

bound

Bound

Returns

boolean

Inherited from

SurfaceElementModel.intersectsBound

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:78


isLocked()

isLocked(): boolean

Check if the element is locked. It will check the lock status of the element and its ancestors.

Returns

boolean

Inherited from

SurfaceElementModel.isLocked

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:79


isLockedByAncestor()

isLockedByAncestor(): boolean

Returns

boolean

Inherited from

SurfaceElementModel.isLockedByAncestor

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:80


isLockedBySelf()

isLockedBySelf(): boolean

Returns

boolean

Inherited from

SurfaceElementModel.isLockedBySelf

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:81


labelIncludesPoint()

labelIncludesPoint(point): boolean

Parameters

point

IVec

Returns

boolean

Defined in

packages/affine/model/src/elements/connector/connector.ts:304


lock()

lock(): void

Returns

void

Inherited from

SurfaceElementModel.lock

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:82


moveTo()

moveTo(bound): void

Parameters

bound

Bound

Returns

void

Defined in

packages/affine/model/src/elements/connector/connector.ts:310


onCreated()

onCreated(): void

Returns

void

Inherited from

SurfaceElementModel.onCreated

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:83


pop()

pop(prop): void

Parameters

prop

string

Returns

void

Inherited from

SurfaceElementModel.pop

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:84


resize()

resize(bounds, originalPath, matrix): object

Parameters

bounds

Bound

originalPath

PointLocation[]

matrix

DOMMatrix

Returns

object

labelXYWH?

optional labelXYWH: XYWH

source?

optional source: Connection

target?

optional target: Connection

Defined in

packages/affine/model/src/elements/connector/connector.ts:334


resizePath()

resizePath(originalPath, matrix): PointLocation[]

Parameters

originalPath

PointLocation[]

matrix

DOMMatrix

Returns

PointLocation[]

Defined in

packages/affine/model/src/elements/connector/connector.ts:372


serialize()

serialize(): SerializedConnectorElement

Returns

SerializedConnectorElement

Overrides

SurfaceElementModel.serialize

Defined in

packages/affine/model/src/elements/connector/connector.ts:396


stash()

stash(prop): void

Parameters

prop

string

Returns

void

Inherited from

SurfaceElementModel.stash

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:86


unlock()

unlock(): void

Returns

void

Inherited from

SurfaceElementModel.unlock

Defined in

packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:87


propsToY()

static propsToY(props): ConnectorElementProps

Parameters

props

ConnectorElementProps

Returns

ConnectorElementProps

Overrides

SurfaceElementModel.propsToY

Defined in

packages/affine/model/src/elements/connector/connector.ts:130