react4j.dom

Class ReactDOM

java.lang.Object

react4j.dom.ReactDOM

@JsType(isNative=true,
        namespace="<global>")
public class ReactDOM
extends java.lang.Object

Core interface into React DOM library.

Method Summary

Modifier and Type	Method and Description
static void	batchedUpdates(react4j.core.Procedure action) Batch all state updates within the action.
static react4j.core.ReactNode	createElement(java.lang.String type) Create and return a new ReactElement of the given type.
static <P extends HtmlGlobalFields> react4j.core.ReactNode	createElement(java.lang.String type, P props) Create and return a new ReactElement of the given type.
static <P extends HtmlGlobalFields> react4j.core.ReactNode	createElement(java.lang.String type, P props, react4j.core.ReactNode... children) Create and return a new ReactElement of the given type with specified children.
static ReactPortal	createPortal(react4j.core.ReactNode children, elemental2.dom.Element container) Portals provide a first-class way to render children into a DOM node that exists outside the DOM hierarchy of the parent component.
static java.lang.Object	render(react4j.core.ReactNode node, elemental2.dom.Element container) Render a React element into the DOM in the supplied container.
static java.lang.Object	render(react4j.core.ReactNode node, elemental2.dom.Element container, react4j.core.Procedure onUpdate) Render a React element into the DOM in the supplied container.
static boolean	unmountComponentAtNode(elemental2.dom.Element container) Remove a mounted React component from the DOM and clean up its event handlers and state.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createPortal

public static ReactPortal createPortal(@Nonnull
                                       react4j.core.ReactNode children,
                                       @Nonnull
                                       elemental2.dom.Element container)

Portals provide a first-class way to render children into a DOM node that exists outside the DOM hierarchy of the parent component.

Even though a portal can be anywhere in the DOM tree, it behaves like a normal React child in every other way. Features like context work exactly the same regardless of whether the child is a portal, as the portal still exists in the React tree regardless of position in the DOM tree.

This includes event bubbling. An event fired from inside a portal will propagate to ancestors in the containing React tree, even if those elements are not ancestors in the DOM tree.

Parameters:

children - the react node to render.

container - the DOM element to render into.

Returns:

the new portal.

render

@Nullable
 @JsOverlay
public static java.lang.Object render(@Nonnull
                                                            react4j.core.ReactNode node,
                                                            @Nonnull
                                                            elemental2.dom.Element container,
                                                            @Nullable
                                                            react4j.core.Procedure onUpdate)

Render a React element into the DOM in the supplied container.

If the React element was previously rendered into container, this will perform an update on it and only mutate the DOM as necessary to reflect the latest React element.

If the optional callback is provided, it will be executed after the component is rendered or updated.

Parameters:

node - the react node to render.

container - the DOM element to render into.

onUpdate - the callback invoked when rendering is complete.

Returns:

a reference to the created React Component, DOM Node, Portal or null (stateless components).

render

@Nullable
 @JsOverlay
public static java.lang.Object render(@Nonnull
                                                            react4j.core.ReactNode node,
                                                            @Nonnull
                                                            elemental2.dom.Element container)

Render a React element into the DOM in the supplied container.

If the React element was previously rendered into container, this will perform an update on it and only mutate the DOM as necessary to reflect the latest React element.

Parameters:

node - the react node to render.

container - the DOM element to render into.

Returns:

a reference to the created React Component, DOM Node, Portal or null (stateless components).

See Also:

render(ReactNode, Element, Procedure)

unmountComponentAtNode

public static boolean unmountComponentAtNode(@Nonnull
                                             elemental2.dom.Element container)

Remove a mounted React component from the DOM and clean up its event handlers and state. If no component was mounted in the container, calling this function does nothing.

Parameters:

container - the DOM container containing the react component to unmount

Returns:

true if a component was unmounted and false if there was no component to unmount.

createElement

@Nonnull
 @JsOverlay
public static react4j.core.ReactNode createElement(@Nonnull
                                                                        java.lang.String type)

Create and return a new ReactElement of the given type.

Parameters:

type - A HTML tag name (eg. 'div', 'span', etc)

Returns:

the created ReactNode

createElement

@Nonnull
 @JsMethod(namespace="React")
public static <P extends HtmlGlobalFields> react4j.core.ReactNode createElement(@Nonnull
                                                                                                                       java.lang.String type,
                                                                                                                       @Nullable
                                                                                                                       P props)

Create and return a new ReactElement of the given type.

Type Parameters:

P - The type of the props. It should match the associated tag name.

Parameters:

type - A HTML tag name (eg. 'div', 'span', etc)

props - The props to pass to the element.

Returns:

the created ReactNode

createElement

@Nonnull
 @JsMethod(namespace="React")
public static <P extends HtmlGlobalFields> react4j.core.ReactNode createElement(@Nonnull
                                                                                                                       java.lang.String type,
                                                                                                                       @Nullable
                                                                                                                       P props,
                                                                                                                       @Nullable
                                                                                                                       react4j.core.ReactNode... children)

Create and return a new ReactElement of the given type with specified children.

Type Parameters:

P - The type of the props. It should match the associated tag name.

Parameters:

type - A HTML tag name (eg. 'div', 'span', etc)

props - The props to pass to the element.

children - The child elements.

Returns:

the created DOMElement

batchedUpdates

@JsOverlay
public static void batchedUpdates(@Nonnull
                                             react4j.core.Procedure action)

Batch all state updates within the action. This is currently an unstable API within the React 16, mostly because it is only useful when called outside an event handler (i.e. from network code) and because it is likely to be enabled by default in a later version of React.

Parameters:

action - the action where all state updates are batched.