@aurigma/ui-framework
Version:
A platform which allows building print product personalization editors based on Aurigma's Customer's Canvas.
133 lines (74 loc) • 4.05 kB
Markdown
# Interface: ISetSurfacesOptions
Provides properties to replace design elements in the editor.
For details, you can refer to the [setSurfaces command](https://customerscanvas.com/dev/editors/ui-framework/widgets/design-editor-commands/set-surfaces.html).
## Hierarchy
* [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md)
↳ **ISetSurfacesOptions**
## Index
### Properties
* [after](isetsurfacesoptions.md#optional-after)
* [autoCompile](isetsurfacesoptions.md#optional-autocompile)
* [executeOnce](isetsurfacesoptions.md#optional-executeonce)
* [executeOnlyAfter](isetsurfacesoptions.md#optional-executeonlyafter)
* [lock](isetsurfacesoptions.md#optional-lock)
* [message](isetsurfacesoptions.md#optional-message)
* [onExecuted](isetsurfacesoptions.md#optional-onexecuted)
* [showPreloader](isetsurfacesoptions.md#optional-showpreloader)
* [surfaces](isetsurfacesoptions.md#surfaces)
* [timeout](isetsurfacesoptions.md#optional-timeout)
## Properties
### `Optional` after
• **after**? : *string | string[]*
*Inherited from [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md).[after](idesigneditorcommanddefinition.md#optional-after)*
The next commands to be executed after this command completes.
___
### `Optional` autoCompile
• **autoCompile**? : *boolean*
*Inherited from [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md).[autoCompile](idesigneditorcommanddefinition.md#optional-autocompile)*
If `false`, action will never execute automatically.
___
### `Optional` executeOnce
• **executeOnce**? : *boolean*
*Inherited from [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md).[executeOnce](idesigneditorcommanddefinition.md#optional-executeonce)*
If `true`, this command will be executed only once.
You can use it for `initial` command.
For example, we need to change surface depending on the option value.
We write for `initial` and for `updateSurfaces` the same productDefinition with $['option]._
And set `executeOnce = true` for `initial`. And initial will be executed only once.
___
### `Optional` executeOnlyAfter
• **executeOnlyAfter**? : *string[]*
*Inherited from [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md).[executeOnlyAfter](idesigneditorcommanddefinition.md#optional-executeonlyafter)*
Current command will be executed in a next update only after all commands executed in this param.
The same example from `executeOnce` param.
We need to execute `updateSurface` on all next updates, exclude the first one.
And we set `executeOnlyAfter = ['initial']` for `updateSurface` command.
___
### `Optional` lock
• **lock**? : *string[]*
*Inherited from [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md).[lock](idesigneditorcommanddefinition.md#optional-lock)*
Name of widgets that show preloader when command executed.
___
### `Optional` message
• **message**? : *string | string[]*
*Inherited from [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md).[message](idesigneditorcommanddefinition.md#optional-message)*
The message for preloader.
___
### `Optional` onExecuted
• **onExecuted**? : *Function | Function[]*
*Inherited from [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md).[onExecuted](idesigneditorcommanddefinition.md#optional-onexecuted)*
Functions that executed after command
___
### `Optional` showPreloader
• **showPreloader**? : *boolean*
*Inherited from [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md).[showPreloader](idesigneditorcommanddefinition.md#optional-showpreloader)*
If `true`, displays the preloader while executing this command.
___
### surfaces
• **surfaces**: *SurfaceTypes[]*
An array of definitions of the new surfaces.
___
### `Optional` timeout
• **timeout**? : *number*
*Inherited from [IDesignEditorCommandDefinition](idesigneditorcommanddefinition.md).[timeout](idesigneditorcommanddefinition.md#optional-timeout)*
The timeout for switching preloader messages.