On September 25th, 2024, we released v2 of the Apps SDK. To learn what’s new and how to upgrade, see Migration FAQ and Migration guide.

openDesign

API reference for the openDesign method.

Reads a specified part of the user's design and returns all elements in that part.

Parameters

optionsDesignContextOptionsRequired

Options for configuring how the design is read.

typestringRequired

The type of context.

This must be "current_page".

callbackDesignOpenCallbackRequired

A callback for operating on the design.

Parameters

sessionDesignEditing.CurrentPageResultRequired

The result of reading part of a design.

pageDesignEditing.PageRequired

The current page of the design.

A page with either fixed or unbounded dimensions.

For more information, see AbsolutePage.

Represents something that's not supported by the Apps SDK.

typestringRead-onlyRequired

This must be "unsupported".

helpersDesignEditing.PageHelpersRequired

These are various utilities that allow apps to do more complex operations on the page.

For more information, see PageHelpers.

syncfunctionRequired

Saves any changes made during the session while keeping the transaction open.

  • Any changes in the session are only reflected in the design after this method is called.
  • Once this method is called, further changes in the session can still be made.

Returns

Promise<void>

Returns

Promise<void>

Returns

Promise<void>