Skip to main content

SceneLayer

In many cases, a scene beneath the design area helps the customer understand the size of their design and have more context. With the connected component you can take a properly configured underlay scene via url and position it as a DesignLayer amongst other IDA Framework components. If instead you would like to manage your own data sources and positioning you can use the prop driven component.

import { ConnectedSceneLayer } from '@design-stack-ct/design-engine-react-components';

nametyperequiredcomment
panelIdstringyes

Id of panel which is represented by scene (and for look up of slot number within scene)

allowUnsafePositioningbooleanno

An optional prop to allow unsafe positioning of the scene when no slot information is available. When set to true and no slot information is available the dimensions of the panel will be used.

Default value: false
backgroundColorstringno

An optional background color to use for the Scene preview. Will only be used with transparent scenes.

classNamestringno

Custom class name for component

defaultToFirstSlotbooleanno

If a matching slot isn't found for the given scene URL and panel ID, then default to the first slot.

Default value: false
namestringno

Name to embed within bem class name template (dec-${name}-scene-preview) for differentiating SceneLayer by css selector

renderingTenantstringno

The renderTenant used for requests. Defaults to dsc.

sceneUrlstringno

Url to scene which should be used. Will be inspected for slots to ensure compatibility with provided panelId

transparentbooleanno

Whether the resulting preview should contain transparency Warning: This will result in a larger payload size for customers as the image will be a png

Default value: false

import { SceneLayer } from '@design-stack-ct/design-engine-react-components';

nametyperequiredcomment
position{ height: number; width: number; x: number; y: number }yes

Pixel position of scene preview image within design layer Used to align scene preview image with IDA design area

scenePreviewUrlstringyes

Url to rendered image on scene which should be used

classNamestringno

Custom class name for component

namestringno

Name to embed within bem class name template (dec-${name}-scene-preview) for differentiating SceneLayer by css selector