com.facebook.react.uimanager

Class NativeViewHierarchyManager

java.lang.Object

com.facebook.react.uimanager.NativeViewHierarchyManager

@NotThreadSafe
public class NativeViewHierarchyManager
extends java.lang.Object

Delegate of UIManagerModule that owns the native view hierarchy and mapping between native view names used in JS and corresponding instances of ViewManager. The UIManagerModule communicates with this class by it's public interface methods: - updateProperties(int, com.facebook.react.uimanager.CatalystStylesDiffMap) - updateLayout(int, int, int, int, int, int) - createView(com.facebook.react.uimanager.ThemedReactContext, int, java.lang.String, com.facebook.react.uimanager.CatalystStylesDiffMap) - manageChildren(int, int[], com.facebook.react.uimanager.ViewAtIndex[], int[]) executing all the scheduled UI operations at the end of JS batch. NB: All native view management methods listed above must be called from the UI thread. The ReactContext instance that is passed to views that this manager creates differs from the one that we pass as a constructor. Instead we wrap the provided instance of ReactContext in an instance of ThemedReactContext that additionally provide a correct theme based on the root view for a view tree that we attach newly created view to. Therefore this view manager will create a copy of ThemedReactContext that wraps the instance of ReactContext for each root view added to the manager (see addRootView(int, com.facebook.react.uimanager.SizeMonitoringFrameLayout, com.facebook.react.uimanager.ThemedReactContext)). TODO(5483031): Only dispatch updates when shadow views have changed

Constructor Summary

Constructors

Constructor and Description
NativeViewHierarchyManager(ViewManagerRegistry viewManagers)

Method Summary

Methods

Modifier and Type	Method and Description
void	addRootView(int tag, SizeMonitoringFrameLayout view, ThemedReactContext themedContext) See UIManagerModule.addMeasuredRootView(com.facebook.react.uimanager.SizeMonitoringFrameLayout).
protected void	addRootViewGroup(int tag, android.view.ViewGroup view, ThemedReactContext themedContext)
void	clearJSResponder()
void	createView(ThemedReactContext themedContext, int tag, java.lang.String className, CatalystStylesDiffMap initialProps)
void	dispatchCommand(int reactTag, int commandId, ReadableArray args)
protected void	dropView(android.view.View view) Releases all references to given native View.
int	findTargetTagForTouch(int reactTag, float touchX, float touchY)
AnimationRegistry	getAnimationRegistry()
void	manageChildren(int tag, int[] indicesToRemove, com.facebook.react.uimanager.ViewAtIndex[] viewsToAdd, int[] tagsToDelete)
void	measure(int tag, int[] outputBuffer) Returns true on success, false on failure.
void	removeRootView(int rootViewTag)
protected android.view.View	resolveView(int tag)
protected ViewManager	resolveViewManager(int tag)
void	sendAccessibilityEvent(int tag, int eventType)
void	setJSResponder(int reactTag, int initialReactTag, boolean blockNativeResponder)
void	setLayoutAnimationEnabled(boolean enabled)
void	showPopupMenu(int reactTag, ReadableArray items, Callback success) Show a PopupMenu.
void	updateLayout(int parentTag, int tag, int x, int y, int width, int height)
void	updateProperties(int tag, CatalystStylesDiffMap props)
void	updateViewExtraData(int tag, java.lang.Object extraData)

Methods inherited from class java.lang.Object

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

Constructor Detail

NativeViewHierarchyManager

public NativeViewHierarchyManager(ViewManagerRegistry viewManagers)

Method Detail

resolveView

protected final android.view.View resolveView(int tag)

resolveViewManager

protected final ViewManager resolveViewManager(int tag)

getAnimationRegistry

public AnimationRegistry getAnimationRegistry()

setLayoutAnimationEnabled

public void setLayoutAnimationEnabled(boolean enabled)

updateProperties

public void updateProperties(int tag,
                    CatalystStylesDiffMap props)

updateViewExtraData

public void updateViewExtraData(int tag,
                       java.lang.Object extraData)

updateLayout

public void updateLayout(int parentTag,
                int tag,
                int x,
                int y,
                int width,
                int height)

createView

public void createView(ThemedReactContext themedContext,
              int tag,
              java.lang.String className,
              @Nullable
              CatalystStylesDiffMap initialProps)

manageChildren

public void manageChildren(int tag,
                  @Nullable
                  int[] indicesToRemove,
                  @Nullable
                  com.facebook.react.uimanager.ViewAtIndex[] viewsToAdd,
                  @Nullable
                  int[] tagsToDelete)

Parameters:

tag - react tag of the node we want to manage

indicesToRemove - ordered (asc) list of indicies at which view should be removed

viewsToAdd - ordered (asc based on mIndex property) list of tag-index pairs that represent a view which should be added at the specified index

tagsToDelete - list of tags corresponding to views that should be removed

addRootView

public void addRootView(int tag,
               SizeMonitoringFrameLayout view,
               ThemedReactContext themedContext)

See UIManagerModule.addMeasuredRootView(com.facebook.react.uimanager.SizeMonitoringFrameLayout). Must be called from the UI thread.

addRootViewGroup

protected final void addRootViewGroup(int tag,
                    android.view.ViewGroup view,
                    ThemedReactContext themedContext)

dropView

protected final void dropView(android.view.View view)

Releases all references to given native View.

removeRootView

public void removeRootView(int rootViewTag)

measure

public void measure(int tag,
           int[] outputBuffer)

Returns true on success, false on failure. If successful, after calling, output buffer will be {x, y, width, height}.

findTargetTagForTouch

public int findTargetTagForTouch(int reactTag,
                        float touchX,
                        float touchY)

setJSResponder

public void setJSResponder(int reactTag,
                  int initialReactTag,
                  boolean blockNativeResponder)

clearJSResponder

public void clearJSResponder()

dispatchCommand

public void dispatchCommand(int reactTag,
                   int commandId,
                   @Nullable
                   ReadableArray args)

showPopupMenu

public void showPopupMenu(int reactTag,
                 ReadableArray items,
                 Callback success)

Show a PopupMenu.

Parameters:

reactTag - the tag of the anchor view (the PopupMenu is displayed next to this view); this needs to be the tag of a native view (shadow views can not be anchors)

items - the menu items as an array of strings

success - will be called with the position of the selected item as the first argument, or no arguments if the menu is dismissed

sendAccessibilityEvent

public void sendAccessibilityEvent(int tag,
                          int eventType)