public class ListFragment extends Fragment
ListFragment hosts a ListView
object that can
be bound to different data sources, typically either an array or a Cursor
holding query results. Binding, screen layout, and row layout are discussed
in the following sections.
Screen Layout
ListFragment has a default layout that consists of a single list view.
However, if you desire, you can customize the fragment layout by returning
your own view hierarchy from onCreateView(android.view.LayoutInflater, android.view.ViewGroup, android.os.Bundle)
.
To do this, your view hierarchy must contain a ListView object with the
id "@android:id/list" (or android.R.id#list
if it's in code)
Optionally, your view hierarchy can contain another view object of any type to display when the list view is empty. This "empty list" notifier must have an id "android:empty". Note that when an empty view is present, the list view will be hidden when there is no data to display.
The following code demonstrates an (ugly) custom list layout. It has a list with a green background, and an alternate red "no data" message.
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="match_parent" android:layout_height="match_parent" android:paddingLeft="8dp" android:paddingRight="8dp"> <ListView android:id="@id/android:list" android:layout_width="match_parent" android:layout_height="match_parent" android:background="#00FF00" android:layout_weight="1" android:drawSelectorOnTop="false"/> <TextView android:id="@id/android:empty" android:layout_width="match_parent" android:layout_height="match_parent" android:background="#FF0000" android:text="No data"/> </LinearLayout>
Row Layout
You can specify the layout of individual rows in the list. You do this by specifying a layout resource in the ListAdapter object hosted by the fragment (the ListAdapter binds the ListView to the data; more on this later).
A ListAdapter constructor takes a parameter that specifies a layout resource for each row. It also has two additional parameters that let you specify which data field to associate with which object in the row layout resource. These two parameters are typically parallel arrays.
Android provides some standard row layout resources. These are in the
android.R.layout
class, and have names such as simple_list_item_1,
simple_list_item_2, and two_line_list_item. The following layout XML is the
source for the resource two_line_list_item, which displays two data
fields,one above the other, for each list row.
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="wrap_content" android:orientation="vertical"> <TextView android:id="@+id/text1" android:textSize="16sp" android:textStyle="bold" android:layout_width="match_parent" android:layout_height="wrap_content"/> <TextView android:id="@+id/text2" android:textSize="16sp" android:layout_width="match_parent" android:layout_height="wrap_content"/> </LinearLayout>
You must identify the data bound to each TextView object in this layout. The syntax for this is discussed in the next section.
Binding to Data
You bind the ListFragment's ListView object to data using a class that
implements the ListAdapter
interface.
Android provides two standard list adapters:
SimpleAdapter
for static data (Maps),
and SimpleCursorAdapter
for Cursor
query results.
You must use
ListFragment.setListAdapter()
to
associate the list with an adapter. Do not directly call
ListView.setAdapter()
or else
important initialization will be skipped.
Fragment.InstantiationException, Fragment.SavedState
TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN
Constructor and Description |
---|
ListFragment() |
Modifier and Type | Method and Description |
---|---|
ListAdapter |
getListAdapter()
Get the ListAdapter associated with this fragment's ListView.
|
ListView |
getListView()
Get the fragment's list view widget.
|
long |
getSelectedItemId()
Get the cursor row ID of the currently selected list item.
|
int |
getSelectedItemPosition()
Get the position of the currently selected list item.
|
View |
onCreateView(LayoutInflater inflater,
ViewGroup container,
Bundle savedInstanceState)
Provide default implementation to return a simple list view.
|
void |
onDestroyView()
Detach from list view.
|
void |
onListItemClick(ListView l,
View v,
int position,
long id)
This method will be called when an item in the list is selected.
|
void |
onViewCreated(View view,
Bundle savedInstanceState)
Attach to list view once the view hierarchy has been created.
|
void |
setEmptyText(CharSequence text)
The default content for a ListFragment has a TextView that can
be shown when the list is empty.
|
void |
setListAdapter(ListAdapter adapter)
Provide the cursor for the list view.
|
void |
setListShown(boolean shown)
Control whether the list is being displayed.
|
void |
setListShownNoAnimation(boolean shown)
Like
setListShown(boolean) , but no animation is used when
transitioning from the previous state. |
void |
setSelection(int position)
Set the currently selected list item to the specified
position with the adapter's data
|
dump, equals, getActivity, getAllowEnterTransitionOverlap, getAllowReturnTransitionOverlap, getArguments, getChildFragmentManager, getContext, getEnterTransition, getExitTransition, getFragmentManager, getHost, getId, getLayoutInflater, getLoaderManager, getParentFragment, getReenterTransition, getResources, getRetainInstance, getReturnTransition, getSharedElementEnterTransition, getSharedElementReturnTransition, getString, getString, getTag, getTargetFragment, getTargetRequestCode, getText, getUserVisibleHint, getView, hashCode, instantiate, instantiate, isAdded, isDetached, isHidden, isInLayout, isRemoving, isResumed, isVisible, onActivityCreated, onActivityResult, onAttach, onAttach, onAttachFragment, onConfigurationChanged, onContextItemSelected, onCreate, onCreateAnimator, onCreateContextMenu, onCreateOptionsMenu, onDestroy, onDestroyOptionsMenu, onDetach, onHiddenChanged, onInflate, onInflate, onInflate, onLowMemory, onMultiWindowModeChanged, onOptionsItemSelected, onOptionsMenuClosed, onPause, onPictureInPictureModeChanged, onPrepareOptionsMenu, onRequestPermissionsResult, onResume, onSaveInstanceState, onStart, onStop, onTrimMemory, onViewStateRestored, registerForContextMenu, requestPermissions, setAllowEnterTransitionOverlap, setAllowReturnTransitionOverlap, setArguments, setEnterSharedElementCallback, setEnterSharedElementTransitionCallback, setEnterTransition, setExitSharedElementCallback, setExitSharedElementTransitionCallback, setExitTransition, setHasOptionsMenu, setInitialSavedState, setMenuVisibility, setReenterTransition, setRetainInstance, setReturnTransition, setSharedElementEnterTransition, setSharedElementReturnTransition, setTargetFragment, setUserVisibleHint, shouldShowRequestPermissionRationale, startActivity, startActivity, startActivityForResult, startActivityForResult, startIntentSenderForResult, toString, unregisterForContextMenu
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
android.R.id.list
and can optionally
have a sibling view id android.R.id.empty
that is to be shown when the list is empty.
If you are overriding this method with your own custom content,
consider including the standard layout android.R.layout#list_content
in your layout file, so that you continue to retain all of the standard
behavior of ListFragment. In particular, this is currently the only
way to have the built-in indeterminant progress state be shown.
onCreateView
in class Fragment
inflater
- The LayoutInflater object that can be used to inflate
any views in the fragment,container
- If non-null, this is the parent view that the fragment's
UI should be attached to. The fragment should not add the view itself,
but this can be used to generate the LayoutParams of the view.savedInstanceState
- If non-null, this fragment is being re-constructed
from a previous saved state as given here.public void onViewCreated(View view, Bundle savedInstanceState)
onViewCreated
in class Fragment
view
- The View returned by Fragment.onCreateView(LayoutInflater, ViewGroup, Bundle)
.savedInstanceState
- If non-null, this fragment is being re-constructed
from a previous saved state as given here.public void onDestroyView()
onDestroyView
in class Fragment
public void onListItemClick(ListView l, View v, int position, long id)
l
- The ListView where the click happenedv
- The view that was clicked within the ListViewposition
- The position of the view in the listid
- The row id of the item that was clickedpublic void setListAdapter(ListAdapter adapter)
public void setSelection(int position)
position
- public int getSelectedItemPosition()
public long getSelectedItemId()
public ListView getListView()
public void setEmptyText(CharSequence text)
public void setListShown(boolean shown)
Applications do not normally need to use this themselves. The default
behavior of ListFragment is to start with the list not being shown, only
showing it once an adapter is given with setListAdapter(ListAdapter)
.
If the list at that point had not been shown, when it does get shown
it will be do without the user ever seeing the hidden state.
shown
- If true, the list view is shown; if false, the progress
indicator. The initial value is true.public void setListShownNoAnimation(boolean shown)
setListShown(boolean)
, but no animation is used when
transitioning from the previous state.public ListAdapter getListAdapter()