createRichtextRange

API reference for the createRichtextRange method.

Creates a new RichtextRange object, which contains methods to manipulate text.

Provides methods for interacting with a range of formatted text.

#appendTextfunction

Appends the specified characters to the end of the range.

Parameters

#charactersstring
Required

The characters to append to the richtext range.

#formattingInlineFormatting
Optional

Options for formatting inline richtext.

Properties of formatting
#colorstring
Optional

The color of the text as a hex code.

The hex code must include all six characters and be prefixed with a # symbol.

Example

"#ff0099"
ts
#decorationstring
Optional

The decoration of the text.

Default Value: "none"

The available options include:

  • "none"
  • "underline"
#fontStylestring
Optional

The style of the font.

Default Value: "normal"

The available options include:

  • "normal"
  • "italic"
#fontWeightFontWeight
Optional

The weight (thickness) of the font.

The available font weights depend on the font.

Default Value: "normal"

The available options include:

  • "normal"
  • "thin"
  • "extralight"
  • "light"
  • "medium"
  • "semibold"
  • "bold"
  • "ultrabold"
  • "heavy"
#strikethroughstring
Optional

The strikethrough of the text.

Default Value: "none"

The available options include:

  • "none"
  • "strikethrough"

Returns

#boundsBounds

A segment of a richtext range.

Properties of bounds
#indexnumber

The starting position of the segment.

This is zero-based, meaning the first character of the range is at index 0.

#lengthnumber

The number of characters in the segment, starting from the index.

#formatParagraphfunction

Formats all of the paragraphs that overlap the given bounds.

  • The \n character indicates the end of a paragraph.
  • All paragraphs that overlap the provided bounds will be formatted in their entirety.

Parameters

#boundsBounds
Required

The segment of the range on which to apply the formatting.

Properties of bounds
#indexnumber
Required

The starting position of the segment.

This is zero-based, meaning the first character of the range is at index 0.

#lengthnumber
Required

The number of characters in the segment, starting from the index.

#formattingRichtextFormatting
Required

The formatting to apply to the paragraph(s).

Properties of formatting
#colorstring
Optional

The color of the text as a hex code.

The hex code must include all six characters and be prefixed with a # symbol.

Example

"#ff0099"
ts
#decorationstring
Optional

The decoration of the text.

Default Value: "none"

The available options include:

  • "none"
  • "underline"
#fontStylestring
Optional

The style of the font.

Default Value: "normal"

The available options include:

  • "normal"
  • "italic"
#fontWeightFontWeight
Optional

The weight (thickness) of the font.

The available font weights depend on the font.

Default Value: "normal"

The available options include:

  • "normal"
  • "thin"
  • "extralight"
  • "light"
  • "medium"
  • "semibold"
  • "bold"
  • "ultrabold"
  • "heavy"
#strikethroughstring
Optional

The strikethrough of the text.

Default Value: "none"

The available options include:

  • "none"
  • "strikethrough"
#fontRefFontRef
Optional

A unique identifier that points to a font asset in Canva's backend.

#fontSizenumber
Optional

The size of the text, in pixels.

  • In the Canva editor, this number is shown as points (pts), not pixels.
  • Minimum: 1
  • Maximum: 100
#listLevelnumber
Optional

The list indentation level of the paragraph.

#listMarkerstring
Optional

The appearance of list item markers.

This property only has an effect if listLevel is greater than 0.

Default Value: "none"

The available options include:

  • "none"
  • "disc"
  • "circle"
  • "square"
  • "decimal"
  • "lower-alpha"
  • "lower-roman"
  • "checked"
  • "unchecked"
#textAlignstring
Optional

The alignment of the text.

Default Value: "start"

The available options include:

  • "start"
  • "center"
  • "end"
  • "justify"

Returns

void

#formatTextfunction

Formats a region of text with inline formatting properties.

Parameters

#boundsBounds
Required

The segment of the range on which to apply the formatting.

Properties of bounds
#indexnumber
Required

The starting position of the segment.

This is zero-based, meaning the first character of the range is at index 0.

#lengthnumber
Required

The number of characters in the segment, starting from the index.

#formattingInlineFormatting
Required

The formatting to apply to the text.

Properties of formatting
#colorstring
Optional

The color of the text as a hex code.

The hex code must include all six characters and be prefixed with a # symbol.

Example

"#ff0099"
ts
#decorationstring
Optional

The decoration of the text.

Default Value: "none"

The available options include:

  • "none"
  • "underline"
#fontStylestring
Optional

The style of the font.

Default Value: "normal"

The available options include:

  • "normal"
  • "italic"
#fontWeightFontWeight
Optional

The weight (thickness) of the font.

The available font weights depend on the font.

Default Value: "normal"

The available options include:

  • "normal"
  • "thin"
  • "extralight"
  • "light"
  • "medium"
  • "semibold"
  • "bold"
  • "ultrabold"
  • "heavy"
#strikethroughstring
Optional

The strikethrough of the text.

Default Value: "none"

The available options include:

  • "none"
  • "strikethrough"

Returns

void

#readPlaintextfunction

Returns the current state of the richtext as plaintext.

Returns

string

#readTextRegionsfunction

Returns the current state of the richtext as one or more text regions. Each region is an object that contains the text content and its formatting.

Returns

#textstring

The plaintext content of the region.

#formattingPartial<RichtextFormatting>
Optional

The formatting of the region.

#replaceTextfunction

Replaces a region of text with the specified characters.

Parameters

#boundsBounds
Required

The segment of the range to replace.

Properties of bounds
#indexnumber
Required

The starting position of the segment.

This is zero-based, meaning the first character of the range is at index 0.

#lengthnumber
Required

The number of characters in the segment, starting from the index.

#charactersstring
Required

The replacement characters.

#formattingInlineFormatting
Optional

The formatting to apply to the replaced text.

Properties of formatting
#colorstring
Optional

The color of the text as a hex code.

The hex code must include all six characters and be prefixed with a # symbol.

Example

"#ff0099"
ts
#decorationstring
Optional

The decoration of the text.

Default Value: "none"

The available options include:

  • "none"
  • "underline"
#fontStylestring
Optional

The style of the font.

Default Value: "normal"

The available options include:

  • "normal"
  • "italic"
#fontWeightFontWeight
Optional

The weight (thickness) of the font.

The available font weights depend on the font.

Default Value: "normal"

The available options include:

  • "normal"
  • "thin"
  • "extralight"
  • "light"
  • "medium"
  • "semibold"
  • "bold"
  • "ultrabold"
  • "heavy"
#strikethroughstring
Optional

The strikethrough of the text.

Default Value: "none"

The available options include:

  • "none"
  • "strikethrough"

Returns

#boundsBounds

The bounds of the replacement characters within the updated range.

Properties of bounds
#indexnumber

The starting position of the segment.

This is zero-based, meaning the first character of the range is at index 0.

#lengthnumber

The number of characters in the segment, starting from the index.