com.facebook.litho.sections.widget

Class RecyclerCollectionComponent

java.lang.Object

com.facebook.litho.ComponentLifecycle

com.facebook.litho.Component

com.facebook.litho.sections.widget.RecyclerCollectionComponent

All Implemented Interfaces:

Equivalence<Component>, EventDispatcher, EventTriggerTarget, HasEventDispatcher, HasEventTrigger, Cloneable

public final class RecyclerCollectionComponent
extends Component

A Component that renders a Recycler backed by a Section tree. See recycler-collection-component for details.

This Component handles the loading events from the Section hierarchy and shows the appropriate error,loading or empty Component passed in as props. If either the empty or the error components are not passed in and the RecyclerCollectionComponent is in one of these states it will simply not render anything.

The RecyclerCollectionComponent also exposes a LoadEventsHandler and a OnScrollListener as Props so its users can receive events about the state of the loading and about the state of the Recycler scrolling.

clipToPadding, clipChildren, itemDecoration, scrollBarStyle, horizontalPadding, verticalPadding and recyclerViewId Props will be directly applied to the Recycler component.

The RecyclerCollectionEventsController Prop is a way to send commands to the RecyclerCollectionComponentSpec, such as scrollTo(position) and refresh().

To trigger scrolling from the Section use SectionLifecycle#requestFocus(SectionContext, int). See communicating-with-the-ui for details.

See Also:

com.facebook.litho.sections.widget.RecyclerCollectionComponentSpec

Required Props

section

Type:

com.facebook.litho.sections.Section

Optional Props

asyncPropUpdates

Type:

boolean

asyncStateUpdates

Type:

boolean

bottomPadding

Type:

int

canMeasureRecycler

Type:

boolean

clipChildren

Type:

boolean

clipToPadding

Type:

boolean

disablePTR

Type:

boolean

emptyComponent

Type:

com.facebook.litho.Component

errorComponent

Type:

com.facebook.litho.Component

eventsController

Type:

com.facebook.litho.sections.widget.RecyclerCollectionEventsController

fadingEdgeLength

Type:

int

forceSyncStateUpdates

Type:

boolean

horizontalFadingEdgeEnabled

Type:

boolean

ignoreLoadingUpdates

Type:

boolean

incrementalMount

Type:

boolean

itemAnimator

This prop defines the animations that take place on items as changes are made. To remove change animation use {@link NoUpdateItemAnimator}. To completely disable all animations use {@link NotAnimatedItemAnimator}.

Type:

androidx.recyclerview.widget.RecyclerView.ItemAnimator

itemDecoration

Type:

androidx.recyclerview.widget.RecyclerView.ItemDecoration

leftPadding

Type:

int

loadEventsHandler

Type:

com.facebook.litho.sections.LoadEventsHandler

loadingComponent

Type:

com.facebook.litho.Component

nestedScrollingEnabled

Type:

boolean

onScrollListeners

Type:

java.util.List

overScrollMode

Type:

int

recyclerConfiguration

Type:

com.facebook.litho.sections.widget.RecyclerConfiguration

recyclerTouchEventHandler

Type:

com.facebook.litho.EventHandler

recyclerViewId

Type:

int

refreshProgressBarBackgroundColor

Type:

java.lang.Integer

refreshProgressBarColor

Type:

int

rightPadding

Type:

int

scrollBarStyle

Type:

int

sectionTreeTag

Type:

java.lang.String

setRootAsync

Type:

boolean

startupLogger

Type:

com.facebook.litho.LithoStartupLogger

stickyHeaderControllerFactory

Type:

com.facebook.litho.widget.StickyHeaderControllerFactory

topPadding

Type:

int

touchInterceptor

Type:

com.facebook.litho.widget.LithoRecylerView.TouchInterceptor

verticalFadingEdgeEnabled

Type:

boolean

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RecyclerCollectionComponent.Builder

Nested classes/interfaces inherited from class com.facebook.litho.Component

Component.ContainerBuilder<T extends Component.ContainerBuilder<T>>

Nested classes/interfaces inherited from class com.facebook.litho.ComponentLifecycle

ComponentLifecycle.MountType, ComponentLifecycle.RenderData, ComponentLifecycle.TransitionContainer

Method Summary

