Summary: Inherited Constants | Ctors | Methods | Protected Methods | Inherited Methods

DetailsFragment

Kotlin |Java

public class DetailsFragment
extends BaseFragment

java.lang.Object
↳	android.app.Fragment
	↳	androidx.leanback.app.BrandedFragment
		↳	androidx.leanback.app.BaseFragment
			↳	androidx.leanback.app.DetailsFragment

This class is deprecated.
use DetailsSupportFragment

A fragment for creating Leanback details screens.

A DetailsFragment renders the elements of its ObjectAdapter as a set of rows in a vertical list.The Adapter's PresenterSelector must maintain subclasses of RowPresenter.

When FullWidthDetailsOverviewRowPresenter is found in adapter, DetailsFragment will setup default behavior of the DetailsOverviewRow:

The alignment of FullWidthDetailsOverviewRowPresenter is setup in setupDetailsOverviewRowPresenter(FullWidthDetailsOverviewRowPresenter).

The view status switching of FullWidthDetailsOverviewRowPresenter is done in

onSetDetailsOverviewRowStatus(FullWidthDetailsOverviewRowPresenter, FullWidthDetailsOverviewRowPresenter.ViewHolder, int, int, int)

The recommended activity themes to use with a DetailsFragment are

R.style.Theme_Leanback_Details with activity shared element transition for FullWidthDetailsOverviewRowPresenter.

R.style.Theme_Leanback_Details_NoSharedElementTransition if shared element transition is not needed, for example if first row is not rendered by FullWidthDetailsOverviewRowPresenter.

DetailsFragment can use DetailsFragmentBackgroundController to add a parallax drawable background and embedded video playing fragment.

Summary

Inherited constants

From interface android.content.ComponentCallbacks2

`int`	`TRIM_MEMORY_BACKGROUND`
`int`	`TRIM_MEMORY_COMPLETE`
`int`	`TRIM_MEMORY_MODERATE`
`int`	`TRIM_MEMORY_RUNNING_CRITICAL`
`int`	`TRIM_MEMORY_RUNNING_LOW`
`int`	`TRIM_MEMORY_RUNNING_MODERATE`
`int`	`TRIM_MEMORY_UI_HIDDEN`

Public constructors
`DetailsFragment()`

Public methods
`ObjectAdapter`	`getAdapter()` Returns the list of rows.
`BaseOnItemViewClickedListener`	`getOnItemViewClickedListener()` Returns the item clicked listener.
`DetailsParallax`	`getParallax()` Returns the `DetailsParallax` instance used by `DetailsFragmentBackgroundController` to configure parallax effect of background and control embedded video playback.
`RowsFragment`	`getRowsFragment()` Gets embedded RowsFragment showing multiple rows for DetailsFragment.
`void`	`onCreate(Bundle savedInstanceState)`
`View`	`onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)`
`View`	`onInflateTitleView(LayoutInflater inflater, ViewGroup parent, Bundle savedInstanceState)` Called by `installTitleView(LayoutInflater, ViewGroup, Bundle)` to inflate title view.
`void`	`onStart()`
`void`	`onStop()`
`void`	`setAdapter(ObjectAdapter adapter)` Sets the list of rows for the fragment.
`void`	`setOnItemViewClickedListener(BaseOnItemViewClickedListener listener)` Sets an item clicked listener.
`void`	`setOnItemViewSelectedListener(BaseOnItemViewSelectedListener listener)` Sets an item selection listener.
`void`	`setSelectedPosition(int position)` Sets the selected row position with smooth animation.
`void`	`setSelectedPosition(int position, boolean smooth)` Sets the selected row position.

Protected methods
`Object`	`createEntranceTransition()` Create entrance transition.
`View`	`inflateTitle(LayoutInflater inflater, ViewGroup parent, Bundle savedInstanceState)` This method is deprecated. override `onInflateTitleView(LayoutInflater, ViewGroup, Bundle)` instead.
`void`	`onEntranceTransitionEnd()` Callback when entrance transition is ended.
`void`	`onEntranceTransitionPrepare()` Callback when entrance transition is prepared.
`void`	`onEntranceTransitionStart()` Callback when entrance transition is started.
`void`	`onSetDetailsOverviewRowStatus(FullWidthDetailsOverviewRowPresenter presenter, FullWidthDetailsOverviewRowPresenter.ViewHolder viewHolder, int adapterPosition, int selectedPosition, int selectedSubPosition)` Called to change DetailsOverviewRow view status when current selected row position or selected sub position changed.
`void`	`onSetRowStatus(RowPresenter presenter, RowPresenter.ViewHolder viewHolder, int adapterPosition, int selectedPosition, int selectedSubPosition)` Called on every visible row to change view status when current selected row position or selected sub position changed.
`void`	`runEntranceTransition(Object entranceTransition)` Run entrance transition.
`void`	`setupDetailsOverviewRowPresenter(FullWidthDetailsOverviewRowPresenter presenter)` Called to setup `FullWidthDetailsOverviewRowPresenter`.
`void`	`setupPresenter(Presenter rowPresenter)` Called to setup each Presenter of Adapter passed in `setAdapter(ObjectAdapter)`.Note that setup should only change the Presenter behavior that is meaningful in DetailsFragment.

