Skip navigation

Skip to main content

API reference
Intents: design
API reference

ui.startDragToPoint

API reference for the ui.startDragToPoint method.

Adds the specified element or content to fixed designs, which use a coordinate-based positioning system 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.

Audio track to be added to the design at the end of a drag event.

typestring
Required

The type of element.

The only valid value is "audio".

resolveAudioReffunction
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:

refAudioRef

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

durationMsnumber
Required

The duration of the audio track, in milliseconds.

titlestring
Required

A human readable title for the audio track.

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.

Text 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 "text".

childrenstring[]
Optional

The text content to drag.

textAlignstring
Optional

The alignment of the text.

Default value: "start"

Available values:

  • "start"
  • "center"
  • "end"
  • "justify"
fontWeightFontWeight
Optional

The weight (thickness) of the font.

Default value: "normal"

Available values:

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

The style of the font.

Default value: "normal"

Available values:

  • "normal"
  • "italic"
decorationstring
Optional

The decoration of the font.

Default value: "none"

Available values:

  • "none"
  • "underline"

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>