@express-document-sdk / TextContentModel
Class: TextContentModel
Represents a complete piece of text content flow, which may be split across multiple TextNode frames for display. Use this model to get or modify the text string and the style ranges applied to it.
Accessors
allTextNodes
• get allTextNodes(): Readonly<Iterable<TextNode, any, any>>
IMPORTANT: This is currently experimental only and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the experimentalApis flag to true in the requirements section of the manifest.json.
Get ordered list of all TextNodes that display this text content in the scenegraph. The text content starts in the first TextNode "frame", and then flows into the second node once it has filled the first one. The ending of the text content may not be visible at all, if the last TextNode "frame" is not large enough to accommodate it.
If there are multiple TextNodes, all of them must be configured to use AreaTextLayout.
Returns
Readonly<Iterable<TextNode, any, any>>
characterStyleRanges
• get characterStyleRanges(): readonly CharacterStylesRange[]
IMPORTANT: This is currently experimental only and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the experimentalApis flag to true in the requirements section of the manifest.json.
The character styles are applied to different ranges of this text content. When setting character styles, any style properties that are not provided are reset to their defaults (contrast to applyCharacterStyles which preserves the text's existing styles for any fields not specified). When getting styles, all fields are always provided.
Note: existing fonts used in the document, returned by this getter, are not guaranteed to be ones the current user has rights to edit with. The setter only accepts the AvailableFont type, which has been verified to be usable.
• set characterStyleRanges(styles): void
Parameters
• styles: readonly CharacterStylesRangeInput[]
Returns
readonly CharacterStylesRange[]
id
• get id(): string
IMPORTANT: This is currently experimental only and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the experimentalApis flag to true in the requirements section of the manifest.json.
A unique identifier for this node that stays the same when the file is closed & reopened, or if the node is moved to a different part of the document.
To determine if two TextNodes are connected to the same TextContentModel,
check if both models have the same id.
Comparing two models using === will always fail.
Returns
string
text
• get text(): string
The complete text string, which may span multiple TextNode "frames" in the scenegraph.
• set text(textContent): void
Parameters
• textContent: string
Returns
string
Methods
applyCharacterStyles()
• applyCharacterStyles(styles, range?): void
IMPORTANT: This is currently experimental only and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the experimentalApis flag to true in the requirements section of the manifest.json.
Apply one or more styles to the characters in the given range, leaving any style properties that were not specified unchanged. Does not modify any styles in the text outside this range. Contrast to the characterStyleRanges setter, which specifies new style range(s) for the entire text at once, and resets any unspecified properties back to default styles.
Parameters
• styles: CharacterStylesInput
The styles to apply.
• range?
The start and length of character sequence to which the styles should be applied. If not specified the styles will be applied to the entire piece of text content flow.
• range.length?: number
• range.start?: number
Returns
void