Inherited methods

From class


        
          androidx.leanback.app.BaseFragment

`Object`	`createEntranceTransition()` Create entrance transition.
`final ProgressBarManager`	`getProgressBarManager()` Returns the `ProgressBarManager`.
`void`	`onCreate(Bundle savedInstanceState)`
`void`	`onEntranceTransitionEnd()` Callback when entrance transition is ended.
`void`	`onEntranceTransitionPrepare()` Callback when entrance transition is prepared.
`void`	`onEntranceTransitionStart()` Callback when entrance transition is started.
`void`	`onViewCreated(View view, Bundle savedInstanceState)`
`void`	`prepareEntranceTransition()` Enables entrance transition.
`void`	`runEntranceTransition(Object entranceTransition)` Run entrance transition.
`void`	`startEntranceTransition()` When fragment finishes loading data, it should call startEntranceTransition() to execute the entrance transition.

From class


        
          androidx.leanback.app.BrandedFragment

`Drawable`	`getBadgeDrawable()` Returns the badge drawable used in the fragment title.
`int`	`getSearchAffordanceColor()` Returns the color used to draw the search affordance.
`SearchOrbView.Colors`	`getSearchAffordanceColors()` Returns the `SearchOrbView.Colors` used to draw the search affordance.
`CharSequence`	`getTitle()` Returns the title text for the fragment.
`View`	`getTitleView()` Returns the view that implements `TitleViewAdapter.Provider`.
`TitleViewAdapter`	`getTitleViewAdapter()` Returns the `TitleViewAdapter` implemented by title view.
`void`	`installTitleView(LayoutInflater inflater, ViewGroup parent, Bundle savedInstanceState)` Inflate title view and add to parent.
`final boolean`	`isShowingTitle()` Returns true/false to indicate the visibility of TitleView.
`void`	`onDestroyView()`
`View`	`onInflateTitleView(LayoutInflater inflater, ViewGroup parent, Bundle savedInstanceState)` Called by `installTitleView(LayoutInflater, ViewGroup, Bundle)` to inflate title view.
`void`	`onPause()`
`void`	`onResume()`
`void`	`onSaveInstanceState(Bundle outState)`
`void`	`onStart()`
`void`	`onViewCreated(View view, Bundle savedInstanceState)`
`void`	`setBadgeDrawable(Drawable drawable)` Sets the drawable displayed in the fragment title.
`void`	`setOnSearchClickedListener(View.OnClickListener listener)` Sets a click listener for the search affordance.
`void`	`setSearchAffordanceColor(int color)` Sets the color used to draw the search affordance.
`void`	`setSearchAffordanceColors(SearchOrbView.Colors colors)` Sets the `SearchOrbView.Colors` used to draw the search affordance.
`void`	`setTitle(CharSequence title)` Sets title text for the fragment.
`void`	`setTitleView(View titleView)` Sets the view that implemented `TitleViewAdapter`.
`void`	`showTitle(int flags)` Changes title view's components visibility and shows title.
`void`	`showTitle(boolean show)` Shows or hides the title view.

From class


        
          android.app.Fragment