Modifier and Type	Method and Description
Object	acceptTriggerEvent(EventTrigger eventTrigger, Object eventState, Object[] params)
static RecyclerCollectionComponent.Builder	create(ComponentContext context)
static RecyclerCollectionComponent.Builder	create(ComponentContext context, int defStyleAttr, int defStyleRes)
protected void	createInitialState(ComponentContext c)
Object	dispatchOnEvent(EventHandler eventHandler, Object eventState)
static EventHandler	getPTRRefreshEventHandler(ComponentContext context)
protected StateContainer	getStateContainer()
protected boolean	hasAttachDetachCallback()
protected boolean	hasState()
protected static void	lazyUpdateHasSetSectionTreeRoot(ComponentContext c, boolean lazyUpdateValue)
RecyclerCollectionComponent	makeShallowCopy()
protected Component	onCreateLayout(ComponentContext c) Generate a tree of ComponentLayout representing the layout structure of the Component and its sub-components.
protected void	onDetached(ComponentContext c) Called when the component is detached from the ComponentTree.
static void	onRecyclerConfigChanged(ComponentContext c, Handle handle, int commitPolicy)
static void	onRecyclerConfigChanged(ComponentContext c, String key, int commitPolicy)
static void	onRecyclerConfigChanged(EventTrigger trigger, int commitPolicy)
static EventTrigger	onRecyclerConfigChangedTrigger(ComponentContext c, String key) Deprecated.
static EventHandler<PTRRefreshEvent>	onRefresh(ComponentContext c, SectionTree sectionTree)
static void	onScroll(ComponentContext c, Handle handle, int position, boolean animate)
static void	onScroll(ComponentContext c, String key, int position, boolean animate)
static void	onScroll(EventTrigger trigger, int position, boolean animate)
static EventTrigger	onScrollTrigger(ComponentContext c, String key) Deprecated.
void	recordEventTrigger(EventTriggersContainer container)
protected void	transferState(StateContainer _prevStateContainer, StateContainer _nextStateContainer) Call this to transfer the State annotated values between two Component with the same global scope.
protected static void	updateLoadingState(ComponentContext c, RecyclerCollectionComponentSpec.LoadingState currentLoadingState)
protected static void	updateLoadingStateAsync(ComponentContext c, RecyclerCollectionComponentSpec.LoadingState currentLoadingState)
protected static void	updateLoadingStateSync(ComponentContext c, RecyclerCollectionComponentSpec.LoadingState currentLoadingState)

Methods inherited from class com.facebook.litho.Component

bindDynamicProp, canResolve, clearCachedLayout, copyInterStageImpl, getCommonProps, getDynamicProps, getEventDispatcher, getHandle, getId, getKey, getScopedContext, getSimpleName, getSimpleNameDelegate, hasBackgroundSet, hasClickHandlerSet, isEquivalentTo, measure, measureMightNotCacheInternalNode, registerWorkingRange, retrieveValue, setScopedContext, updateInternalChildState, willRender

Methods inherited from class com.facebook.litho.ComponentLifecycle

applyPreviousRenderData, callsShouldUpdateOnMount, canMeasure, canPreallocate, createMountContent, dispatchErrorEvent, dispatchErrorEvent, dispatchOnEnteredRange, dispatchOnExitedRange, getEventTrigger, getEventTrigger, getExtraAccessibilityNodeAt, getExtraAccessibilityNodesCount, getMountType, getTreePropsForChildren, hasChildLithoViews, implementsAccessibility, implementsExtraAccessibilityNodes, isLayoutSpecWithSizeSpecCheck, isMountSizeDependent, isPureRender, needsPreviousRenderData, newEventHandler, newEventTrigger, onAttached, onBind, onBoundsDefined, onCreateLayoutWithSizeSpec, onCreateMountContent, onCreateMountContentPool, onCreateTransition, onError, onLoadStyle, onMeasure, onMeasureBaseline, onMount, onPopulateAccessibilityNode, onPopulateExtraAccessibilityNode, onPrepare, onShouldCreateLayoutWithNewSizeSpec, onUnbind, onUnmount, poolSize, populateTreeProps, recordRenderData, resolve, shouldAlwaysRemeasure, shouldUpdate, shouldUseGlobalPool

Methods inherited from class java.lang.Object

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

Method Detail

getStateContainer

protected StateContainer getStateContainer()

Overrides:

getStateContainer in class Component

makeShallowCopy

public RecyclerCollectionComponent makeShallowCopy()

