Skip to main content

IPlaceholderItemData

Interfaces

IPlaceholderItemData

A structure defining the default parameters of image placeholders.

Remarks

You can apply these parameters to the placeholder object through either clientConfig.json or IConfiguration https://customerscanvas.com/dev/editors/iframe-api/reference/design-editor-iframe/iconfiguration.html|IConfiguration.

Example

{
"defaultItemsConfig": {
"placeholder": {
"allowedSubfolder": "europe_photos",
"isCoverMode": false
}
}
}

Extends

Type Parameters

Type Parameter
TBarcodeFormat
TBarcodeSubType
TOverlayEffect

Properties

adjustSize?
optional adjustSize?: boolean;
Inherited from

IShapeItemData.adjustSize

allowedSubfolder?
optional allowedSubfolder?: string;

Defines a subfolder of /assets/images/ from which the user can select images for placeholders. When you specify this property, the gallery shows images only from the corresponding public subfolder. By default, your users can select images from any gallery tab or public subfolder.

allowedTabs?
optional allowedTabs?: string[];

Defines an array of gallery tab names from which the user can select images for placeholders. For example, to open only the Public files and My files tabs for image placeholders, set allowedTabs to ["Public files", "My files"]. By default, your users can select images from any gallery tab.

angle?
optional angle?: number;

An angle, which design elements are rotated to. By default, this value is 0.

Inherited from

IShapeItemData.angle

barcodeContent?
optional barcodeContent?: BarcodeContentType<TBarcodeFormat, TBarcodeSubType>;

Defines the barcode content type.

barcodeFormat?
optional barcodeFormat?: TBarcodeFormat;

Defines the barcode format.

blendMode?
optional blendMode?: BlendMode;

A blend mode that applies to design elements being added to the canvas.

Inherited from

IShapeItemData.blendMode

borderColor?
optional borderColor?: string;

The border color. The default value is "rgba(0,0,0,1)".

Inherited from

IShapeItemData.borderColor

borderWidth?
optional borderWidth?: number;

The border width, in points. The default value is 1.

Inherited from

IShapeItemData.borderWidth

contentBarcodeColor?
optional contentBarcodeColor?: string;

Defines the barcode color. The default value is "rgb(0, 0, 0)".

contentBarcodeOptions?
optional contentBarcodeOptions?: IBarcodeOptions;
contentFillColor?
optional contentFillColor?: string;

Defines the content fillColor.

contentImageUrl?
optional contentImageUrl?: string;

Defines a link to an image used as the placeholder's content. You can define URLs, links to private images ("user:someprivateimage.png"), and images from the public gallery ("public:logos/logo.png").

contentOverlayEffect?
optional contentOverlayEffect?: TOverlayEffect;
contentPermissions?
optional contentPermissions?: IContentPermissionsData;

Defines permissions for the content of placeholders.

contentResizeMode?
optional contentResizeMode?: ContentResizeMode;

Defines the resize mode for image placeholders. It can be either fill, fit, or original. The default value is fill.

fillColor?
optional fillColor?: string;

The fill color for shapes and placeholders. The default value is "rgba(112,112,112,1)" for shapes and is "rgba(0,0,0,0)" for image placeholders.

Inherited from

IShapeItemData.fillColor

fixedStubContentSize?
optional fixedStubContentSize?: boolean;

Maintains the size of stub images while resizing image placeholders. The default value is false.

height?
optional height?: string | number;

The height of design elements being added to the canvas, in points or percent. For QR codes, the width value is used for both width and height.

Inherited from

IShapeItemData.height

isCoverMode?
optional isCoverMode?: boolean;

Enables the cover mode for image placeholders. The default value is true.

isStubContent?
optional isStubContent?: boolean;

Defines whether this is a stub placeholder. The default value is false.

isVariable?
optional isVariable?: boolean;

Marks a design element as a variable item. The default value is false.

Inherited from

IShapeItemData.isVariable

itemPermissions?
optional itemPermissions?: IItemPermissionsData;

A structure defining the Item Menu and the Floating item toolbar for design elements.

Inherited from

IShapeItemData.itemPermissions

location?
optional location?: ILocationData;

The coordinates of design elements being added to the canvas. By default, you can add them to the center of your product.

Inherited from

IShapeItemData.location

manipulationPermissions?
optional manipulationPermissions?: IManipulationPermissionsData;

A structure defining the manipulation permissions for design elements.

Inherited from

IShapeItemData.manipulationPermissions

name?
optional name?: string;

The name of design elements being added to the canvas.

Inherited from

IShapeItemData.name

opacity?
optional opacity?: number;

An opacity that applies to design elements. This value can be from 0 to 1. By default, it is 1.

Inherited from

IShapeItemData.opacity

overprintFill?
optional overprintFill?: boolean;
Inherited from

IShapeItemData.overprintFill

overprintStroke?
optional overprintStroke?: boolean;
Inherited from

IShapeItemData.overprintStroke

placeholderPermissions?
optional placeholderPermissions?: IPlaceholderPermissionsData;

Defines permissions for placeholders.

shapePermissions?
optional shapePermissions?: IShapePermissionsData;

Defines permissions for shapes.

Inherited from

IShapeItemData.shapePermissions

textWrappingMode?
optional textWrappingMode?: WrappingMode;

A wrapping mode that applies to wrap text around design elements, one of "none", "square", or "tight". By default, it is "none".

Inherited from

IShapeItemData.textWrappingMode

themeBinding?
optional themeBinding?: IThemeBindingData;

A style or a color that applies to new design elements.

Inherited from

IShapeItemData.themeBinding

violationSettings?
optional violationSettings?: IViolationSettings;

A structure defining the design validation parameters and warnings.

Inherited from

IShapeItemData.violationSettings

visible?
optional visible?: boolean;

Indicates whether the design element is visible on the canvas. The default value is true.

Inherited from

IShapeItemData.visible

visualizationPermissions?
optional visualizationPermissions?: IVisualizationPermissionsData;

A structure defining the visualization permissions for design elements.

Inherited from

IShapeItemData.visualizationPermissions

width?
optional width?: string | number;

The width of design elements being added to the canvas, in points or percent.

Inherited from

IShapeItemData.width

Was this page helpful?