`void`	`dump(String arg0, FileDescriptor arg1, PrintWriter arg2, String[] arg3)`
`final boolean`	`equals(Object arg0)`
`final Activity`	`getActivity()`
`boolean`	`getAllowEnterTransitionOverlap()`
`boolean`	`getAllowReturnTransitionOverlap()`
`final Bundle`	`getArguments()`
`final FragmentManager`	`getChildFragmentManager()`
`Context`	`getContext()`
`Transition`	`getEnterTransition()`
`Transition`	`getExitTransition()`
`final FragmentManager`	`getFragmentManager()`
`final Object`	`getHost()`
`final int`	`getId()`
`final LayoutInflater`	`getLayoutInflater()`
`LoaderManager`	`getLoaderManager()`
`final Fragment`	`getParentFragment()`
`Transition`	`getReenterTransition()`
`final Resources`	`getResources()`
`final boolean`	`getRetainInstance()`
`Transition`	`getReturnTransition()`
`Transition`	`getSharedElementEnterTransition()`
`Transition`	`getSharedElementReturnTransition()`
`final String`	`getString(int arg0, Object... arg1)`
`final String`	`getString(int arg0)`
`final String`	`getTag()`
`final Fragment`	`getTargetFragment()`
`final int`	`getTargetRequestCode()`
`final CharSequence`	`getText(int arg0)`
`boolean`	`getUserVisibleHint()`
`View`	`getView()`
`final int`	`hashCode()`
`static Fragment`	`instantiate(Context arg0, String arg1)`
`static Fragment`	`instantiate(Context arg0, String arg1, Bundle arg2)`
`final boolean`	`isAdded()`
`final boolean`	`isDetached()`
`final boolean`	`isHidden()`
`final boolean`	`isInLayout()`
`final boolean`	`isRemoving()`
`final boolean`	`isResumed()`
`final boolean`	`isStateSaved()`
`final boolean`	`isVisible()`
`void`	`onActivityCreated(Bundle arg0)`
`void`	`onActivityResult(int arg0, int arg1, Intent arg2)`
`void`	`onAttach(Activity arg0)`
`void`	`onAttach(Context arg0)`
`void`	`onAttachFragment(Fragment arg0)`
`void`	`onConfigurationChanged(Configuration arg0)`
`boolean`	`onContextItemSelected(MenuItem arg0)`
`void`	`onCreate(Bundle arg0)`
`Animator`	`onCreateAnimator(int arg0, boolean arg1, int arg2)`
`void`	`onCreateContextMenu(ContextMenu arg0, View arg1, ContextMenu.ContextMenuInfo arg2)`
`void`	`onCreateOptionsMenu(Menu arg0, MenuInflater arg1)`
`View`	`onCreateView(LayoutInflater arg0, ViewGroup arg1, Bundle arg2)`
`void`	`onDestroy()`
`void`	`onDestroyOptionsMenu()`
`void`	`onDestroyView()`
`void`	`onDetach()`
`LayoutInflater`	`onGetLayoutInflater(Bundle arg0)`
`void`	`onHiddenChanged(boolean arg0)`
`void`	`onInflate(AttributeSet arg0, Bundle arg1)`
`void`	`onInflate(Activity arg0, AttributeSet arg1, Bundle arg2)`
`void`	`onInflate(Context arg0, AttributeSet arg1, Bundle arg2)`
`void`	`onLowMemory()`
`void`	`onMultiWindowModeChanged(boolean arg0)`
`void`	`onMultiWindowModeChanged(boolean arg0, Configuration arg1)`
`boolean`	`onOptionsItemSelected(MenuItem arg0)`
`void`	`onOptionsMenuClosed(Menu arg0)`
`void`	`onPause()`
`void`	`onPictureInPictureModeChanged(boolean arg0, Configuration arg1)`
`void`	`onPictureInPictureModeChanged(boolean arg0)`
`void`	`onPrepareOptionsMenu(Menu arg0)`
`void`	`onRequestPermissionsResult(int arg0, String[] arg1, int[] arg2)`
`void`	`onResume()`
`void`	`onSaveInstanceState(Bundle arg0)`
`void`	`onStart()`
`void`	`onStop()`
`void`	`onTrimMemory(int arg0)`
`void`	`onViewCreated(View arg0, Bundle arg1)`
`void`	`onViewStateRestored(Bundle arg0)`
`void`	`postponeEnterTransition()`
`void`	`registerForContextMenu(View arg0)`
`final void`	`requestPermissions(String[] arg0, int arg1)`
`void`	`setAllowEnterTransitionOverlap(boolean arg0)`
`void`	`setAllowReturnTransitionOverlap(boolean arg0)`
`void`	`setArguments(Bundle arg0)`
`void`	`setEnterSharedElementCallback(SharedElementCallback arg0)`
`void`	`setEnterTransition(Transition arg0)`
`void`	`setExitSharedElementCallback(SharedElementCallback arg0)`
`void`	`setExitTransition(Transition arg0)`
`void`	`setHasOptionsMenu(boolean arg0)`
`void`	`setInitialSavedState(Fragment.SavedState arg0)`
`void`	`setMenuVisibility(boolean arg0)`
`void`	`setReenterTransition(Transition arg0)`
`void`	`setRetainInstance(boolean arg0)`
`void`	`setReturnTransition(Transition arg0)`
`void`	`setSharedElementEnterTransition(Transition arg0)`
`void`	`setSharedElementReturnTransition(Transition arg0)`
`void`	`setTargetFragment(Fragment arg0, int arg1)`
`void`	`setUserVisibleHint(boolean arg0)`
`boolean`	`shouldShowRequestPermissionRationale(String arg0)`
`void`	`startActivity(Intent arg0)`
`void`	`startActivity(Intent arg0, Bundle arg1)`
`void`	`startActivityForResult(Intent arg0, int arg1)`
`void`	`startActivityForResult(Intent arg0, int arg1, Bundle arg2)`
`void`	`startIntentSenderForResult(IntentSender arg0, int arg1, Intent arg2, int arg3, int arg4, int arg5, Bundle arg6)`
`void`	`startPostponedEnterTransition()`
`String`	`toString()`
`void`	`unregisterForContextMenu(View arg0)`

From class


        
          java.lang.Object

`Object`	`clone()`
`boolean`	`equals(Object arg0)`
`void`	`finalize()`
`final Class<?>`	`getClass()`
`int`	`hashCode()`
`final void`	`notify()`
`final void`	`notifyAll()`
`String`	`toString()`
`final void`	`wait(long arg0, int arg1)`
`final void`	`wait(long arg0)`
`final void`	`wait()`

From interface


        
          android.content.ComponentCallbacks2

abstract void onTrimMemory(int arg0)

From interface


        
          android.view.View.OnCreateContextMenuListener

abstract void onCreateContextMenu(ContextMenu arg0, View arg1, ContextMenu.ContextMenuInfo arg2)

From interface


        
          android.content.ComponentCallbacks

`abstract void`	`onConfigurationChanged(Configuration arg0)`
`abstract void`	`onLowMemory()`

Public constructors

DetailsFragment

public DetailsFragment ()

Public methods

getAdapter

public ObjectAdapter getAdapter ()

Returns the list of rows.

Returns
`ObjectAdapter`

getOnItemViewClickedListener

public BaseOnItemViewClickedListener getOnItemViewClickedListener ()

Returns the item clicked listener.

Returns
`BaseOnItemViewClickedListener`

getParallax

public DetailsParallax getParallax ()

Returns the DetailsParallax instance used by DetailsFragmentBackgroundController to configure parallax effect of background and control embedded video playback. App usually does not use this method directly. App may use this method for other custom parallax tasks.

Returns
`DetailsParallax`	The DetailsParallax instance attached to the DetailsFragment.

getRowsFragment

public RowsFragment getRowsFragment ()

Gets embedded RowsFragment showing multiple rows for DetailsFragment. If view of DetailsFragment is not created, the method returns null.

Returns
`RowsFragment`	Embedded RowsFragment showing multiple rows for DetailsFragment.

onCreate

public void onCreate (Bundle savedInstanceState)

Parameters
`savedInstanceState`	`Bundle`

onCreateView

public View onCreateView (LayoutInflater inflater, 
                ViewGroup container, 
                Bundle savedInstanceState)

Parameters
`inflater`	`LayoutInflater`
`container`	`ViewGroup`
`savedInstanceState`	`Bundle`

Returns
`View`

onInflateTitleView

public View onInflateTitleView (LayoutInflater inflater, 
                ViewGroup parent, 
                Bundle savedInstanceState)

Called by installTitleView(LayoutInflater, ViewGroup, Bundle) to inflate title view. Default implementation uses layout file lb_browse_title. Subclass may override and use its own layout, the layout must have a descendant with id browse_title_group that implements TitleViewAdapter.Provider. Subclass may return null if no title is needed.

Parameters
`inflater`	`LayoutInflater`: The LayoutInflater object that can be used to inflate any views in the fragment,
`parent`	`ViewGroup`: Parent of title view.
`savedInstanceState`	`Bundle`: If non-null, this fragment is being re-constructed from a previous saved state as given here.

Returns
`View`	Title view which must have a descendant with id browse_title_group that implements `TitleViewAdapter.Provider`, or null for no title view.

onStart

public void onStart ()

onStop

public void onStop ()

public void setAdapter (ObjectAdapter adapter)

Sets the list of rows for the fragment.

Parameters
`adapter`	`ObjectAdapter`

public void setOnItemViewClickedListener (BaseOnItemViewClickedListener listener)

Sets an item clicked listener.

Parameters
`listener`	`BaseOnItemViewClickedListener`

public void setOnItemViewSelectedListener (BaseOnItemViewSelectedListener listener)

Sets an item selection listener.

Parameters
`listener`	`BaseOnItemViewSelectedListener`

setSelectedPosition

public void setSelectedPosition (int position)

