API reference

Asset

getTemporaryUrl findFonts openColorSelector requestFontSelection upload

Design

addAudioTrack addElementAtCursor addElementAtPoint addNativeElement addPage createRichtextRange editContent getCurrentPageContext getDefaultPageDimensions getDesignToken initAppElement openDesign overlay.registerOnCanOpen requestExport selection.registerOnChange setCurrentPageBackground ui.startDragToCursor ui.startDragToPoint ui.startDrag

Intents: data

prepareDataConnector

Intents: design

prepareDesignEditor

Platform

appProcess appProcess.broadcastMessage appProcess.current appProcess.current.getInfo appProcess.current.requestClose appProcess.current.setOnDispose appProcess.requestClose appProcess.registerOnMessage appProcess.registerOnStateChange features.isSupported features.registerOnSupportChange getPlatformInfo notification.addToast requestOpenExternalUrl

User

auth.getCanvaUserToken auth.initOauth

API reference

selection.registerOnChange

API reference for the selection.registerOnChange method.

Registers a callback that runs when the specified type of content is selected.

This callback fires immediately if content is already selected when the callback is registered.

Parameters

optsobject

Required

Options for configuring the content selection callback.

scopeScope

Required

The type of content that triggers a selection change event.

Available values:

"plaintext"
"image"
"video"
"richtext"

onChangefunction

Required

The callback to run when the selected content changes.

Parameters

eventSelectionEvent<Scope>

Required

Information about the selection change event.

scopeScopeRead-only

Required

The type of content that's selected.

Available values:

"plaintext"
"image"
"video"
"richtext"

countnumberRead-only

Required

The number of selected elements.

readfunction

Required

Returns a snapshot of the content in the user's selection.

The snapshot is known as the draft.

Returns

A snapshot of content from a user's design. This is a Promise that resolves with the following object:

contentsSelectionValue<Scope>[]Read-only

The individual content items that exist within the snapshot.

Any changes made to this array won't be reflected in the user's design until the save method is called.

savefunction

Saves changes made to the content items in the contents array.

Once this method is called:

Any changes the app has made to to the content will be reflected in the user's design.
Any changes the user has made to the content since the snapshot was created may be overwritten.
Only properties that are different from the original state will be written to the design.

Returns

Promise<void>

Returns

void

Returns

() => void