Android类参考---Fragment(一)
1.?繼承關系
java.lang.Object
|__android.app.Fragment
實現接口:ComponentCallbacks2 View.OnCreateContextMenuListener
引入版本:API Level 11
已知的子類:
DialogFragment、ListFragment、PreferenceFragment、WebViewFragment
2.?類概要
一個Fragment是應用程序的用戶界面或行為的一個片段,它能夠被放置在一個Activity中。通過FragmentManager對象來實現與Fragment對象的交互,能夠通過Activity.getFragmentManager()方法和Fragment.getFragmentManager()方法來獲取FragmentManager對象。
Fragment類有著廣泛的應用,它的核心是代表了一個正在較大的Activity中運行的特俗的操作或界面。Fragment對象跟它所依附的Activity對象是緊密相關的,并且不能被分開使用。盡管Fragment對象定義了它們自己的生命周期,但是這個生命周期要依賴與它所在的Activity:如果該Activity被終止,那么它內部的Fragment是不能被啟動的;當Activity被銷毀時,它內部的所有Fragment對象都會被銷毀。
所有的Fragment子類都必須包含一個公共的空的構造器。在需要的時候,Framework會經常重新實例化Fragment類,在特殊的狀態恢復期間,需要能夠找到這個構造器來實例化Fragment類。如果空的構造器無效,那么在狀態恢復期間會導致運行時異常發生。
較舊的平臺
盡管Fragment API是在HONEYCOMB版本中被引入的,但是通過FragmentActivity也能夠在較舊的平臺上使用該API。
聲明周期
盡管Fragment對象的生命周期要依附于它所在的Activity對象,但是它也有自己標準的活動周期,它包含了基本的活動周期方法,如onResume(),但是同時也包含了與Activity和UI交互相關的重要方法。
顯示Fragment時(跟用戶交互)要調用的核心的生命周期方法如下:
1.?把Fragment對象跟Activity關聯時,調用onAttach(Activity)方法;
2.?Fragment對象的初始創建時,調用onCreate(Bundle)方法;
3.?onCreateView(LayoutInflater, ViewGroup, Bundle)方法用于創建和返回跟Fragment關聯的View對象;
4.?onActivityCreate(Bundle)方法會告訴Fragment對象,它所依附的Activity對象已經完成了Activity.onCreate()方法的執行;
5.?onStart()方法會讓Fragment對象顯示給用戶(在包含該Fragment對象的Activity被啟動后);
6.?onResume()會讓Fragment對象跟用戶交互(在包含該Fragment對象的Activity被啟恢復后)。
Fragment對象不再使用時,要反向回調的方法:
1.?因為Fragment對象所依附的Activity對象被掛起,或者在Activity中正在執行一個修改Fragment對象的操作,而導致Fragment對象不再跟用戶交互時,系統會調用Fragment對象的onPause()方法;
2.?因為Fragment對象所依附的Activity對象被終止,或者再Activity中正在執行一個修改Fragment對象的操作,而導致Fragment對象不再顯示給用戶時,系統會調用Fragment對象的onStop()方法。
3.?onDestroyView()方法用于清除跟Fragment中的View對象關聯的資源;
4.?Fragment對象的狀態被最終清理完成之后,要調用onDestroy()方法;
5.?在Fragment對象不再跟它依附的Activity關聯的時候,onDetach()方法會立即被調用。
?
布局
Fragment對象能夠被用于應用程序的布局,它會讓代碼的模塊化更好,并且針對Fragment所運行的屏幕,讓用戶界面的調整更加容易。例如,一個簡單的由項目列表和項目明細表示所組成的程序。
一個Activity的布局XML能夠包含要嵌入到布局內部的Fragment實例的<fragment>標簽。例如,下例中在布局中嵌入了一個Fragment對象:
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
? ? android:layout_width="match_parent" android:layout_height="match_parent">
? ? <fragment class="com.example.android.apis.app.FragmentLayout$TitlesFragment"
? ? ? ? ? ? android:id="@+id/titles"
? ? ? ? ? ? android:layout_width="match_parent" android:layout_height="match_parent" />
</FrameLayout>
以下是布局被安裝到Activity中的通常方法:
@Override
protected void onCreate(Bundle savedInstanceState) {
? ? super.onCreate(savedInstanceState);
? ? setContentView(R.layout.fragment_layout);
}
依賴ListFragment對象,要顯示列表的標題是相當簡單的。要注意的是,點擊一個列表項的實現,會依賴當前Activity的布局,它既可以創建一個新的Fragment用于顯示該項目的明細,也可以啟動一個新的Activity用于顯示項目的明細。
public static class TitlesFragment extends ListFragment {
? ? boolean mDualPane;
? ? int mCurCheckPosition = 0;
? ? @Override
? ? public void onActivityCreated(Bundle savedInstanceState) {
? ? ? ? super.onActivityCreated(savedInstanceState);
? ? ? ? // Populate list with our static array of titles.
? ? ? ? setListAdapter(new ArrayAdapter<String>(getActivity(),
? ? ? ? ? ? ? ? android.R.layout.simple_list_item_activated_1, Shakespeare.TITLES));
? ? ? ? // Check to see if we have a frame in which to embed the details
? ? ? ? // fragment directly in the containing UI.
? ? ? ? View detailsFrame = getActivity().findViewById(R.id.details);
? ? ? ? mDualPane = detailsFrame != null && detailsFrame.getVisibility() == View.VISIBLE;
? ? ? ? if (savedInstanceState != null) {
? ? ? ? ? ? // Restore last state for checked position.
? ? ? ? ? ? mCurCheckPosition = savedInstanceState.getInt("curChoice", 0);
? ? ? ? }
? ? ? ? if (mDualPane) {
? ? ? ? ? ? // In dual-pane mode, the list view highlights the selected item.
? ? ? ? ? ? getListView().setChoiceMode(ListView.CHOICE_MODE_SINGLE);
? ? ? ? ? ? // Make sure our UI is in the correct state.
? ? ? ? ? ? showDetails(mCurCheckPosition);
? ? ? ? }
? ? }
? ? @Override
? ? public void onSaveInstanceState(Bundle outState) {
? ? ? ? super.onSaveInstanceState(outState);
? ? ? ? outState.putInt("curChoice", mCurCheckPosition);
? ? }
? ? @Override
? ? public void onListItemClick(ListView l, View v, int position, long id) {
? ? ? ? showDetails(position);
? ? }
? ? /**
? ? ?* Helper function to show the details of a selected item, either by
? ? ?* displaying a fragment in-place in the current UI, or starting a
? ? ?* whole new activity in which it is displayed.
? ? ?*/
? ? void showDetails(int index) {
? ? ? ? mCurCheckPosition = index;
? ? ? ? if (mDualPane) {
? ? ? ? ? ? // We can display everything in-place with fragments, so update
? ? ? ? ? ? // the list to highlight the selected item and show the data.
? ? ? ? ? ? getListView().setItemChecked(index, true);
? ? ? ? ? ? // Check what fragment is currently shown, replace if needed.
? ? ? ? ? ? DetailsFragment details = (DetailsFragment)
? ? ? ? ? ? ? ? ? ? getFragmentManager().findFragmentById(R.id.details);
? ? ? ? ? ? if (details == null || details.getShownIndex() != index) {
? ? ? ? ? ? ? ? // Make new fragment to show this selection.
? ? ? ? ? ? ? ? details = DetailsFragment.newInstance(index);
? ? ? ? ? ? ? ? // Execute a transaction, replacing any existing fragment
? ? ? ? ? ? ? ? // with this one inside the frame.
? ? ? ? ? ? ? ? FragmentTransaction ft = getFragmentManager().beginTransaction();
? ? ? ? ? ? ? ? ft.replace(R.id.details, details);
? ? ? ? ? ? ? ? ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE);
? ? ? ? ? ? ? ? ft.commit();
? ? ? ? ? ? }
? ? ? ? } else {
? ? ? ? ? ? // Otherwise we need to launch a new activity to display
? ? ? ? ? ? // the dialog fragment with selected text.
? ? ? ? ? ? Intent intent = new Intent();
? ? ? ? ? ? intent.setClass(getActivity(), DetailsActivity.class);
? ? ? ? ? ? intent.putExtra("index", index);
? ? ? ? ? ? startActivity(intent);
? ? ? ? }
? ? }
}
明細Fragment對象只會顯示所選項目的詳細文本字符串,它是基于內置在應用中的一個字符數組的索引來獲取的:
public static class DetailsFragment extends Fragment {
? ? /**
? ? ?* Create a new instance of DetailsFragment, initialized to
? ? ?* show the text at 'index'.
? ? ?*/
? ? public static DetailsFragment newInstance(int index) {
? ? ? ? DetailsFragment f = new DetailsFragment();
? ? ? ? // Supply index input as an argument.
? ? ? ? Bundle args = new Bundle();
? ? ? ? args.putInt("index", index);
? ? ? ? f.setArguments(args);
? ? ? ? return f;
? ? }
? ? public int getShownIndex() {
? ? ? ? return getArguments().getInt("index", 0);
? ? }
? ? @Override
? ? public View onCreateView(LayoutInflater inflater, ViewGroup container,
? ? ? ? ? ? Bundle savedInstanceState) {
? ? ? ? if (container == null) {
? ? ? ? ? ? // We have different layouts, and in one of them this
? ? ? ? ? ? // fragment's containing frame doesn't exist. ?The fragment
? ? ? ? ? ? // may still be created from its saved state, but there is
? ? ? ? ? ? // no reason to try to create its view hierarchy because it
? ? ? ? ? ? // won't be displayed. ?Note this is not needed -- we could
? ? ? ? ? ? // just run the code below, where we would create and return
? ? ? ? ? ? // the view hierarchy; it would just never be used.
? ? ? ? ? ? return null;
? ? ? ? }
? ? ? ? ScrollView scroller = new ScrollView(getActivity());
? ? ? ? TextView text = new TextView(getActivity());
? ? ? ? int padding = (int)TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP,
? ? ? ? ? ? ? ? 4, getActivity().getResources().getDisplayMetrics());
? ? ? ? text.setPadding(padding, padding, padding, padding);
? ? ? ? scroller.addView(text);
? ? ? ? text.setText(Shakespeare.DIALOGUE[getShownIndex()]);
? ? ? ? return scroller;
? ? }
}
在用戶點擊標題的情況下,在當前的Activity中沒有明細容器,因此標題Fragment的點擊事件代碼會啟動一個新的顯示明細Fragment的Activity:
public static class DetailsActivity extends Activity {
? ? @Override
? ? protected void onCreate(Bundle savedInstanceState) {
? ? ? ? super.onCreate(savedInstanceState);
? ? ? ? if (getResources().getConfiguration().orientation
? ? ? ? ? ? ? ? == Configuration.ORIENTATION_LANDSCAPE) {
? ? ? ? ? ? // If the screen is now in landscape mode, we can show the
? ? ? ? ? ? // dialog in-line with the list so we don't need this activity.
? ? ? ? ? ? finish();
? ? ? ? ? ? return;
? ? ? ? }
? ? ? ? if (savedInstanceState == null) {
? ? ? ? ? ? // During initial setup, plug in the details fragment.
? ? ? ? ? ? DetailsFragment details = new DetailsFragment();
? ? ? ? ? ? details.setArguments(getIntent().getExtras());
? ? ? ? ? ? getFragmentManager().beginTransaction().add(android.R.id.content, details).commit();
? ? ? ? }
? ? }
}
但是,屏幕可能足夠顯示標題列表和當前所選標題相關的明細。對于在橫向屏幕上這樣的布局,可以被放置在layout-land下面:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
? ? android:orientation="horizontal"
? ? android:layout_width="match_parent" android:layout_height="match_parent">
? ? <fragment class="com.example.android.apis.app.FragmentLayout$TitlesFragment"
? ? ? ? ? ? android:id="@+id/titles" android:layout_weight="1"
? ? ? ? ? ? android:layout_width="0px" android:layout_height="match_parent" />
? ? <FrameLayout android:id="@+id/details" android:layout_weight="1"
? ? ? ? ? ? android:layout_width="0px" android:layout_height="match_parent"
? ? ? ? ? ? android:background="?android:attr/detailsElementBackground" />
</LinearLayout>
要注意的是,以上代碼是如何調整這種可選的UI流的:標題Fragment對象被嵌入到該Activity內部的明細Fragment對象中,并且如果Fragment對象運行在一個有顯示明細空間的配置環境中,那么明細Activity會由它自己來完成。
當由于配置的改變而導致Activity所持有的這些Fragment對象重啟的時候,它們新的Fragment實例可以使用與之前所使用的布局不同的布局。在這種情況中,之前所有的Fragment對象依然會被實例化,并運行在新的實例中。但是任何不在跟<fragment>關聯的View對象將不會再被創建,并且重isInLayout()方法中返回false。
在把Fragment的View對象綁定到父容器的時候,<fragment>標簽的屬性被用于控制提供給LayoutParams對象的信息,它們能夠作為Fragment對象中的onInflate(Activity, AttributeSet, Bundle)方法的參數來解析。
正在實例化的Fragment對象必須要有某些類型唯一標識,以便在它的父Activity在銷毀并重建的時候,能夠被重新關聯到之前的實例。可以使用以下方法來實現這種關聯:
1.?如果沒有明確的指定,則使用容器的View ID來標識;
2.?使用<fragment>元素的android:tag屬性,給Fragment對象元素提供一個特定的標簽名稱;
3.?使用<fragment>元素的android:id屬性,給Fragment對象的元素提供一個特定的標識。
總結
以上是生活随笔為你收集整理的Android类参考---Fragment(一)的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: wordpress footer置底
- 下一篇: Android反编译查看源码