android.support.v17.leanback.widget

Support classes providing low level Leanback user interface building blocks: widgets and helpers.

The core interface to the developer’s model is the ObjectAdapter. It is similar to Adapter and the RecyclerView Adapter, but separates iterating items from presenting them as Views. Concrete implementations include ArrayObjectAdapter and CursorObjectAdapter, but a developer is free to use a subclass of an ObjectAdapter to iterate over any existing Object hierarchy.

A Presenter creates Views and binds data from an Object to those Views. This is the complementary piece to ObjectAdapter that corresponds to existing Android adapter classes. The benefit to separating out a Presenter is that we can use it to generate Views outside of the context of an adapter. For example, a UI may represent data from a single Object in several places at once. Each View that needs to be generated can be produced by a different Presenter, while the Object is retrieved from the ObjectAdapter once.

A PresenterSelector determines which Presenter to use for a given Object from an ObjectAdapter. Two common cases are when an ObjectAdapter uses the same View type for every element (SinglePresenterSelector), and when the Presenter is determined by the Java class of the element (ClassPresenterSelector). A developer is able to implement any selection logic as a PresenterSelector. For example, if all the elements of an ObjectAdapter have the same type, but certain elements are to be rendered using a 'promotional content' view in the developer’s application, the PresenterSelector may inspect the fields of each element before choosing the appropriate Presenter.

The basic navigation model for Leanback is that of a vertical list of rows, each of which may be a horizontal list of items. Therefore, Leanback uses ObjectAdapters both for defining the horizontal data items as well as the list of rows themselves.

Leanback defines a few basic data model classes for rows: the Row, which defines the abstract concept of a row with a header; and ListRow, a concrete Row implementation that uses an ObjectAdapter to present a horizontal list of items. The corresponding presenter for the ListRow is the ListRowPresenter.

Other types of Rows and corresponding RowPresenters are provided; however the application may define a custom subclass of Row and RowPresenter.

Interfaces

BaseGridView.OnKeyInterceptListener	Listener for intercepting key dispatch events.
BaseGridView.OnMotionInterceptListener	Listener for intercepting generic motion dispatch events.
BaseGridView.OnTouchInterceptListener	Listener for intercepting touch dispatch events.
BaseGridView.OnUnhandledKeyListener
BaseOnItemViewClickedListener<T>	Interface for receiving notification when an item view holder is clicked.
BaseOnItemViewSelectedListener<T>	Interface for receiving notification when a row or item becomes selected.
BrowseFrameLayout.OnChildFocusListener	Interface for managing child focus in a BrowseFrameLayout.
BrowseFrameLayout.OnFocusSearchListener	Interface for selecting a focused view in a BrowseFrameLayout when the system focus finder couldn't find a view to focus.
FacetProvider	This is the query interface to supply optional features(aka facets) on an object without the need of letting the object to subclass or implement java interfaces.
FacetProviderAdapter	Optional interface that implemented by RecyclerView.Adapter to query FacetProvider for a given type within Adapter.
FocusHighlight	Interface for highlighting the item that has focus.
FragmentAnimationProvider	FragmentAnimationProvider supplies animations for use during a fragment's onCreateAnimator callback.
ImeKeyMonitor	Interface for an EditText subclass that can delegate calls to onKeyPreIme up to a registered listener.
ImeKeyMonitor.ImeKeyListener	Listener interface for key events intercepted pre-IME by edit text objects.
MultiActionsProvider	An interface implemented by the user if they wish to provide actions for a media item row to be displayed by an AbstractMediaItemPresenter.
OnActionClickedListener	Interface for receiving notification when an Action is clicked.
OnChildLaidOutListener	Interface for receiving notification when a child of this ViewGroup has been laid out.
OnChildSelectedListener	This interface was deprecated in API level 24.1.0. Use OnChildViewHolderSelectedListener
OnItemViewClickedListener	Interface for receiving notification when a item view holder is clicked.
OnItemViewSelectedListener	Interface for receiving notification when a row or item becomes selected.
PlaybackSeekUi	Interface to be implemented by UI component to support seeking.
SearchBar.SearchBarListener	Interface for receiving notification of search query changes.
SearchBar.SearchBarPermissionListener	Interface that handles runtime permissions requests.
SearchEditText.OnKeyboardDismissListener	Interface for receiving notification when the keyboard is dismissed.
SpeechRecognitionCallback	This interface was deprecated in API level 27.1.0. Launching voice recognition activity is no longer supported. App should declare android.permission.RECORD_AUDIO in AndroidManifest file. See details in SearchSupportFragment.
TitleViewAdapter.Provider	Interface to be implemented by a customized widget class to implement TitleViewAdapter.
ViewHolderTask	Interface for schedule task on a ViewHolder.

Classes

