Android Fragment 你應該知道的一切
很久以前寫過兩篇Fragment的介紹,主要就是介紹其功能:Android Fragment 真正的完全解析(上)和Android Fragment 真正的完全解析(下) 有興趣的可以湊合看下。之前的部落格屬於怎麼使用Fragment,本文目標教你如何用好Fragment,即Fragment的一些使用的建議,(多數內容來自:android programming the big nerd ranch guide 一書,直接百度,你懂的,雖然是基礎書籍,還是很值得一看的)。
1、概述
首先我們簡單回顧一下,相信大家對Fragment的都不陌生,對於Fragment的使用,一方面Activity需要在佈局中為Fragment安排位置,另一方面需要管理好Fragment的生命週期。Activity中有個FragmentManager,其內部維護fragment佇列,以及fragment事務的回退棧。
一般情況下,我們在Activity裡面會這麼新增Fragment:
public class MainActivity extends FragmentActivity { private ContentFragment mContentFragment ; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); FragmentManager fm = getSupportFragmentManager(); mContentFragment = (ContentFragment) fm.findFragmentById(R.id.id_fragment_container); if(mContentFragment == null ) { mContentFragment = new ContentFragment(); fm.beginTransaction().add(R.id.id_fragment_container,mContentFragment).commit(); } } }
針對上面程式碼,問兩個問題:
1、為什麼需要判null呢?
主要是因為,當Activity因為配置發生改變(螢幕旋轉)或者記憶體不足被系統殺死,造成重新建立時,我們的fragment會被儲存下來,但是會建立新的FragmentManager,新的FragmentManager會首先會去獲取儲存下來的fragment佇列,重建fragment佇列,從而恢復之前的狀態。
2、add(R.id.id_fragment_container,mContentFragment)中的佈局的id有何作用?
一方面呢,是告知FragmentManager,此fragment的位置;另一方面是此fragment的唯一標識;就像我們上面通過fm.findFragmentById(R.id.id_fragment_container)查詢~~
好了,簡單回顧了一下基本用法,具體的還請參考上面的部落格或者其他資料,接下來,介紹一些使用的意見~~
2、Fragment Arguments
下面描述一個簡單的場景,比如我們某個按鈕觸發Activity跳轉,需要通過Intent傳遞引數到目標Activity的Fragment中,那麼此Fragment如何獲取當前的Intent的值呢?
有哥們會說,這個簡單?看我的程式碼(問題程式碼):
public class ContentFragment extends Fragment
{
private String mArgument ;
public static final String ARGUMENT ="argument";
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
mArgument = getActivity().getIntent().getStringExtra(ARGUMENT);
}
我們直接在Fragment的onCreate中,拿到宿主Activty,宿主Activity中肯定能通過getIntent拿到Intent,然後通過get方法,隨意拿引數~~
這麼寫,功能上是實現了,但是呢?存在一個大問題:我們用Fragment的一個很大的原因,就是為了複用。你這麼寫,相當於這個Fragment已經完全和當前這個宿主Activity綁定了,複用直接廢了~~~所以呢?我們換種方式,推薦使用arguments來建立Fragment。
public class ContentFragment extends Fragment
{
private String mArgument;
public static final String ARGUMENT = "argument";
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
// mArgument = getActivity().getIntent().getStringExtra(ARGUMENT);
Bundle bundle = getArguments();
if (bundle != null)
mArgument = bundle.getString(ARGUMENT);
}
/**
* 傳入需要的引數,設定給arguments
* @param argument
* @return
*/
public static ContentFragment newInstance(String argument)
{
Bundle bundle = new Bundle();
bundle.putString(ARGUMENT, argument);
ContentFragment contentFragment = new ContentFragment();
contentFragment.setArguments(bundle);
return contentFragment;
}
給Fragment新增newInstance方法,將需要的引數傳入,設定到bundle中,然後setArguments(bundle),最後在onCreate中進行獲取;
這樣就完成了Fragment和Activity間的解耦。當然了這裡需要注意:
setArguments方法必須在fragment建立以後,新增給Activity前完成。千萬不要,首先呼叫了add,然後設定arguments。
3、Fragment的startActivityForResult
依舊是一個簡單的場景:兩個Fragment,一個展示文章列表的Fragment(叫做ListTitleFragment),一個顯示詳細資訊的Fragment(叫做:ContentFragment),當然了,這兩個Fragment都有其宿主Activity。
現在,我們點選列表Fragment中的列表項,傳入相應的引數,去詳細資訊的Fragment展示詳細的資訊,在詳細資訊頁面,使用者可以進行點評,當用戶點選back以後,我們以往點評結果顯示在列表的Fragment對於的列表項中;
也就是說,我們點選跳轉到對應Activity的Fragment中,並且希望它能夠返回引數,那麼我們肯定是使用Fragment.startActivityForResult ;
在Fragment中存在startActivityForResult()以及onActivityResult()方法,但是呢,沒有setResult()方法,用於設定返回的intent,這樣我們就需要通過呼叫getActivity().setResult(ListTitleFragment.REQUEST_DETAIL, intent);。
詳細程式碼:
ListTitleFragment
public class ListTitleFragment extends ListFragment
{
public static final int REQUEST_DETAIL = 0x110;
private List<String> mTitles = Arrays.asList("Hello", "World", "Android");
private int mCurrentPos ;
private ArrayAdapter<String> mAdapter ;
@Override
public void onActivityCreated(Bundle savedInstanceState)
{
super.onActivityCreated(savedInstanceState);
setListAdapter(mAdapter = new ArrayAdapter<String>(getActivity(), android.R.layout.simple_list_item_1, mTitles));
}
@Override
public void onListItemClick(ListView l, View v, int position, long id)
{
mCurrentPos = position ;
Intent intent = new Intent(getActivity(),ContentActivity.class);
intent.putExtra(ContentFragment.ARGUMENT, mTitles.get(position));
startActivityForResult(intent, REQUEST_DETAIL);
}
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data)
{
Log.e("TAG", "onActivityResult");
super.onActivityResult(requestCode, resultCode, data);
if(requestCode == REQUEST_DETAIL)
{
mTitles.set(mCurrentPos, mTitles.get(mCurrentPos)+" -- "+data.getStringExtra(ContentFragment.RESPONSE));
mAdapter.notifyDataSetChanged();
}
}
}
ContentFragmentpublic class ContentFragment extends Fragment
{
private String mArgument;
public static final String ARGUMENT = "argument";
public static final String RESPONSE = "response";
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
Bundle bundle = getArguments();
if (bundle != null)
{
mArgument = bundle.getString(ARGUMENT);
Intent intent = new Intent();
intent.putExtra(RESPONSE, "good");
getActivity().setResult(ListTitleFragment.REQUEST_DETAIL, intent);
}
}
public static ContentFragment newInstance(String argument)
{
Bundle bundle = new Bundle();
bundle.putString(ARGUMENT, argument);
ContentFragment contentFragment = new ContentFragment();
contentFragment.setArguments(bundle);
return contentFragment;
}
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState)
{
Random random = new Random();
TextView tv = new TextView(getActivity());
tv.setText(mArgument);
tv.setGravity(Gravity.CENTER);
tv.setBackgroundColor(Color.argb(random.nextInt(100),
random.nextInt(255), random.nextInt(255), random.nextInt(255)));
return tv;
}
}
貼出了兩個Fragment的程式碼,可以看到我們在ListTitleFragment.onListItemClick,使用startActivityForResult()跳轉到目標Activity,在目標Activity的Fragment(ContentFragment)中獲取引數,然後呼叫getActivity().setResult(ListTitleFragment.REQUEST_DETAIL, intent);進行設定返回的資料;最後在ListTitleFragment.onActivityResult()拿到返回的資料進行回顯;
為大家以後在遇到類似問題時,提供瞭解決方案;也說明了一個問題:fragment能夠從Activity中接收返回結果,但是其自設無法產生返回結果,只有Activity擁有返回結果。
接下來我要貼一下,這兩個Fragment的宿主Activity:
ListTitleActivity
public class ListTitleActivity extends FragmentActivity
{
private ListTitleFragment mListFragment;
@Override
protected void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_single_fragment);
FragmentManager fm = getSupportFragmentManager();
mListFragment = (ListTitleFragment) fm.findFragmentById(R.id.id_fragment_container);
if(mListFragment == null )
{
mListFragment = new ListTitleFragment();
fm.beginTransaction().add(R.id.id_fragment_container,mListFragment).commit();
}
}
}
ContentActivity:
public class ContentActivity extends FragmentActivity
{
private ContentFragment mContentFragment;
@Override
protected void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_single_fragment);
FragmentManager fm = getSupportFragmentManager();
mContentFragment = (ContentFragment) fm.findFragmentById(R.id.id_fragment_container);
if(mContentFragment == null )
{
String title = getIntent().getStringExtra(ContentFragment.ARGUMENT);
mContentFragment = ContentFragment.newInstance(title);
fm.beginTransaction().add(R.id.id_fragment_container,mContentFragment).commit();
}
}
}
有沒有發現兩個Activity中的程式碼極其的類似,且使用了同一個佈局檔案:
activity_single_fragment.xml
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:id="@+id/id_fragment_container"
>
</RelativeLayout>
為什麼要貼這Acticity的程式碼呢?因為我們專案中,如果原則上使用Fragment,會發現大量類似的程式碼,那麼我們就可以抽象一個Activity出來,託管我們的Single Fragment。
詳細見下一節。
4、SingleFragmentActivity
於是抽象出來的Activity的程式碼為:
package com.example.demo_zhy_23_fragments;
import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.support.v4.app.FragmentActivity;
import android.support.v4.app.FragmentManager;
public abstract class SingleFragmentActivity extends FragmentActivity
{
protected abstract Fragment createFragment();
@Override
protected void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_single_fragment);
FragmentManager fm = getSupportFragmentManager();
Fragment fragment =fm.findFragmentById(R.id.id_fragment_container);
if(fragment == null )
{
fragment = createFragment() ;
fm.beginTransaction().add(R.id.id_fragment_container,fragment).commit();
}
}
}
那麼,有了這個SingleFragmentActivity,我們的ContentActivity和ListTitleActivity也能大變身了~
package com.example.demo_zhy_23_fragments;
import android.support.v4.app.Fragment;
public class ContentActivity extends SingleFragmentActivity
{
private ContentFragment mContentFragment;
@Override
protected Fragment createFragment()
{
String title = getIntent().getStringExtra(ContentFragment.ARGUMENT);
mContentFragment = ContentFragment.newInstance(title);
return mContentFragment;
}
}
package com.example.demo_zhy_23_fragments;
import android.support.v4.app.Fragment;
public class ListTitleActivity extends SingleFragmentActivity
{
private ListTitleFragment mListFragment;
@Override
protected Fragment createFragment()
{
mListFragment = new ListTitleFragment();
return mListFragment;
}
}
是不是簡潔很多,相信優先使用Fragment的專案,類似的Activity非常多,使用SingleFragmentActivity來簡化你的程式碼吧~~
好了,此程式碼是來自文章開始推薦的書中的,再次推薦一下~~。
5、FragmentPagerAdapter與FragmentStatePagerAdapter
相信這兩個PagerAdapter的子類,大家都不陌生吧~~自從Fragment問世,使用ViewPager再結合上面任何一個例項的製作APP主頁的案例特別多~~~
那麼這兩個類有何區別呢?
主要區別就在與對於fragment是否銷燬,下面細說:
FragmentPagerAdapter:對於不再需要的fragment,選擇呼叫detach方法,僅銷燬檢視,並不會銷燬fragment例項。
FragmentStatePagerAdapter:會銷燬不再需要的fragment,噹噹前事務提交以後,會徹底的將fragmeng從當前Activity的FragmentManager中移除,state標明,銷燬時,會將其onSaveInstanceState(Bundle outState)中的bundle資訊儲存下來,當用戶切換回來,可以通過該bundle恢復生成新的fragment,也就是說,你可以在onSaveInstanceState(Bundle outState)方法中儲存一些資料,在onCreate中進行恢復建立。
如上所說,使用FragmentStatePagerAdapter當然更省記憶體,但是銷燬新建也是需要時間的。一般情況下,如果你是製作主頁面,就3、4個Tab,那麼可以選擇使用FragmentPagerAdapter,如果你是用於ViewPager展示數量特別多的條目時,那麼建議使用FragmentStatePagerAdapter。
篇幅原因,具體的案例就不寫了,大家自行測試。
6、Fragment間的資料傳遞
上面3中,我們展示了,一般的兩個Fragment間的資料傳遞。
那麼還有一種比較特殊的情況,就是兩個Fragment在同一個Activity中:例如,點選當前Fragment中按鈕,彈出一個對話方塊(DialogFragment),在對話方塊中的操作需要返回給觸發的Fragment中,那麼如何資料傳遞呢?對於對話方塊的使用推薦:Android 官方推薦 : DialogFragment 建立對話方塊
我們繼續修改我們的程式碼:現在是ListTitleFragment , ContentFragment , 新增一個對話方塊:EvaluateDialog,使用者點選ContentFragment 內容時彈出一個評價列表,使用者選擇評價。
現在我們的關注點在於:ContentFragment中如何優雅的拿到EvaluateDialog中返回的評價:
記住我們在一個Activity中,那麼肯定不是使用startActivityForResult;但是我們返回的資料,依然在onActivityResult中進行接收。
好了看程式碼:
ContentFragment
public class ContentFragment extends Fragment
{
private String mArgument;
public static final String ARGUMENT = "argument";
public static final String RESPONSE = "response";
public static final String EVALUATE_DIALOG = "evaluate_dialog";
public static final int REQUEST_EVALUATE = 0X110;
//...
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState)
{
Random random = new Random();
TextView tv = new TextView(getActivity());
ViewGroup.LayoutParams params = new ViewGroup.LayoutParams(
LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT);
tv.setLayoutParams(params);
tv.setText(mArgument);
tv.setGravity(Gravity.CENTER);
tv.setBackgroundColor(Color.argb(random.nextInt(100),
random.nextInt(255), random.nextInt(255), random.nextInt(255)));
// set click
tv.setOnClickListener(new OnClickListener()
{
@Override
public void onClick(View v)
{
EvaluateDialog dialog = new EvaluateDialog();
//注意setTargetFragment
dialog.setTargetFragment(ContentFragment.this, REQUEST_EVALUATE);
dialog.show(getFragmentManager(), EVALUATE_DIALOG);
}
});
return tv;
}
//接收返回回來的資料
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data)
{
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == REQUEST_EVALUATE)
{
String evaluate = data
.getStringExtra(EvaluateDialog.RESPONSE_EVALUATE);
Toast.makeText(getActivity(), evaluate, Toast.LENGTH_SHORT).show();
Intent intent = new Intent();
intent.putExtra(RESPONSE, evaluate);
getActivity().setResult(Activity.REQUEST_OK, intent);
}
}
}
刪除了一些無關程式碼,注意看,我們在onCreateView中為textview添加了click事件,用於彈出我們的dialog,注意一行程式碼:
dialog.setTargetFragment(ContentFragment.this, REQUEST_EVALUATE);
我們呼叫了Fragment.setTargetFragment ,這個方法,一般就是用於當前fragment由別的fragment啟動,在完成操作後返回資料的,符合我們的需求吧~~~注意,這句很重要。
接下來看EvaluateDialog程式碼:
package com.example.demo_zhy_23_fragments;
import android.app.Activity;
import android.app.AlertDialog;
import android.app.Dialog;
import android.content.DialogInterface;
import android.content.DialogInterface.OnClickListener;
import android.content.Intent;
import android.os.Bundle;
import android.support.v4.app.DialogFragment;
public class EvaluateDialog extends DialogFragment
{
private String[] mEvaluteVals = new String[] { "GOOD", "BAD", "NORMAL" };
public static final String RESPONSE_EVALUATE = "response_evaluate";
@Override
public Dialog onCreateDialog(Bundle savedInstanceState)
{
AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
builder.setTitle("Evaluate :").setItems(mEvaluteVals,
new OnClickListener()
{
@Override
public void onClick(DialogInterface dialog, int which)
{
setResult(which);
}
});
return builder.create();
}
// 設定返回資料
protected void setResult(int which)
{
// 判斷是否設定了targetFragment
if (getTargetFragment() == null)
return;
Intent intent = new Intent();
intent.putExtra(RESPONSE_EVALUATE, mEvaluteVals[which]);
getTargetFragment().onActivityResult(ContentFragment.REQUEST_EVALUATE,
Activity.RESULT_OK, intent);
}
}
重點就是看點選後的setResult了,我們首先判斷是否設定了targetFragment,如果設定了,意味我們要返回一些資料到targetFragment。
我們建立intent封裝好需要傳遞資料,最後手動呼叫onActivityResult進行返回資料~~
最後我們在ContentFragment的onActivityResult接收即可。
ok,終於把這些tips貫穿到一起了,到此我們的Fragment的一些建議的用法就結束了~~~那麼,最後提供下原始碼,也順便貼個效果圖: