Skip to main content

Class: AbstractComponent

@ima/react-page-renderer.AbstractComponent

The base class for all view components.

Hierarchy

  • Component

    AbstractComponent

Constructors

constructor

new AbstractComponent(props)

Parameters

NameType
props{} | Readonly<{}>

Inherited from

Component.constructor

Defined in

node_modules/@types/react/index.d.ts:473

new AbstractComponent(props, context)

Deprecated

See

https://reactjs.org/docs/legacy-context.html

Parameters

NameType
propsObject
contextany

Inherited from

Component.constructor

Defined in

node_modules/@types/react/index.d.ts:478

Properties

_utils

Private Optional _utils: Utils

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:14


context

context: PageContextInterface

Overrides

Component.context

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:12


props

Readonly props: Readonly<{}>

Inherited from

Component.props

Defined in

node_modules/@types/react/index.d.ts:491


refs

refs: Object

Deprecated

https://reactjs.org/docs/refs-and-the-dom.html#legacy-api-string-refs

Index signature

[key: string]: ReactInstance

Inherited from

Component.refs

Defined in

node_modules/@types/react/index.d.ts:497


state

state: Readonly<{}>

Inherited from

Component.state

Defined in

node_modules/@types/react/index.d.ts:492


contextType

Static contextType: Context<PageContextInterface> = PageContext

Overrides

Component.contextType

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:11

Accessors

utils

get utils(): Utils

Returns the utilities for the view components. The returned value is the value bound to the $Utils object container constant.

Returns

Utils

The utilities for the view components.

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:22

Methods

UNSAFE_componentWillMount

Optional UNSAFE_componentWillMount(): void

Called immediately before mounting occurs, and before Component#render. Avoid introducing any side-effects or subscriptions in this method.

This method will not stop working in React 17.

Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.

Deprecated

16.3, use componentDidMount or the constructor instead

See

Returns

void

Inherited from

Component.UNSAFE_componentWillMount

Defined in

node_modules/@types/react/index.d.ts:688


UNSAFE_componentWillReceiveProps

Optional UNSAFE_componentWillReceiveProps(nextProps, nextContext): void

Called when the component may be receiving new props. React may call this even if props have not changed, so be sure to compare new and existing props if you only want to handle changes.

Calling Component#setState generally does not trigger this method.

This method will not stop working in React 17.

Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.

Deprecated

16.3, use static getDerivedStateFromProps instead

See

Parameters

NameType
nextPropsReadonly<{}>
nextContextany

Returns

void

Inherited from

Component.UNSAFE_componentWillReceiveProps

Defined in

node_modules/@types/react/index.d.ts:720


UNSAFE_componentWillUpdate

Optional UNSAFE_componentWillUpdate(nextProps, nextState, nextContext): void

Called immediately before rendering when new props or state is received. Not called for the initial render.

Note: You cannot call Component#setState here.

This method will not stop working in React 17.

Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.

Deprecated

16.3, use getSnapshotBeforeUpdate instead

See

Parameters

NameType
nextPropsReadonly<{}>
nextStateReadonly<{}>
nextContextany

Returns

void

Inherited from

Component.UNSAFE_componentWillUpdate

Defined in

node_modules/@types/react/index.d.ts:748


componentDidCatch

Optional componentDidCatch(error, errorInfo): void

Catches exceptions generated in descendant components. Unhandled exceptions will cause the entire component tree to unmount.

Parameters

NameType
errorError
errorInfoErrorInfo

Returns

void

Inherited from

Component.componentDidCatch

Defined in

node_modules/@types/react/index.d.ts:617


componentDidMount

Optional componentDidMount(): void

Called immediately after a component is mounted. Setting state here will trigger re-rendering.

Returns

void

Inherited from

Component.componentDidMount

Defined in

node_modules/@types/react/index.d.ts:596


componentDidUpdate

Optional componentDidUpdate(prevProps, prevState, snapshot?): void

Called immediately after updating occurs. Not called for the initial render.

The snapshot is only present if getSnapshotBeforeUpdate is present and returns non-null.

Parameters

NameType
prevPropsReadonly<{}>
prevStateReadonly<{}>
snapshot?any

Returns

void

Inherited from

Component.componentDidUpdate

Defined in

node_modules/@types/react/index.d.ts:659


componentWillMount

Optional componentWillMount(): void

Called immediately before mounting occurs, and before Component#render. Avoid introducing any side-effects or subscriptions in this method.

Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.

Deprecated

16.3, use componentDidMount or the constructor instead; will stop working in React 17

See

Returns

void

Inherited from

Component.componentWillMount

Defined in

node_modules/@types/react/index.d.ts:674


componentWillReceiveProps

Optional componentWillReceiveProps(nextProps, nextContext): void

Called when the component may be receiving new props. React may call this even if props have not changed, so be sure to compare new and existing props if you only want to handle changes.

Calling Component#setState generally does not trigger this method.

Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.

Deprecated

16.3, use static getDerivedStateFromProps instead; will stop working in React 17

See

Parameters

NameType
nextPropsReadonly<{}>
nextContextany

Returns

void

Inherited from

Component.componentWillReceiveProps

Defined in

node_modules/@types/react/index.d.ts:703


componentWillUnmount

Optional componentWillUnmount(): void

