Skip to main content

Class: RenderingBoundItemExtension

This extension exposes an action for updating an item based on changes to the rendering metadata. This is commonly needed when editing text and the user would like to operate with text growing either with the width constrained or height constrained.

It will also decorate item preview models with optimizations to prevent unnecessary changes to certain item previews, allowing for fewer requests as well as preventing rare circumstances which can cause an infinite loop of rendering requests due to minor changes in x or y positions (which should have no impact upon the render).

Remarks

The rendering metadata provided needs to correlate with this so that the request made to generate the metadata should have assumed the same constraint (height or width).

Dependencies

[DesignExtensionSystem]

Hierarchy

  • BaseExtension

    RenderingBoundItemExtension

Implements

Constructors

constructor

new RenderingBoundItemExtension(designState, designExtensionSystem, localizationProvider?)

Parameters

NameType
designStateDesignState
designExtensionSystemDesignExtensionSystem
localizationProvider?LocalizationProvider

Overrides

BaseExtension.constructor

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:47

Properties

designExtensionSystem

Private designExtensionSystem: DesignExtensionSystem

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:49


designState

Protected designState: ItemState<TextAreaItem>

Overrides

BaseExtension.designState

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:40


localizationProvider

Private Optional localizationProvider: LocalizationProvider

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:50


inject

Static inject: (string | { isOptional: boolean = true; token: string = 'localizationProvider' })[]

Overrides

BaseExtension.inject

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:46

Accessors

placeholderText

Private get placeholderText(): string

This may need to change if we decide to source placeholder text from somewhere else

Returns

string

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:164


previewModel

get previewModel(): TextAreaItem

Returns the preview model for the associated item or subpanel.

Remarks

This property will generate an Item object optimized for fetching previews based on an item's CDIF properties. If no optimizations exist for an item (currently only TextArea items), this property is just a retrieval of the related ItemState.model property.

Deprecated

This computed property is deprecated and will be removed in the next major version.

If you're seeing this deprecation warning, then referencing this property should now be unnecessary, as the RenderingBoundItemExtension has been changed to decorate item previews automatically as part of the ItemPreviewModelDecorator pattern.

Returns

TextAreaItem

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:67


previewModelOverrides

Private get previewModelOverrides(): Partial<TextAreaItem>

Generates the preview model overrides previously created by the this.previewModel getter to be consumed elsewhere

Returns

Partial<TextAreaItem>

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:80


shouldMutateDimensions

Private get shouldMutateDimensions(): boolean

Returns

boolean

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:153

Methods

[decorateItemPreviewModel]

[decorateItemPreviewModel](previewModel): void

Parameters

NameType
previewModelTextAreaItem

Returns

void

Implementation of

ItemPreviewModelDecorator.__@decorateItemPreviewModel@41120

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:138


updateItemWithMetadata

updateItemWithMetadata(metadata): void

Parameters

NameType
metadataFullRenderingMetadata

Returns

void

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:142


supports

Static supports(state): boolean

Parameters

NameType
stateDesignState

Returns

boolean

Overrides

BaseExtension.supports

Defined in

packages/design-engine-react-components/src/extensions/renderingBoundItem/RenderingBoundItemExtension.ts:42