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