LithoView

java.lang.Object
- ViewGroup
- - com.facebook.rendercore.Host
  - - com.facebook.litho.ComponentHost
    - - com.facebook.litho.Host
      - com.facebook.litho.LithoView

```
public class LithoView
extends Host
```
A ViewGroup that can host the mounted state of a Component.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`LithoView.LayoutManagerOverrideParams` LayoutParams that override the LayoutManager.
`static interface`	`LithoView.OnDirtyMountListener`
`static interface`	`LithoView.OnPostDrawListener`

Field Summary

Fields
Modifier and Type Field and Description

static String SET_ALREADY_ATTACHED_COMPONENT_TREE

static String ZERO_HEIGHT_LOG

Fields
Modifier and Type	Field and Description
`static String`	`SET_ALREADY_ATTACHED_COMPONENT_TREE`
`static String`	`ZERO_HEIGHT_LOG`

Constructor Summary

Constructors
Constructor and Description
`LithoView(ComponentContext context, AttributeSet attrs)`
`LithoView(ComponentContext context, AttributeSet attrs, boolean useExtensions, boolean delegateToRenderCore)`
`LithoView(ComponentContext context, boolean useExtensions, boolean delegateToRenderCore)`
`LithoView(Context context)`
`LithoView(Context context, AttributeSet attrs)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static LithoView`	`create(Context context, Component component)` Create a new `LithoView` instance and initialize it with the given `Component` root.
`static LithoView`	`create(Context context, Component component, boolean isReconciliationEnabled)` Deprecated. Use `create(Context, Component)` instead and set config explicitly on the `ComponentTree` using `ComponentTree.Builder.isReconciliationEnabled(boolean)`.
`void`	`dispatchVisibilityEvent(Class<?> visibilityEventType)` Deprecated.
`void`	`draw(Canvas canvas)`
`protected void`	`forceRelayout()`
`ComponentContext`	`getComponentContext()`
`ComponentTree`	`getComponentTree()`
`Rect`	`getPreviousMountBounds()`
`boolean`	`isIncrementalMountEnabled()`
`void`	`notifyVisibleBoundsChanged()`
`void`	`notifyVisibleBoundsChanged(Rect visibleRect, boolean processVisibilityOutputs)`
`void`	`offsetLeftAndRight(int offset)`
`void`	`offsetTopAndBottom(int offset)`
`protected void`	`onAttachedToWindow()`
`void`	`onAttachedToWindowForTest()`
`protected void`	`onDetachedFromWindow()`
`void`	`onDetachedFromWindowForTest()`
`void`	`onFinishTemporaryDetach()`
`protected void`	`onMeasure(int widthMeasureSpec, int heightMeasureSpec)`
`void`	`onStartTemporaryDetach()`
`protected void`	`performLayout(boolean changed, int left, int top, int right, int bottom)`
`void`	`rebind()`
`void`	`release()`
`void`	`rerenderForAccessibility(boolean enabled)`
`void`	`resetMountStartupLoggingInfo()`
`void`	`setAnimatedHeight(int height)` Sets the height that the LithoView should take on the next measure pass and then requests a layout.
`void`	`setAnimatedWidth(int width)` Sets the width that the LithoView should take on the next measure pass and then requests a layout.
`void`	`setComponent(Component component)` Change the root component synchronously.
`void`	`setComponentAsync(Component component)` Change the root component measuring it on a background thread before updating the UI.
`void`	`setComponentAsyncWithoutReconciliation(Component component)` Deprecated. Use `getComponentTree()` and `ComponentTree.setRootAsync(Component)` instead; set the config explicitly on the `ComponentTree` using `ComponentTree.Builder.isReconciliationEnabled(boolean)`.
`void`	`setComponentTree(ComponentTree componentTree)`
`void`	`setComponentWithoutReconciliation(Component component)` Deprecated. Use `getComponentTree()` and `ComponentTree.setRoot(Component)` instead; set the config explicitly on the `ComponentTree` using `ComponentTree.Builder.isReconciliationEnabled(boolean)`.
`void`	`setHasTransientState(boolean hasTransientState)`
`void`	`setInvalidStateLogParamsList(List<ComponentLogParams> logParamsList)` Register for particular invalid state logs.
`void`	`setMountStartupLoggingInfo(LithoStartupLogger startupLogger, String startupLoggerAttribution, boolean[] firstMountCalled, boolean[] lastMountCalled, boolean isLastAdapterItem, boolean isOrientationVertical)`
`void`	`setOnDirtyMountListener(LithoView.OnDirtyMountListener onDirtyMountListener)`
`void`	`setOnPostDrawListener(LithoView.OnPostDrawListener onPostDrawListener)`
`void`	`setTranslationX(float translationX)`
`void`	`setTranslationY(float translationY)`
`void`	`setVisibilityHint(boolean isVisible)` Call this to tell the LithoView whether it is visible or not.
`protected boolean`	`shouldAlwaysLayoutChildren()` Indicates if the children of this view should be laid regardless to a mount step being triggered on layout.
`protected boolean`	`shouldRequestLayout()`
`void`	`startTemporaryDetach()`
`void`	`suppressMeasureComponentTree(boolean suppress)` If set to true, the onMeasure(..) call won't measure the ComponentTree with the given measure specs, but it will just use them as measured dimensions.
`String`	`toString()`
`void`	`unbind()` To be called this when the LithoView is about to become inactive.
`void`	`unmountAllItems()`