Overrides:

makeShallowCopy in class Component

onCreateLayout

protected Component onCreateLayout(ComponentContext c)

Description copied from class: ComponentLifecycle

Generate a tree of ComponentLayout representing the layout structure of the Component and its sub-components.

Overrides:

onCreateLayout in class ComponentLifecycle

Parameters:

c - The ComponentContext to build a ComponentLayout tree.

createInitialState

protected void createInitialState(ComponentContext c)

Overrides:

createInitialState in class ComponentLifecycle

onDetached

protected void onDetached(ComponentContext c)

Description copied from class: ComponentLifecycle

Called when the component is detached from the ComponentTree.

Overrides:

onDetached in class ComponentLifecycle

Parameters:

c - The ComponentContext the Component was constructed with.

hasAttachDetachCallback

protected boolean hasAttachDetachCallback()

Overrides:

hasAttachDetachCallback in class ComponentLifecycle

Returns:

true if the component implements OnAttached or OnDetached delegate methods.

getPTRRefreshEventHandler

public static EventHandler getPTRRefreshEventHandler(ComponentContext context)

onRefresh

public static EventHandler<PTRRefreshEvent> onRefresh(ComponentContext c,
                                                      SectionTree sectionTree)

dispatchOnEvent

public Object dispatchOnEvent(EventHandler eventHandler,
                              Object eventState)

Specified by:

dispatchOnEvent in interface EventDispatcher

Overrides:

dispatchOnEvent in class ComponentLifecycle

onScrollTrigger

@Deprecated
public static EventTrigger onScrollTrigger(ComponentContext c,
                                                       String key)

Deprecated.

onRecyclerConfigChangedTrigger

@Deprecated
public static EventTrigger onRecyclerConfigChangedTrigger(ComponentContext c,
                                                                      String key)

Deprecated.

onScroll

public static void onScroll(ComponentContext c,
                            Handle handle,
                            int position,
                            boolean animate)

onScroll

public static void onScroll(ComponentContext c,
                            String key,
                            int position,
                            boolean animate)

onScroll

public static void onScroll(EventTrigger trigger,
                            int position,
                            boolean animate)

onRecyclerConfigChanged

public static void onRecyclerConfigChanged(ComponentContext c,
                                           Handle handle,
                                           int commitPolicy)

onRecyclerConfigChanged

public static void onRecyclerConfigChanged(ComponentContext c,
                                           String key,
                                           int commitPolicy)

onRecyclerConfigChanged

public static void onRecyclerConfigChanged(EventTrigger trigger,
                                           int commitPolicy)

acceptTriggerEvent

public Object acceptTriggerEvent(EventTrigger eventTrigger,
                                 Object eventState,
                                 Object[] params)

Specified by:

acceptTriggerEvent in interface EventTriggerTarget

Overrides:

acceptTriggerEvent in class ComponentLifecycle

recordEventTrigger

public void recordEventTrigger(EventTriggersContainer container)

Specified by:

recordEventTrigger in interface HasEventTrigger

Overrides:

recordEventTrigger in class Component

hasState

protected boolean hasState()

Overrides:

hasState in class ComponentLifecycle

Returns:

true if the Component is using state, false otherwise.

transferState

protected void transferState(StateContainer _prevStateContainer,
                             StateContainer _nextStateContainer)

Description copied from class: ComponentLifecycle

Call this to transfer the State annotated values between two Component with the same global scope.

Overrides:

transferState in class ComponentLifecycle

updateLoadingState

protected static void updateLoadingState(ComponentContext c,
                                         RecyclerCollectionComponentSpec.LoadingState currentLoadingState)

updateLoadingStateAsync

protected static void updateLoadingStateAsync(ComponentContext c,
                                              RecyclerCollectionComponentSpec.LoadingState currentLoadingState)

updateLoadingStateSync

protected static void updateLoadingStateSync(ComponentContext c,
                                             RecyclerCollectionComponentSpec.LoadingState currentLoadingState)

lazyUpdateHasSetSectionTreeRoot

protected static void lazyUpdateHasSetSectionTreeRoot(ComponentContext c,
                                                      boolean lazyUpdateValue)

create

public static RecyclerCollectionComponent.Builder create(ComponentContext context)

create

public static RecyclerCollectionComponent.Builder create(ComponentContext context,
                                                         int defStyleAttr,
                                                         int defStyleRes)