AbstractDetailsDescriptionPresenter	An abstract Presenter for rendering a detailed description of an item.
AbstractDetailsDescriptionPresenter.ViewHolder	The ViewHolder for the AbstractDetailsDescriptionPresenter.
AbstractMediaItemPresenter	Abstract Presenter class for rendering media items in a playlist format.
AbstractMediaItemPresenter.ViewHolder	The ViewHolder for the AbstractMediaItemPresenter.
AbstractMediaListHeaderPresenter	Abstract presenter class for rendering the header for a list of media items in a playlist.
AbstractMediaListHeaderPresenter.ViewHolder	The ViewHolder for the AbstractMediaListHeaderPresenter.
Action	An action contains one or two lines of text, an optional image and an optional id.
ArrayObjectAdapter	An ObjectAdapter implemented with an ArrayList.
BaseCardView	A card style layout that responds to certain state changes.
BaseCardView.LayoutParams	Per-child layout information associated with BaseCardView.
BaseGridView	An abstract base class for vertically and horizontally scrolling lists.
BrowseFrameLayout	A ViewGroup for managing focus behavior between overlapping views.
ClassPresenterSelector	A ClassPresenterSelector selects a Presenter based on the item's Java class.
ControlButtonPresenterSelector	Displays primary and secondary controls for a PlaybackControlsRow.
CursorObjectAdapter	An ObjectAdapter implemented with a Cursor.
DetailsOverviewLogoPresenter	Presenter that responsible to create a ImageView and bind to DetailsOverviewRow.
DetailsOverviewLogoPresenter.ViewHolder	ViewHolder for Logo view of DetailsOverviewRow.
DetailsOverviewRow	An overview Row for a details fragment.
DetailsOverviewRow.Listener	Listener for changes of DetailsOverviewRow.
DetailsOverviewRowPresenter	This class was deprecated in API level 24.1.0. Use FullWidthDetailsOverviewRowPresenter
DetailsOverviewRowPresenter.ViewHolder	A ViewHolder for the DetailsOverviewRow.
DetailsParallax	Subclass of Parallax object that tracks overview row's top and bottom edge in DetailsFragment or DetailsSupportFragment.
DiffCallback<Value>	Callback that informs ArrayObjectAdapter how to compute list updates when using DiffUtil in setItems(List, DiffCallback) method.
DividerPresenter	DividerPresenter provides a default presentation for DividerRow in HeadersFragment.
DividerRow	Used to represent divider in HeadersFragment.
FocusHighlightHelper	Sets up the highlighting behavior when an item gains focus.
FullWidthDetailsOverviewRowPresenter	Renders a DetailsOverviewRow to display an overview of an item.
FullWidthDetailsOverviewRowPresenter.Listener	Listeners for events on ViewHolder.
FullWidthDetailsOverviewRowPresenter.ViewHolder	A ViewHolder for the DetailsOverviewRow.
FullWidthDetailsOverviewRowPresenter.ViewHolder.DetailsOverviewRowListener
FullWidthDetailsOverviewSharedElementHelper	Helper class to assist delayed shared element activity transition for view created by FullWidthDetailsOverviewRowPresenter.
GuidanceStylist	GuidanceStylist is used within a GuidedStepFragment to display contextual information for the decision(s) required at that step.
GuidanceStylist.Guidance	A data class representing contextual information for a GuidedStepFragment.
GuidedAction	A data class which represents an action within a GuidedStepFragment.
GuidedAction.Builder	Builds a GuidedAction object.
GuidedAction.BuilderBase<B extends BuilderBase>	Base builder class to build a GuidedAction object.
GuidedActionDiffCallback	DiffCallback used for GuidedActions, see setActionsDiffCallback(DiffCallback).
GuidedActionEditText	A custom EditText that satisfies the IME key monitoring requirements of GuidedStepFragment.
GuidedActionsStylist	GuidedActionsStylist is used within a GuidedStepFragment to supply the right-side panel where users can take actions.
GuidedActionsStylist.ViewHolder	ViewHolder caches information about the action item layouts' subviews.
GuidedDatePickerAction	Subclass of GuidedAction that can choose a date.
GuidedDatePickerAction.Builder	Builder class to build a GuidedDatePickerAction.
GuidedDatePickerAction.BuilderBase<B extends BuilderBase>	Base Builder class to build GuidedDatePickerAction.
HeaderItem	A header item describes the metadata of a Row, such as a category of media items.
HorizontalGridView	A ViewGroup that shows items in a horizontal scrolling list.
HorizontalHoverCardSwitcher	A helper class for showing a hover card view below a HorizontalGridView.
ImageCardView	A subclass of BaseCardView with an ImageView as its main region.
ItemAlignmentFacet	Optional facet provided by RecyclerView.Adapter or RecyclerView.ViewHolder for use in HorizontalGridView and VerticalGridView.
ItemAlignmentFacet.ItemAlignmentDef	Definition of an alignment position under a view.
ItemBridgeAdapter	Bridge from Presenter to RecyclerView.Adapter.
ItemBridgeAdapter.AdapterListener	Interface for listening to ViewHolder operations.
ItemBridgeAdapter.ViewHolder	ViewHolder for the ItemBridgeAdapter.
ItemBridgeAdapter.Wrapper	Interface for wrapping a view created by a Presenter into another view.
ItemBridgeAdapterShadowOverlayWrapper	A wrapper class working with ItemBridgeAdapter to wrap item view in a ShadowOverlayContainer.
ListRow	A Row composed of a optional HeaderItem, and an ObjectAdapter describing the items in the list.
ListRowHoverCardView	ListRowHoverCardView contains a title and description.
ListRowPresenter	ListRowPresenter renders ListRow using a HorizontalGridView hosted in a ListRowView.
ListRowPresenter.SelectItemViewHolderTask	A task on the ListRowPresenter.ViewHolder that can select an item by position in the HorizontalGridView and perform an optional item task on it.
ListRowPresenter.ViewHolder	ViewHolder for the ListRowPresenter.
ListRowView	ListRowView is a ViewGroup which always contains a HorizontalGridView, and may optionally include a hover card.