Methods inherited from class com.facebook.litho.ComponentHost
addView, addView, addView, addViewForTest, addViewInLayout, attachViewToParent, dispatchDraw, dispatchHoverEvent, drawableStateChanged, getChildDrawingOrder, getClipChildren, getComponentTouchListener, getContentDescription, getContentDescriptions, getContentNames, getDrawables, getImageContent, getLinkedDrawablesForAnimation, getMountItemAt, getMountItemCount, getTag, getTag, getTextContent, jumpDrawablesToCurrentState, mount, mount, moveItem, onInterceptTouchEvent, onLayout, onTouchEvent, performAccessibilityAction, refreshAccessibilityDelegatesIfNeeded, removeAllViewsInLayout, removeDetachedView, removeView, removeViewAt, removeViewInLayout, removeViews, removeViewsInLayout, requestDisallowInterceptTouchEvent, requestLayout, setAccessibilityDelegate, setClipChildren, setContentDescription, setTag, setViewTag, setViewTags, setVisibility, shouldDelayChildPressedState, unmount, unmount, verifyDrawable

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - ZERO_HEIGHT_LOG
```
public static final String ZERO_HEIGHT_LOG
```
    See Also:
    
    Constant Field Values
  - SET_ALREADY_ATTACHED_COMPONENT_TREE
```
public static final String SET_ALREADY_ATTACHED_COMPONENT_TREE
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - LithoView
```
public LithoView(Context context)
```
  - LithoView
```
public LithoView(Context context,
                 AttributeSet attrs)
```
  - LithoView
```
public LithoView(ComponentContext context,
                 boolean useExtensions,
                 boolean delegateToRenderCore)
```
  - LithoView
```
public LithoView(ComponentContext context,
                 AttributeSet attrs)
```
  - LithoView
```
public LithoView(ComponentContext context,
                 AttributeSet attrs,
                 boolean useExtensions,
                 boolean delegateToRenderCore)
```
- Method Detail
  - create
```
@Deprecated
public static LithoView create(Context context,
                                           Component component,
                                           boolean isReconciliationEnabled)
```
    Deprecated. Use create(Context, Component) instead and set config explicitly on the ComponentTree using ComponentTree.Builder.isReconciliationEnabled(boolean).
    
    Create a new LithoView instance and initialize it with the given Component root.
    
    Parameters:
    
    context - Android Context.
    
    component - The root component to draw.
    
    isReconciliationEnabled - should enable reconciliation.
    
    Returns:
    
    LithoView able to render a Component hierarchy.
  - create
```
public static LithoView create(Context context,
                               Component component)
