EditingExtensionClient.API

Provides methods for interacting with Canva.
Usage
1
// Initialize the client (this returns a EditingExtensionClient.API object)
2
const canva = window.canva.init();
3
​
4
// The EditingExtensionClient.API object provides methods for interacting with Canva
5
canva.onReady(async () => {
6
  console.log("The client is initialized!");
7
});
Copied!
Methods
Name
Description
​create​
Creates a control that can be rendered in the control panel.
​exit​
Exits the user from the extension.
​onControlsEvent​
Registers a callback that runs when the user interacts with a control.
​onImageUpdate​
Registers a callback that runs when Canva requests the extension to update the user's image.
​onLayoutChange​
Registers a callback that runs when the layout of the iframe changes.
​onPresetSelected​
Registers a callback that runs when the user selects a preset.
​onPresetsRequest​
Registers a callback that runs when Canva requests presets from an extension.
​onReady​
Registers a callback that runs when the extension has finished loading.
​onSaveRequest​
Registers a callback that runs when Canva emits a save request.
​onTouchModeExit​
Registers a callback that runs when a user exits touch mode.
​onViewportResize​
Registers a callback that runs when the size of the viewport changes.
​remoteProcess​
Sends the user's image to a server for remote image processing.
​reportError​
Reports an error to Canva.
​showNotification​
Displays a notification.
​toggleSpinner​
Shows or hides a loading spinner.
​toggleTouchMode​
Enables or disables touch mode.
​updateControlPanel​
Renders controls in the side panel.
​updateLayout​
Updates the layout of the iframe that contains the user's image.

Distribution - Previous

Creating the App Directory listing

create

Last modified 7mo ago

Copy link

Contents

Usage

Methods