API reference

Asset

getTemporaryUrl findFonts openColorSelector requestFontSelection upload

Design

addAudioTrack addElementAtCursor addElementAtPoint addNativeElement addPage createRichtextRange editContent getCurrentPageContext getDefaultPageDimensions getDesignMetadata 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

ui.startDragToCursor

API reference for the ui.startDrag method.

Adds the specified element or content to responsive documents, which slot things into a text stream at the end of a drag event.

Parameters

eventDragStartEvent<E>

Required

A drag start event.

currentTargetE

Required

dragDataobject

Required

Element or content to be added to the design at the end of the drag event.

Embed element to be added to the design at the end of a drag event.

typestring

Required

The type of element.

The only valid value is "embed".

previewSizeDimensions

Required

The dimensions of the preview image.

widthnumber

Required

A width, in pixels.

heightnumber

Required

A height, in pixels.

previewUrlstring

Required

The URL of an image to display under the user's cursor during the drag and drop event.

embedUrlstring

Required

The URL of media that can be embedded, such as the URL of a YouTube video.

This URL must be supported by the Iframely API.

Video element or content to be added to the design at the end of a drag event.

typestring

Required

The type of element.

The only valid value is "video".

resolveVideoReffunction

Required

A function that returns a reference (ref) to a video asset in Canva's backend.

Returns

A Promise that resolves with the following object:

refVideoRef

A unique identifier that references a video asset in Canva's backend.

previewSizeDimensions

Required

The dimensions of the preview image.

widthnumber

Required

A width, in pixels.

heightnumber

Required

A height, in pixels.

previewUrlstring

Required

The URL of an image to display under the user's cursor during the drag and drop event.

fullSizeDimensions

Optional

The dimensions of the full-size video.

These dimensions are used when adding the video to the design
If omitted, the previewSize dimensions are used as a fallback.

widthnumber

Required

A width, in pixels.

heightnumber

Required

A height, in pixels.

Image element or content to be added to the design at the end of a drag event.

typestring

Required

The type of element.

The only valid value is "image".

previewSizeDimensions

Required

The dimensions of the preview image.

widthnumber

Required

A width, in pixels.

heightnumber

Required

A height, in pixels.

resolveImageReffunction

Required

A function that returns a reference (ref) to an audio asset in Canva's backend.

Returns

A Promise that resolves with the following object:

refImageRef

A unique identifier that references an image asset in Canva's backend.

previewUrlstring

Required

The URL of an image to display under the user's cursor during the drag and drop event.

fullSizeDimensions

Optional

The dimensions of the full-size image.

widthnumber

Required

A width, in pixels.

heightnumber

Required

A height, in pixels.

Returns

Promise<void>