BlockSuite API Documentation / @blocksuite/affine-model / GroupElementModel
Class: GroupElementModel
Defined in: packages/affine/model/src/elements/group/group.ts:27
Extends
SurfaceGroupLikeModel
<GroupElementProps
>
Constructors
new GroupElementModel()
new GroupElementModel(
options
):GroupElementModel
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:66
Parameters
options
id
string
model
onChange
(payload
) => void
stashedStore
Map
<unknown
, unknown
>
yMap
YMap
<unknown
>
Returns
GroupElementModel
Inherited from
SurfaceGroupLikeModel
.constructor
Properties
_disposable
protected
_disposable:DisposableGroup
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:25
Inherited from
SurfaceGroupLikeModel
._disposable
_id
protected
_id:string
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:26
Inherited from
_local
protected
_local:Map
<string
|symbol
,unknown
>
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:27
Inherited from
_onChange()
protected
_onChange: (payload
) =>void
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:28
Parameters
payload
local
boolean
oldValues
Record
<string
, unknown
>
props
Record
<string
, unknown
>
Returns
void
Inherited from
SurfaceGroupLikeModel
._onChange
_preserved
protected
_preserved:Map
<string
,unknown
>
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:36
Used to store a copy of data in the yMap.
Inherited from
SurfaceGroupLikeModel
._preserved
_stashed
protected
_stashed:Map
<string
,unknown
>
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:37
Inherited from
SurfaceGroupLikeModel
._stashed
[gfxGroupCompatibleSymbol]
[gfxGroupCompatibleSymbol]:
true
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:112
Inherited from
SurfaceGroupLikeModel
.[gfxGroupCompatibleSymbol]
propsUpdated
propsUpdated:
Subject
<{key
:string
; }>
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:38
Inherited from
SurfaceGroupLikeModel
.propsUpdated
surface
surface:
SurfaceBlockModel
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:42
Inherited from
yMap
yMap:
YMap
<unknown
>
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:44
Inherited from
Accessors
childElements
Get Signature
get childElements():
GfxModel
[]
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:113
All child element models of this container. Note that the childElements
may not contains all the children in childIds
, because some children may not be loaded.
Returns
GfxModel
[]
Inherited from
SurfaceGroupLikeModel
.childElements
childIds
Get Signature
get childIds():
string
[]
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:118
The ids of the children. Its role is to provide a unique way to access the children. You should update this field through setChildIds
when the children are added or removed.
Returns
string
[]
Inherited from
SurfaceGroupLikeModel
.childIds
children
Defined in: packages/affine/model/src/elements/group/group.ts:114
Overrides
SurfaceGroupLikeModel
.children
connectable
Get Signature
get connectable():
boolean
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:45
Returns
boolean
Inherited from
SurfaceGroupLikeModel
.connectable
descendantElements
Get Signature
get descendantElements():
GfxModel
[]
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:119
Returns
GfxModel
[]
Inherited from
SurfaceGroupLikeModel
.descendantElements
deserializedXYWH
Get Signature
get deserializedXYWH():
XYWH
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:46
Returns
XYWH
Inherited from
SurfaceGroupLikeModel
.deserializedXYWH
display
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:93
Inherited from
elementBound
Get Signature
get elementBound():
Bound
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:51
The bound of the element after rotation. The bound without rotation should be created by Bound.deserialize(this.xywh)
.
Returns
Bound
Inherited from
SurfaceGroupLikeModel
.elementBound
externalBound
Get Signature
get externalBound():
null
|Bound
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:52
Returns
null
| Bound
Inherited from
SurfaceGroupLikeModel
.externalBound
externalXYWH
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:100
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
SurfaceGroupLikeModel
.externalXYWH
group
Get Signature
get group():
null
|GfxGroupModel
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:53
Returns
null
| GfxGroupModel
Inherited from
groups
Get Signature
get groups():
GfxGroupModel
[]
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:57
Return the ancestor elements in order from the most recent to the earliest.
Returns
GfxGroupModel
[]
Inherited from
h
Get Signature
get h():
number
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:58
Returns
number
Inherited from
hidden
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:101
Inherited from
id
Get Signature
get id():
string
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:59
Returns
string
Inherited from
index
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:102
Inherited from
isConnected
Get Signature
get isConnected():
boolean
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:60
Returns
boolean
Inherited from
SurfaceGroupLikeModel
.isConnected
lockedBySelf
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:103
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
SurfaceGroupLikeModel
.lockedBySelf
opacity
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:104
Inherited from
responseBound
Get Signature
get responseBound():
Bound
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:61
The bound of the element considering the response extension.
Returns
Bound
Inherited from
SurfaceGroupLikeModel
.responseBound
responseExtension
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:105
Defines the extension of the response area beyond the element's bounding box. This tuple specifies the horizontal and vertical margins to be added to the element's bound.
The first value represents the horizontal extension (added to both left and right sides), and the second value represents the vertical extension (added to both top and bottom sides).
The response area is computed as: [x - horizontal, y - vertical, w + 2 * horizontal, h + 2 * vertical]
.
Example:
- xywh:
[0, 0, 100, 100]
,responseExtension: [10, 20]
Resulting response area:[-10, -20, 120, 140]
. responseExtension: [0, 0]
keeps the response area equal to the bounding box.
Inherited from
SurfaceGroupLikeModel
.responseExtension
rotate
Get Signature
get rotate():
number
Defined in: packages/affine/model/src/elements/group/group.ts:28
Returns
number
Set Signature
set rotate(
_
):void
Defined in: packages/affine/model/src/elements/group/group.ts:32
Parameters
_
number
Returns
void
Overrides
seed
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:106
Inherited from
showTitle
Defined in: packages/affine/model/src/elements/group/group.ts:117
title
Defined in: packages/affine/model/src/elements/group/group.ts:120
type
Get Signature
get type():
string
Defined in: packages/affine/model/src/elements/group/group.ts:34
Returns
string
Overrides
w
Get Signature
get w():
number
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:63
Returns
number
Inherited from
x
Get Signature
get x():
number
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:64
Returns
number
Inherited from
xywh
Get Signature
get xywh():
`[${number},${number},${number},${number}]`
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:120
Returns
`[${number},${number},${number},${number}]`
Set Signature
set xywh(
_
):void
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:121
Parameters
_
`[${number},${number},${number},${number}]`
Returns
void
Inherited from
y
Get Signature
get y():
number
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:65
Returns
number
Inherited from
Methods
_getXYWH()
protected
_getXYWH():Bound
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:122
Returns
Bound
Inherited from
SurfaceGroupLikeModel
._getXYWH
addChild()
addChild(
element
):void
Defined in: packages/affine/model/src/elements/group/group.ts:56
Parameters
element
GfxModel
Returns
void
Overrides
SurfaceGroupLikeModel
.addChild
containsBound()
containsBound(
bound
):boolean
Defined in: packages/affine/model/src/elements/group/group.ts:66
Parameters
bound
Bound
Returns
boolean
Overrides
SurfaceGroupLikeModel
.containsBound
getLineIntersections()
getLineIntersections(
start
,end
):null
|PointLocation
[]
Defined in: packages/affine/model/src/elements/group/group.ts:70
Parameters
start
IVec
end
IVec
Returns
null
| PointLocation
[]
Overrides
SurfaceGroupLikeModel
.getLineIntersections
getNearestPoint()
getNearestPoint(
point
):IVec
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:79
Parameters
point
IVec
Returns
IVec
Inherited from
SurfaceGroupLikeModel
.getNearestPoint
getRelativePointLocation()
getRelativePointLocation(
relativePoint
):PointLocation
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:80
Parameters
relativePoint
IVec
Returns
PointLocation
Inherited from
SurfaceGroupLikeModel
.getRelativePointLocation
hasChild()
hasChild(
element
):boolean
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:128
The actual field that stores the children of the group. It should be a ymap decorated with @field
.
Parameters
element
GfxCompatibleInterface
Returns
boolean
Inherited from
SurfaceGroupLikeModel
.hasChild
hasDescendant()
hasDescendant(
element
):boolean
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:132
Check if the group has the given descendant.
Parameters
element
GfxCompatibleInterface
Returns
boolean
Inherited from
SurfaceGroupLikeModel
.hasDescendant
includesPoint()
includesPoint(
x
,y
,opt
,__
):boolean
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:81
Parameters
x
number
y
number
opt
PointTestOptions
__
Returns
boolean
Inherited from
SurfaceGroupLikeModel
.includesPoint
intersectsBound()
intersectsBound(
bound
):boolean
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:82
Parameters
bound
Bound
Returns
boolean
Inherited from
SurfaceGroupLikeModel
.intersectsBound
isLocked()
isLocked():
boolean
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:83
Check if the element is locked. It will check the lock status of the element and its ancestors.
Returns
boolean
Inherited from
SurfaceGroupLikeModel
.isLocked
isLockedByAncestor()
isLockedByAncestor():
boolean
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:84
Returns
boolean
Inherited from
SurfaceGroupLikeModel
.isLockedByAncestor
isLockedBySelf()
isLockedBySelf():
boolean
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:85
Returns
boolean
Inherited from
SurfaceGroupLikeModel
.isLockedBySelf
lock()
lock():
void
Defined in: packages/affine/model/src/elements/group/group.ts:92
Returns
void
Overrides
onCreated()
onCreated():
void
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:87
Returns
void
Inherited from
SurfaceGroupLikeModel
.onCreated
onDestroyed()
onDestroyed():
void
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:88
Returns
void
Inherited from
SurfaceGroupLikeModel
.onDestroyed
pop()
pop(
prop
):void
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:89
Parameters
prop
string
Returns
void
Inherited from
removeChild()
removeChild(
element
):void
Defined in: packages/affine/model/src/elements/group/group.ts:78
Remove the child from the group
Parameters
element
GfxModel
Returns
void
Overrides
SurfaceGroupLikeModel
.removeChild
serialize()
serialize():
SerializedGroupElement
Defined in: packages/affine/model/src/elements/group/group.ts:87
Returns
Overrides
SurfaceGroupLikeModel
.serialize
setChildIds()
setChildIds(
value
,fromLocal
):void
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:142
Set the new value of the childIds
Parameters
value
string
[]
the new value of the childIds
fromLocal
boolean
if true, the change is happened in the local
Returns
void
Inherited from
SurfaceGroupLikeModel
.setChildIds
stash()
stash(
prop
):void
Defined in: packages/framework/block-std/dist/gfx/model/surface/element-model.d.ts:91
Parameters
prop
string
Returns
void
Inherited from
unlock()
unlock():
void
Defined in: packages/affine/model/src/elements/group/group.ts:97
Returns
void
Overrides
propsToY()
static
propsToY(props
):GroupElementProps
Defined in: packages/affine/model/src/elements/group/group.ts:38
Parameters
props
Record
<string
, unknown
>
Returns
GroupElementProps