A generic lucid card block.
This shape has all of the base functionality as a BlockProxy, as well as additional card specific properties.
Extends
Constructors
new CardBlockProxy()
new CardBlockProxy(id, client): CardBlockProxy
Parameters
Parameter | Type | Description |
---|---|---|
id | string | ID of this item |
client | EditorClient |
Returns
Inherited from
Properties
allShapeData
readonly allShapeData: MapProxy<string, SerializedFieldType | DataError>;
All shape data accessible on this element, including shape data inherited from the page or a containing group.
This collection is read-only.
Inherited from
client
protected readonly client: EditorClient;
Inherited from
id
readonly id: string;
ID of this item
Inherited from
properties
readonly properties: WriteableMapProxy<string, JsonSerializable, void, JsonSerializable>;
All properties available on this element, organized by name.
Not all properties are writeable (e.g. "ClassName" on a block).
To move or resize elements, use setLocation() or setBoundingBox() or offset() instead.
Inherited from
referenceKeys
readonly referenceKeys: MapProxy<string | number, ReferenceKeyProxy>;
The set of reference keys, organized by their ID, which can be either a string or number.
For more information, see the Developer Guide.
Inherited from
shapeData
readonly shapeData: ShapeDataProxy;
The shape data set directly on this element (not including any shape data inherited from the page or a containing group).
Inherited from
textAreas
readonly textAreas: WriteableMapProxy<string, string, undefined, string>;
The plain text in each of the text areas on this item, organized by text area name.
Inherited from
textStyles
readonly textStyles: WriteableMapProxy<string, TextStyle, Promise<undefined>, Partial<TextStyle>>;
The text style in each of the text areas on this item, organized by text area name.
Inherited from
classNameRegex
static classNameRegex: RegExp;
Methods
applyRule()
applyRule(rule): void
Parameters
Parameter | Type | Description |
---|---|---|
rule | RuleProxy | Rule to apply to this item |
Returns
void
Inherited from
changeZOrder()
changeZOrder(operation): void
Parameters
Parameter | Type | Description |
---|---|---|
operation | ZOrderOperation | How to adjust the Z order of this item relative to the other items it overlaps on the page |
Returns
void
Inherited from
delete()
delete(): void
Delete this item from the document
Returns
void
Inherited from
executeFormula()
executeFormula(formula): SerializedFieldType | DataError
Execute a formula in the context of this element
Parameters
Parameter | Type | Description |
---|---|---|
formula | string | The formula text, e.g. "@a + @b" to add together the shape data values a and b. |
Returns
SerializedFieldType
| DataError
The result of the formula, or an error.
Inherited from
exists()
exists(): boolean
Returns
boolean
true
if this element still exists on the document, or false
otherwise
Inherited from
getAssignee()
getAssignee(): string
Returns
string
getBoundingBox()
getBoundingBox(): Box
Returns
The bounding box of this item relative to its containing page. As pages may change size
to fit the content on them, note that these coordinates may be negative or very large.
If this is a rotated block, the bounding box returned here is where the block would be if it were
unrotated.
Inherited from
getClassName()
getClassName(): string
Returns
string
The class name of this block. This name is not necessarily human-readable,
and will remain consistent over time, e.g. "ProcessBlock"..
Inherited from
getConnectedLines()
getConnectedLines(): LineProxy[]
Returns
An array of lines that have one or both endpoints connected to this block.
Inherited from
getContainers()
getContainers(): BlockProxy[]
Returns
An array of blocks whose bounding boxes contain this item's upper-left corner
Inherited from
getDescription()
getDescription(): string
Returns
string
getEndTime()
getEndTime(): SerializedIsoDateObject
Returns
getEstimate()
getEstimate(): number
Returns
number
getLineWidth()
getLineWidth(): number
Returns
number
The line width used by most kinds of blocks to render their outline.
Inherited from
getLocation()
getLocation(): object
Returns
object
The x/y location of this item
x
x: number = bb.x;
y
y: number = bb.y;
Inherited from
getPage()
getPage(): PageProxy
Returns
The page containing this item
Inherited from
getPageId()
getPageId(): string
Returns
string
The ID of the page containing this item
Inherited from
getRotatedBoundingBox()
getRotatedBoundingBox(): Box
Returns
An axis-aligned bounding box containing this full item after any rotation it might have
Inherited from
BlockProxy
.getRotatedBoundingBox
getRotation()
getRotation(): number
Returns
number
The amount this block is rotated around its own center, in radians.
Inherited from
getShadow()
getShadow(): undefined | Shadow
Returns
undefined
| Shadow
The current drop shadow on this block, or undefined if no shadow is set
Inherited from
getSimpleStaticDataGraphic()
getSimpleStaticDataGraphic(): undefined | SimpleStaticDataGraphicSettings
Returns
undefined
| SimpleStaticDataGraphicSettings
Settings for the simple static data graphic currently set on this block, or undefined
if no simple data graphic is currently set. Note that if a data graphic exists that is not an
icon, this will return undefined. This function will not consider data graphics set via
conditional formatting rules.
Inherited from
BlockProxy
.getSimpleStaticDataGraphic
getStartTime()
getStartTime(): SerializedIsoDateObject
Returns
getStatus()
getStatus(): StatusValues
Returns
getTitle()
getTitle(): string
Returns
string
linkText()
linkText(
textAreaKey,
referenceKey,
field): void
Link a text area to a data field, so that editing the text area will also update the
associated data, and vice versa.
To use this, first establish a reference key on this block with
setReferenceKey.
Parameters
Parameter | Type | Description |
---|---|---|
textAreaKey | string | |
referenceKey | string | number | |
field | string |
Returns
void
Inherited from
lockAspectRatio()
lockAspectRatio(): void
Lock this block's aspect ratio to its current value.
This can be reversed with unlockAspectRatio.
Returns
void
Inherited from
measureText()
measureText(name, maxWidth): MeasureTextResult
Measure the amount of space necessary to render the text in the given text area, given a
width to measure that text within.
Parameters
Parameter | Type | Description |
---|---|---|
name | string | Name of the text area whose content we should measure |
maxWidth | number | Width of the area in which to measure this text. The result will usually be no wider than this, but if a single word is long enough to go beyond this maxWidth, the width of that word will be returned. |
Returns
The size of rectangle necessary to render this text area's content.
Inherited from
offset()
offset(type, offset): void
Offset this item in the given direction by the given amount.
Parameters
Parameter | Type | Description |
---|---|---|
type | LinearOffsetType | The type of offset to apply to this item |
offset | Point | The amount to offset |
Returns
void
Inherited from
removeReferenceKey()
removeReferenceKey(key): void
Remove the specified reference key from this element.
Parameters
Parameter | Type | Description |
---|---|---|
key | string | number |
Returns
void
Inherited from
setAssignee()
setAssignee(assignee): void
Parameters
Parameter | Type | Description |
---|---|---|
assignee | string | The assignee that you want to set for this card. |
Returns
void
setBoundingBox()
setBoundingBox(bb): void
Attempts to move and resize this item to fit into the given bounding box. If this item (or another
item it contains) has size or aspect ratio restrictions, it may not be possible to fit the requested
location exactly.
This is done by moving this item to the requested location, then attempting to resize it from the
bottom-right corner to the requested size.
Parameters
Parameter | Type | Description |
---|---|---|
bb | Box | The bounding box to attempt to make this item fill |
Returns
void
Inherited from
setDataSyncStateIconPosition()
setDataSyncStateIconPosition(position): void
Parameters
Parameter | Type | Description |
---|---|---|
position | undefined | BadgeEnumPosition | The postion where the data sync state icon should be displayed on the block. If this position is set to undefined then the state icon position will fallback to the default position for the block. |
Returns
void
Inherited from
BlockProxy
.setDataSyncStateIconPosition
setDescription()
setDescription(description): void
Parameters
Parameter | Type | Description |
---|---|---|
description | string | The description that you want to set for this card. |
Returns
void
setEndTime()
setEndTime(endTime): void
Parameters
Parameter | Type | Description |
---|---|---|
endTime | SerializedIsoDateObject | The end time that you want to set for this card. |
Returns
void
setEstimate()
setEstimate(estimate): void
Parameters
Parameter | Type | Description |
---|---|---|
estimate | number | The estimate that you want to set for this card. |
Returns
void
setFillStyle()
setFillStyle(fillStyle): void
Set the fill style used (by most kinds of blocks) to fill in their main opaque areas.
This can be a string color (e.g. '#ff00ff80'
) or an image fill.
Parameters
Parameter | Type |
---|---|
fillStyle | SimpleFillStyle |
Returns
void
Inherited from
setLineWidth()
setLineWidth(width): void
Parameters
Parameter | Type | Description |
---|---|---|
width | number | The line width to be used (by most kinds of blocks) to render this block's outline |
Returns
void
Inherited from
setLocation()
setLocation(location): void
Moves this item so that its upper-left corner is positioned at the given location (prior to any rotation)
Parameters
Parameter | Type | Description |
---|---|---|
location | Point | The target location |
Returns
void
Inherited from
setReferenceKey()
setReferenceKey(key, settings): void
Set a reference key on this element, replacing any existing reference at the specified key.
Parameters
Parameter | Type | Description |
---|---|---|
key | string | number | |
settings | ReferenceKeyDefinition |
Returns
void
Inherited from
setRotation()
setRotation(radians): void
Parameters
Parameter | Type | Description |
---|---|---|
radians | number | Angle the block should be rotated |
Returns
void
Inherited from
setShadow()
setShadow(shadow): void
Parameters
Parameter | Type | Description |
---|---|---|
shadow | undefined | Shadow | The drop shadow to set on the block, or undefined to clear the drop shadow |
Returns
void
Inherited from
setSimpleStaticDataGraphic()
setSimpleStaticDataGraphic(settings): void
Parameters
Parameter | Type | Description |
---|---|---|
settings | undefined | SimpleStaticDataGraphicSettings | Information about the static data graphic icon to set on this block. |
Returns
void
Inherited from
BlockProxy
.setSimpleStaticDataGraphic
setStartTime()
setStartTime(startTime): void
Parameters
Parameter | Type | Description |
---|---|---|
startTime | SerializedIsoDateObject | The start time that you want to set for this card. |
Returns
void
setStatus()
setStatus(status): void
Parameters
Parameter | Type | Description |
---|---|---|
status | StatusValues | The status that you want to set for this card. |
Returns
void
setTitle()
setTitle(title): void
Parameters
Parameter | Type | Description |
---|---|---|
title | string | The title that you want to set for this card. |
Returns
void
unapplyRule()
unapplyRule(rule): void
Parameters
Parameter | Type | Description |
---|---|---|
rule | RuleProxy | Rule to remove from this item |
Returns
void
Inherited from
unlockAspectRatio()
unlockAspectRatio(): void
Unlock the aspect ratio of this block, allowing it to be stretched vertically or horizontally independently.
Returns
void