```
    Create a new LithoView instance and initialize it with the given Component root.
    
    Parameters:
    
    context - Android Context.
    
    component - The root component to draw.
    
    Returns:
    
    LithoView able to render a Component hierarchy.
  - forceRelayout
```
protected void forceRelayout()
```
  - startTemporaryDetach
```
public void startTemporaryDetach()
```
  - onAttachedToWindow
```
protected void onAttachedToWindow()
```
  - onDetachedFromWindow
```
protected void onDetachedFromWindow()
```
  - onAttachedToWindowForTest
```
public void onAttachedToWindowForTest()
```
  - onDetachedFromWindowForTest
```
public void onDetachedFromWindowForTest()
```
  - onStartTemporaryDetach
```
public void onStartTemporaryDetach()
```
  - onFinishTemporaryDetach
```
public void onFinishTemporaryDetach()
```
  - suppressMeasureComponentTree
```
public void suppressMeasureComponentTree(boolean suppress)
```
    If set to true, the onMeasure(..) call won't measure the ComponentTree with the given measure specs, but it will just use them as measured dimensions.
  - setAnimatedWidth
```
public void setAnimatedWidth(int width)
```
    Sets the width that the LithoView should take on the next measure pass and then requests a layout. This should be called from animation-driving code on each frame to animate the size of the LithoView.
  - setAnimatedHeight
```
public void setAnimatedHeight(int height)
```
    Sets the height that the LithoView should take on the next measure pass and then requests a layout. This should be called from animation-driving code on each frame to animate the size of the LithoView.
  - onMeasure
```
protected void onMeasure(int widthMeasureSpec,
                         int heightMeasureSpec)
```
  - performLayout
```
protected void performLayout(boolean changed,
                             int left,
                             int top,
                             int right,
                             int bottom)
```
  - shouldAlwaysLayoutChildren
```
protected boolean shouldAlwaysLayoutChildren()
```
    Indicates if the children of this view should be laid regardless to a mount step being triggered on layout. This step can be important when some of the children in the hierarchy are changed (e.g. resized) but the parent wasn't.
    Since the framework doesn't expect its children to resize after being mounted, this should be used only for extreme cases where the underline views are complex and need this behavior.
    
    Returns:
    
    boolean Returns true if the children of this view should be laid out even when a mount step was not needed.
  - getComponentContext
```
public ComponentContext getComponentContext()
```
    Returns:
    
    ComponentContext associated with this LithoView. It's a wrapper on the Context originally used to create this LithoView itself.
  - shouldRequestLayout
```
protected boolean shouldRequestLayout()
```
    Overrides:
    
    shouldRequestLayout in class ComponentHost
  - getComponentTree
```
public ComponentTree getComponentTree()
```
  - setOnDirtyMountListener
```
public void setOnDirtyMountListener(LithoView.OnDirtyMountListener onDirtyMountListener)
```
  - setOnPostDrawListener
```
public void setOnPostDrawListener(LithoView.OnPostDrawListener onPostDrawListener)
```
  - setComponentTree
```
public void setComponentTree(ComponentTree componentTree)
```
  - setComponent
```
public void setComponent(Component component)
```
    Change the root component synchronously.
  - setComponentWithoutReconciliation
```
@Deprecated
public void setComponentWithoutReconciliation(Component component)
```
    Deprecated. Use getComponentTree() and ComponentTree.setRoot(Component) instead; set the config explicitly on the ComponentTree using ComponentTree.Builder.isReconciliationEnabled(boolean).
    
    Change the root component synchronously. Creates a new component tree with reconciliation disabled if required. DO NOT USE this method; it was added only to deprecate the current usages of setComponent(Component).
  - setComponentAsync
```
public void setComponentAsync(Component component)
```
    Change the root component measuring it on a background thread before updating the UI. If this LithoView doesn't have a ComponentTree initialized, the root will be computed synchronously.
  - setComponentAsyncWithoutReconciliation
```
@Deprecated
public void setComponentAsyncWithoutReconciliation(Component component)
```
    Deprecated. Use getComponentTree() and ComponentTree.setRootAsync(Component) instead; set the config explicitly on the ComponentTree using ComponentTree.Builder.isReconciliationEnabled(boolean).
    
    Change the root component measuring it on a background thread before updating the UI. If this LithoView doesn't have a ComponentTree initialized, the root will be computed synchronously with reconciliation disabled. DO NOT USE this method; it was added only to deprecate the current usages of setComponentAsync(Component).
  - rebind
```
public void rebind()
```
  - unbind
```
public void unbind()
```
    To be called this when the LithoView is about to become inactive. This means that either the view is about to be recycled or moved off-screen.
  - setVisibilityHint
```
public void setVisibilityHint(boolean isVisible)
```
    Call this to tell the LithoView whether it is visible or not. In general, you shouldn't require this as the system will do this for you. However, when a new activity/fragment is added on top of the one hosting this view, the LithoView remains in the backstack but receives no callback to indicate that it is no longer visible.
    
    Parameters:
    
    isVisible - if true, this will find the current visible rect and process visibility outputs using it. If false, any invisible and unfocused events will be called.
  - setHasTransientState
```
public void setHasTransientState(boolean hasTransientState)
```
  - offsetTopAndBottom
```
public void offsetTopAndBottom(int offset)
```
  - offsetLeftAndRight
```
public void offsetLeftAndRight(int offset)
```
  - setTranslationX
```
public void setTranslationX(float translationX)
```
  - setTranslationY
```
public void setTranslationY(float translationY)
```
  - draw
```
public void draw(Canvas canvas)
```
  - notifyVisibleBoundsChanged
```
public void notifyVisibleBoundsChanged(Rect visibleRect,
                                       boolean processVisibilityOutputs)