Sets the selected row position with smooth animation.

Parameters
`position`	`int`

setSelectedPosition

public void setSelectedPosition (int position, 
                boolean smooth)

Sets the selected row position.

Parameters
`position`	`int`
`smooth`	`boolean`

Protected methods

createEntranceTransition

protected Object createEntranceTransition ()

Create entrance transition. Subclass can override to load transition from resource or construct manually. Typically app does not need to override the default transition that browse and details provides.

Returns
`Object`

inflateTitle

protected View inflateTitle (LayoutInflater inflater, 
                ViewGroup parent, 
                Bundle savedInstanceState)

This method is deprecated.
override onInflateTitleView(LayoutInflater, ViewGroup, Bundle) instead.

Parameters
`inflater`	`LayoutInflater`
`parent`	`ViewGroup`
`savedInstanceState`	`Bundle`

Returns
`View`

onEntranceTransitionEnd

protected void onEntranceTransitionEnd ()

Callback when entrance transition is ended.

onEntranceTransitionPrepare

protected void onEntranceTransitionPrepare ()

Callback when entrance transition is prepared. This is when fragment should stop user input and animations.

onEntranceTransitionStart

protected void onEntranceTransitionStart ()

Callback when entrance transition is started. This is when fragment should stop processing layout.

protected void onSetDetailsOverviewRowStatus (FullWidthDetailsOverviewRowPresenter presenter, 
                FullWidthDetailsOverviewRowPresenter.ViewHolder viewHolder, 
                int adapterPosition, 
                int selectedPosition, 
                int selectedSubPosition)

Called to change DetailsOverviewRow view status when current selected row position or selected sub position changed. Subclass may override. The default implementation switches between three states based on the positions: FullWidthDetailsOverviewRowPresenter.STATE_HALF, FullWidthDetailsOverviewRowPresenter.STATE_FULL and FullWidthDetailsOverviewRowPresenter.STATE_SMALL.

Parameters
`presenter`	`FullWidthDetailsOverviewRowPresenter`: The presenter used to create row ViewHolder.
`viewHolder`	`FullWidthDetailsOverviewRowPresenter.ViewHolder`: The visible (attached) row ViewHolder, note that it may or may not be selected.
`adapterPosition`	`int`: The adapter position of viewHolder inside adapter.
`selectedPosition`	`int`: The adapter position of currently selected row.
`selectedSubPosition`	`int`: The sub position within currently selected row. This is used When a row has multiple alignment positions.

protected void onSetRowStatus (RowPresenter presenter, 
                RowPresenter.ViewHolder viewHolder, 
                int adapterPosition, 
                int selectedPosition, 
                int selectedSubPosition)

Called on every visible row to change view status when current selected row position or selected sub position changed. Subclass may override. The default implementation calls onSetDetailsOverviewRowStatus(FullWidthDetailsOverviewRowPresenter, FullWidthDetailsOverviewRowPresenter.ViewHolder, int, int, int) if presenter is instance of FullWidthDetailsOverviewRowPresenter.

Parameters
`presenter`	`RowPresenter`: The presenter used to create row ViewHolder.
`viewHolder`	`RowPresenter.ViewHolder`: The visible (attached) row ViewHolder, note that it may or may not be selected.
`adapterPosition`	`int`: The adapter position of viewHolder inside adapter.
`selectedPosition`	`int`: The adapter position of currently selected row.
`selectedSubPosition`	`int`: The sub position within currently selected row. This is used When a row has multiple alignment positions.

runEntranceTransition

protected void runEntranceTransition (Object entranceTransition)

Run entrance transition. Subclass may use TransitionManager to perform go(Scene) or beginDelayedTransition(). App should not override the default implementation of browse and details fragment.

Parameters
`entranceTransition`	`Object`

protected void setupDetailsOverviewRowPresenter (FullWidthDetailsOverviewRowPresenter presenter)

Called to setup FullWidthDetailsOverviewRowPresenter. The default implementation adds two alignment positions(ItemAlignmentFacet) for ViewHolder of FullWidthDetailsOverviewRowPresenter to align in fragment.

Parameters
`presenter`	`FullWidthDetailsOverviewRowPresenter`

protected void setupPresenter (Presenter rowPresenter)

Called to setup each Presenter of Adapter passed in setAdapter(ObjectAdapter).Note that setup should only change the Presenter behavior that is meaningful in DetailsFragment. For example how a row is aligned in details Fragment. The default implementation invokes setupDetailsOverviewRowPresenter(FullWidthDetailsOverviewRowPresenter)

Parameters
`rowPresenter`	`Presenter`