Called immediately before a component is destroyed. Perform any necessary cleanup in this method, such as cancelled network requests, or cleaning up any DOM elements created in componentDidMount.

Returns

void

Inherited from

Component.componentWillUnmount

Defined in

node_modules/@types/react/index.d.ts:612


componentWillUpdate

Optional componentWillUpdate(nextProps, nextState, nextContext): void

Called immediately before rendering when new props or state is received. Not called for the initial render.

Note: You cannot call Component#setState here.

Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.

Deprecated

16.3, use getSnapshotBeforeUpdate instead; will stop working in React 17

See

Parameters

NameType
nextPropsReadonly<{}>
nextStateReadonly<{}>
nextContextany

Returns

void

Inherited from

Component.componentWillUpdate

Defined in

node_modules/@types/react/index.d.ts:733


cssClasses

cssClasses(classRules, includeComponentClassName?): string

Generate a string of CSS classes from the properties of the passed-in object that resolve to true.

Example

this.cssClasses('my-class my-class-modifier', true);

Example

this.cssClasses({
'my-class': true,
'my-class-modifier': this.props.modifier
}, true);

Parameters

NameTypeDefault valueDescription
classRulesstring | { [key: string]: boolean; }undefinedCSS classes in a string separated by whitespace, or a map of CSS class names to boolean values. The CSS class name will be included in the result only if the value is true.
includeComponentClassNamebooleanfalse

Returns

string

String of CSS classes that had their property resolved to true.

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:79


fire

fire(eventName, target, data?): void

Creates and sends a new IMA.js DOM custom event from this component.

Parameters

NameTypeDefault valueDescription
eventNamestringundefinedThe name of the event.
targetEventTargetundefinedEventTarget compatible node.
dataundefinedundefinedData to send within the event.

Returns

void

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:93


forceUpdate

forceUpdate(callback?): void

Parameters

NameType
callback?() => void

Returns

void

Inherited from

Component.forceUpdate

Defined in

node_modules/@types/react/index.d.ts:488


getSnapshotBeforeUpdate

Optional getSnapshotBeforeUpdate(prevProps, prevState): any

Runs before React applies the result of render to the document, and returns an object to be given to componentDidUpdate. Useful for saving things such as scroll position before render causes changes to it.

Note: the presence of getSnapshotBeforeUpdate prevents any of the deprecated lifecycle events from running.

Parameters

NameType
prevPropsReadonly<{}>
prevStateReadonly<{}>

Returns

any

Inherited from

Component.getSnapshotBeforeUpdate

Defined in

node_modules/@types/react/index.d.ts:653


link(name, params?): string

Generates an absolute URL using the provided route name (see the

app/config/routes.js file). The provided parameters will replace the placeholders in the route pattern, while the extraneous parameters will be appended to the generated URL's query string.

Parameters

NameTypeDescription
namestringThe route name.
paramsObjectRouter parameters and extraneous parameters to add to the URL as a query string.

Returns

string

The generated URL.

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:55


listen

listen(eventTarget, eventName, listener): void

Registers the provided event listener for execution whenever an IMA.js DOM custom event of the specified name occurs at the specified event target.

Parameters

NameTypeDescription
eventTargetEventTargetThe react component or event target at which the listener should listen for the event.
eventNamestringThe name of the event for which to listen.
listener(event: Event) => voidThe listener for event to register.

Returns

void

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:107


localize

localize(key, params?): string

Returns the localized phrase identified by the specified key. The placeholders in the localization phrase will be replaced by the provided values.

Parameters

NameTypeDescription
keystringLocalization key.
paramsObjectValues for replacing the placeholders in the localization phrase.

Returns

string

Localized phrase.

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:40


render

render(): ReactNode

Returns

ReactNode

Inherited from

Component.render

Defined in

node_modules/@types/react/index.d.ts:489


setState

setState<K>(state, callback?): void

Type parameters

NameType
Kextends never

Parameters

NameType
statenull | {} | (prevState: Readonly<{}>, props: Readonly<{}>) => null | {} | Pick<{}, K> | Pick<{}, K>
callback?() => void

Returns

void

Inherited from

Component.setState

Defined in

node_modules/@types/react/index.d.ts:483


shouldComponentUpdate

Optional shouldComponentUpdate(nextProps, nextState, nextContext): boolean

Called to determine whether the change in props and state should trigger a re-render.

Component always returns true. PureComponent implements a shallow comparison on props and state and returns true if any props or states have changed.

If false is returned, Component#render, componentWillUpdate and componentDidUpdate will not be called.

Parameters

NameType
nextPropsReadonly<{}>
nextStateReadonly<{}>
nextContextany

Returns

boolean

Inherited from

Component.shouldComponentUpdate

Defined in

node_modules/@types/react/index.d.ts:607


unlisten

unlisten(eventTarget, eventName, listener): void

Deregisters the provided event listener for an IMA.js DOM custom event of the specified name at the specified event target.

Parameters

NameTypeDescription
eventTargetEventTargetThe react component or event target at which the listener should listen for the event.
eventNamestringThe name of the event for which to listen.
listener(event: Event) => voidThe listener for event to register.

Returns

void

Defined in

packages/react-page-renderer/src/component/AbstractComponent.ts:124