```
  - notifyVisibleBoundsChanged
```
public void notifyVisibleBoundsChanged()
```
  - isIncrementalMountEnabled
```
public boolean isIncrementalMountEnabled()
```
  - release
```
public void release()
```
  - dispatchVisibilityEvent
```
@Deprecated
public void dispatchVisibilityEvent(Class<?> visibilityEventType)
```
    Deprecated.
    
    Dispatch a visibility events to all the components hosted in this LithoView.
    Marked as @Deprecated to indicate this method is experimental and should not be widely used.
    NOTE: Can only be used when Incremental Mount is disabled! Call this method when the LithoView is considered eligible for the visibility event (i.e. only dispatch VisibleEvent when the LithoView is visible in its container).
    
    Parameters:
    
    visibilityEventType - The class type of the visibility event to dispatch. Supported: VisibleEvent.class, InvisibleEvent.class, FocusedVisibleEvent.class, UnfocusedVisibleEvent.class, FullImpressionVisibleEvent.class.
  - unmountAllItems
```
public void unmountAllItems()
```
  - getPreviousMountBounds
```
public Rect getPreviousMountBounds()
```
  - setMountStartupLoggingInfo
```
public void setMountStartupLoggingInfo(LithoStartupLogger startupLogger,
                                       String startupLoggerAttribution,
                                       boolean[] firstMountCalled,
                                       boolean[] lastMountCalled,
                                       boolean isLastAdapterItem,
                                       boolean isOrientationVertical)
```
  - resetMountStartupLoggingInfo
```
public void resetMountStartupLoggingInfo()
```
  - setInvalidStateLogParamsList
```
public void setInvalidStateLogParamsList(List<ComponentLogParams> logParamsList)
```
    Register for particular invalid state logs.
  - rerenderForAccessibility
```
public void rerenderForAccessibility(boolean enabled)
```
  - toString
```
public String toString()
```

Class LithoView

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class com.facebook.litho.ComponentHost

Methods inherited from class java.lang.Object

Field Detail

ZERO_HEIGHT_LOG

SET_ALREADY_ATTACHED_COMPONENT_TREE

Constructor Detail

LithoView

LithoView

LithoView

LithoView

LithoView

Method Detail

create

create

forceRelayout

startTemporaryDetach

onAttachedToWindow

onDetachedFromWindow

onAttachedToWindowForTest

onDetachedFromWindowForTest

onStartTemporaryDetach

onFinishTemporaryDetach

suppressMeasureComponentTree

setAnimatedWidth

setAnimatedHeight

onMeasure

performLayout

shouldAlwaysLayoutChildren

getComponentContext

shouldRequestLayout

getComponentTree

setOnDirtyMountListener

setOnPostDrawListener

setComponentTree

setComponent

setComponentWithoutReconciliation

setComponentAsync

setComponentAsyncWithoutReconciliation

rebind

unbind

setVisibilityHint

setHasTransientState

offsetTopAndBottom

offsetLeftAndRight

setTranslationX

setTranslationY

draw

notifyVisibleBoundsChanged

notifyVisibleBoundsChanged

isIncrementalMountEnabled

release

dispatchVisibilityEvent

unmountAllItems

getPreviousMountBounds

setMountStartupLoggingInfo

resetMountStartupLoggingInfo

setInvalidStateLogParamsList

rerenderForAccessibility

toString