前言
ViewPager搭配Fragment去實現(xiàn)標(biāo)簽頁是一種非常常見的做法,基本上Android初學(xué)者都能順手寫出來铭拧,可是有時候雖然代碼簡單饮笛,其中卻有很多微妙之處。本篇主要是聊一下Fragment遇上ViewPager之后疙筹,應(yīng)該注意到的一些細節(jié)問題。為了更好地理解本文禁炒,在閱讀之前最好先看一下Fragment不為人知的細節(jié)而咆。
PagerAdapter
不使用Fragment的話,我們就會繼承PagerAdapter幕袱,通常會重寫它以下幾個方法:
Object instantiateItem(ViewGroup container, int position)
創(chuàng)建對應(yīng)position的頁面暴备,返回的對象不一定是View,可以使View的容器或者相關(guān)聯(lián)的對象
void destroyItem(ViewGroup container, int position, Object object)
移除對應(yīng)position的頁面
int getCount()
頁面數(shù)量
boolean isViewFromObject(View view, Object object)
決定一個頁面的View對象是否和object關(guān)聯(lián)们豌,怎么關(guān)聯(lián)的涯捻。
這四個方法大家一定很熟啦,但是本文呢我們還要關(guān)注以下幾個方法:
Parcelable saveState()
在ViewPager的onSaveInstanceState方法中調(diào)用
void restoreState(Parcelable state, ClassLoader loader)
在ViewPager的onRestoreInstanceState方法和setAdapter方法中調(diào)用望迎。
這兩個方法障癌,相信大家一看就能明白怎么回事,就是ViewPager為了保存和恢復(fù)Adapter中的頁面狀態(tài)而設(shè)計的辩尊。
void setPrimaryItem(ViewGroup container, int position, Object object)
當(dāng)position頁面被選中時候涛浙,會回調(diào)該方法
void notifyDataSetChanged()
數(shù)據(jù)發(fā)生變化時候調(diào)用,該方法會引起mViewPagerObserver調(diào)用其onChanged()方法摄欲,最終會調(diào)用到ViewPager的dataSetChanged方法
int getItemPosition(Object object)
這個方法決定一個頁面的位置是否變化了轿亮,參數(shù)object是instantiateItem的返回值。這個方法的返回值有:
- POSITION_UNCHANGED 表示頁面位置永遠不會變化
- POSITION_NONE 表示頁面不存在了胸墙,需要重新加載
- [0,getCount()) 表示更換頁面的位置到指定position
默認(rèn)的實現(xiàn)是返回POSITION_UNCHANGED我注,即認(rèn)為頁面位置不會發(fā)生變化。因此我們在需要調(diào)用notifyDataSetChanged()刷新時候劳秋,應(yīng)該考慮去重寫getItemPosition
ViewPager的離屏緩存
ViewPager有一個方法setOffscreenPageLimit(int limit)
仓手,
該方法設(shè)置保存當(dāng)前頁面兩側(cè)各limit個頁面胖齐,已經(jīng)超出limit的部分會被銷毀,因此最多保存2*limit+1個頁面嗽冒,邊界情況自行腦補吧呀伙。有人管著叫預(yù)加載
,個人感覺不是特別合適,因為還會去銷毀添坊,叫離屏頁面緩存可能比較合理剿另,大家理解就算了。假設(shè)我們有0,1,2,3四個頁面贬蛙,一開始ViewPager的currentItem為0雨女,此時會預(yù)加載1頁面;滑動到1頁面時候阳准,因為0已經(jīng)加載過了氛堕,此時會預(yù)加載2頁面;當(dāng)滑動到2時候野蝇,就會銷毀0讼稚,預(yù)加載3。其中加載時會調(diào)用PagerAdapter的instantiateItem(ViewGroup container, int position)
方法绕沈,銷毀時會調(diào)用destroyItem(ViewGroup container, int position, Object object)
方法锐想。
limit默認(rèn)為1且最小必須為1。當(dāng)然如果你不想有頁面緩存的話乍狐,可以修改源碼DEFAULT_OFFSCREEN_PAGES常量赠摇。
FragmentPagerAdapter與FragmentStatePagerAdapter
區(qū)別
當(dāng)頁面超出上面所說的超過offscreenPageLimit時候,F(xiàn)ragmentPagerAdapter不會銷毀Fragment實例浅蚪,而只會銷毀視圖藕帜;而FragmentStatePagerAdapter會銷毀實例。
想必你一定能到它們是怎么實現(xiàn)的吧掘鄙?
沒錯FragmentPagerAdapter在不用的時候執(zhí)行detach耘戚,當(dāng)又需要用到的時候再attach嗡髓;FragmentStatePagerAdapter則是執(zhí)行remove與add操作操漠。因此在選擇二者的時候,當(dāng)你的頁面比較多饿这,比如十幾個時候浊伙,為了節(jié)省內(nèi)存,應(yīng)該選用FragmentStatePagerAdpater;只有幾個頁面時候就用FragmentPagerAdapter长捧,省去一些反復(fù)創(chuàng)建銷毀的開銷嚣鄙。
FragmentPagerAdapter
接下來我們來看一段非常簡單的Fragment搭配ViewPager使用的代碼:
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_view_pager);
viewPager = findViewById(R.id.viewPager);
List<BaseFragment> list = new ArrayList<>();
list.add(new FragmentOne());
list.add(new FragmentTwo());
list.add(new FragmentThree());
viewPager.setAdapter(new ViewPagerAdapter(getSupportFragmentManager(), list));
}
private class ViewPagerAdapter extends FragmentPagerAdapter {
private List<BaseFragment> list;
public ViewPagerAdapter(FragmentManager fm, List<BaseFragment> list) {
super(fm);
this.list = list;
}
@Override
public Fragment getItem(int position) {
return list.get(position);
}
@Override
public int getCount() {
return list.size();
}
}
我覺得應(yīng)該有人寫過類似這樣的代碼吧。唉串结,有些讀者可能發(fā)現(xiàn)問題了哑子,不是說要判斷是否為null嗎舅列,這樣不會有問題嗎?
答案是確實會在Activity重創(chuàng)建時候多創(chuàng)建“部分”實例,但是注意多創(chuàng)建的這部分實例并不會被add到FragmentManager中去卧蜓,仍舊會使用FragmentManager自己恢復(fù)的實例帐要。這里要注意“部分”,其實也很好理解弥奸,“部分”就是指在Activity重創(chuàng)建之前已經(jīng)添加到FragmentManager中的榨惠,List中可能還有一部分實例還未添加進去。
另外如果是FragmentStatePagerAdapter的話盛霎,List一直持有Fragment的引用赠橙,這樣的話就回收不了實例啦,也就失去了FragmentStatePagerAdapter的意義愤炸。
接下來我們從FragmentPagerAdapter的代碼來分析一下:
public Object instantiateItem(ViewGroup container, int position) {
if (mCurTransaction == null) {
mCurTransaction = mFragmentManager.beginTransaction();
}
final long itemId = getItemId(position);
// 通過containerId和itemId拼接一個name期揪,對于特定position,name是不會變的,使用name作為fragmnet的tag
String name = makeFragmentName(container.getId(), itemId);
//去FragmentManager中查找是否存在該實例
Fragment fragment = mFragmentManager.findFragmentByTag(name);
//存在直接attach
if (fragment != null) {
if (DEBUG) Log.v(TAG, "Attaching item #" + itemId + ": f=" + fragment);
mCurTransaction.attach(fragment);
} else {
//不存在調(diào)用getItem然后add進去
fragment = getItem(position);
if (DEBUG) Log.v(TAG, "Adding item #" + itemId + ": f=" + fragment);
mCurTransaction.add(container.getId(), fragment,
makeFragmentName(container.getId(), itemId));
}
if (fragment != mCurrentPrimaryItem) {
fragment.setMenuVisibility(false);
fragment.setUserVisibleHint(false);
}
return fragment;
}
邏輯注釋已經(jīng)寫的很清楚啦规个,很容易看懂横侦。
再來看一下destroyItem方法吧:
public void destroyItem(ViewGroup container, int position, Object object) {
if (mCurTransaction == null) {
mCurTransaction = mFragmentManager.beginTransaction();
}
if (DEBUG) Log.v(TAG, "Detaching item #" + getItemId(position) + ": f=" + object
+ " v=" + ((Fragment)object).getView());
mCurTransaction.detach((Fragment)object);
}
其實就是調(diào)用detach方法,銷毀視圖绰姻。到這里我們順便也搞清楚了枉侧,使用FragmentPagerAdapter切換ViewPager時候,到底發(fā)生了什么狂芋。
這部分代碼我們要從兩種情況理解:
1)假設(shè)我們有0,1,2三個頁面榨馁,limit為1,初始頁面為0帜矾。此時ViewPager先加載0翼虫,然后再加載1,這時候發(fā)現(xiàn)FragmentManager中沒有這兩個該實例屡萤,就會去調(diào)用getItem然后add進去珍剑。如果我切換到2頁面,此時0頁面超出保留的范圍啦就會去調(diào)用destroyItem死陆,然后會銷毀0頁面Fragment的視圖招拙。然后再切到1頁面,此時又要去加載0頁面,FragmentManager已經(jīng)有對應(yīng)的Fragment實例措译,只需要執(zhí)行attach重建視圖就好别凤。
2)當(dāng)Activity重創(chuàng)建時候,F(xiàn)ragmentManager會幫助我們保存與恢復(fù)已經(jīng)添加到其中的實例领虹。因此雖然我們往List中又add了新new的Fragment實例规哪,但是這Fragment發(fā)現(xiàn)該位置的實例有保存就不會去調(diào)用getItem。只有在Activity重建前沒有添加到FragmentManger中的實例才會去調(diào)用getItem塌衰。
因此我們在getItem方法調(diào)用時候再去創(chuàng)建Fragment實例诉稍,就可以避免上面多創(chuàng)建無用實例的問題蝠嘉,這一點對于FragmentStatePagerAdapter來說同樣適用
。
private class MyPagerAdapter extends FragmentPagerAdapter{
public MyPagerAdapter(FragmentManager fm) {
super(fm);
}
@Override
public Fragment getItem(int position) {
if (position==0){
return new FragmentOne();
}else if (position==1){
return new FragmentTwo();
}else {
return new FragmentThree();
}
}
@Override
public int getCount() {
return 3;
}
這時候可能又有同學(xué)有話說啦杯巨,我們平時重寫FragmentPagerAdapter的代碼基本上都是一樣的,這樣寫不就沒什么復(fù)用可言了是晨。那咱們這樣吧:
public interface FragmentCreator {
Fragment createFragment();
}
class LazyPagerAdapter extends FragmentPagerAdapter {
private List<FragmentCreator> list;
public LazyPagerAdapter(FragmentManager fm, List<FragmentCreator> list) {
super(fm);
this.list=list;
}
@Override
public Fragment getItem(int position) {
FragmentCreator fragmentCreator = list.get(position);
return fragmentCreator.createFragment();
}
@Override
public int getCount() {
return list.size();
}
}
FragmentStatePagerAdapter
對于FragmentStatePagerAdapter我們先來關(guān)注一個問題,由于當(dāng)ViewPager滑動超過limit的時候舔箭,會銷毀Fragment實例罩缴,那再重新創(chuàng)Fragment實例,我之前的界面狀態(tài)和數(shù)據(jù)豈不是丟失了层扶?
FragmentStatePagerAdapter當(dāng)然有考慮到這個問題箫章,在需要銷毀Fragment實例時候,會調(diào)用它的onSaveInstanceState(Bundle outState) 方法镜会,重新創(chuàng)建時候會調(diào)用setInitialSavedState去恢復(fù)檬寂。因此我們要想在切換界面之后回來還能保存之前的狀態(tài)態(tài),就要自己實現(xiàn)好onSaveInstanceState方法戳表,并在onCreate桶至、onCreateView或onActivtyCreated方法中去恢復(fù)
。
接下來我們來看看代碼:
@Override
public Object instantiateItem(ViewGroup container, int position) {
//mFragments中保存ViewPager緩存的頁面對應(yīng)的Fragment實例匾旭,如果在緩存中就直接返回啦
if (mFragments.size() > position) {
Fragment f = mFragments.get(position);
if (f != null) {
return f;
}
}
if (mCurTransaction == null) {
mCurTransaction = mFragmentManager.beginTransaction();
}
Fragment fragment = getItem(position);
if (DEBUG) Log.v(TAG, "Adding item #" + position + ": f=" + fragment);
if (mSavedState.size() > position) {
//是否之前保存過該頁面的狀態(tài)镣屹,保存過就恢復(fù)
Fragment.SavedState fss = mSavedState.get(position);
if (fss != null) {
fragment.setInitialSavedState(fss);
}
}
while (mFragments.size() <= position) {
mFragments.add(null);
}
fragment.setMenuVisibility(false);
fragment.setUserVisibleHint(false);
mFragments.set(position, fragment);
mCurTransaction.add(container.getId(), fragment);
return fragment;
}
@Override
public void destroyItem(ViewGroup container, int position, Object object) {
Fragment fragment = (Fragment) object;
if (mCurTransaction == null) {
mCurTransaction = mFragmentManager.beginTransaction();
}
if (DEBUG) Log.v(TAG, "Removing item #" + position + ": f=" + object
+ " v=" + ((Fragment)object).getView());
while (mSavedState.size() <= position) {
mSavedState.add(null);
}
//保存該Fragment的狀態(tài)
mSavedState.set(position, fragment.isAdded()
? mFragmentManager.saveFragmentInstanceState(fragment) : null);
//將緩存對應(yīng)位置置空
mFragments.set(position, null);
//銷毀實例
mCurTransaction.remove(fragment);
}
邏輯都寫注釋啦,也比較簡單价涝。
接下來該考慮一下Actvity重創(chuàng)建之后的三個問題:
1)ViewPager離屏緩存的Fragment,FragmentManager會幫助我們恢復(fù)
2)從來沒有add到過FragmentManager中實例女蜈,我們在getItem放法中創(chuàng)建就好
3)曾經(jīng)add到過Fragment實例,要保留之前的狀態(tài)色瘩,這部分怎么辦呢伪窖?
其實從上面的代碼來看我們只要能夠保存mSavedState這個List就好啦,那怎么保存呢居兆?這就用到我們在之前說過的PagerAdapter關(guān)鍵方法覆山,直接來看一下是怎么實現(xiàn)的吧:
public Parcelable saveState() {
Bundle state = null;
//保存mSavedState
if (mSavedState.size() > 0) {
state = new Bundle();
Fragment.SavedState[] fss = new Fragment.SavedState[mSavedState.size()];
mSavedState.toArray(fss);
state.putParcelableArray("states", fss);
}
for (int i=0; i<mFragments.size(); i++) {
Fragment f = mFragments.get(i);
if (f != null && f.isAdded()) {
if (state == null) {
state = new Bundle();
}
String key = "f" + i;
/*putFragment是存一個Bundle給這個Fragment,這個Bundle對象也會被保存泥栖。這里key純粹是為了記錄Fragment f在List的哪個位置簇宽。*/
mFragmentManager.putFragment(state, key, f);
}
}
return state;
}
@Override
public void restoreState(Parcelable state, ClassLoader loader) {
if (state != null) {
Bundle bundle = (Bundle)state;
bundle.setClassLoader(loader);
Parcelable[] fss = bundle.getParcelableArray("states");
mSavedState.clear();
mFragments.clear();
if (fss != null) {
for (int i=0; i<fss.length; i++) {
mSavedState.add((Fragment.SavedState)fss[i]);
}
}
Iterable<String> keys = bundle.keySet();
for (String key: keys) {
if (key.startsWith("f")) {
int index = Integer.parseInt(key.substring(1));
Fragment f = mFragmentManager.getFragment(bundle, key);
if (f != null) {
while (mFragments.size() <= index) {
mFragments.add(null);
}
f.setMenuVisibility(false);
mFragments.set(index, f);
} else {
Log.w(TAG, "Bad fragment at key " + key);
}
}
}
}
}
setUserVisibleHint
關(guān)于這個方法我們經(jīng)常會用來判斷當(dāng)前頁面是否對用戶可見厨诸,然后執(zhí)行一些動畫啊什么的拷姿。但是有一點要注意,這個方法也只有你用了FragmentPagerAdapter或者FragmentStatePagerAdapter才有用,看了下面的代碼你就明白了耙蔑。
public void setPrimaryItem(ViewGroup container, int position, Object object) {
Fragment fragment = (Fragment)object;
if (fragment != mCurrentPrimaryItem) {
if (mCurrentPrimaryItem != null) {
mCurrentPrimaryItem.setMenuVisibility(false);
mCurrentPrimaryItem.setUserVisibleHint(false);
}
if (fragment != null) {
fragment.setMenuVisibility(true);
fragment.setUserVisibleHint(true);
}
mCurrentPrimaryItem = fragment;
}
}
notifyDataSetChanged()問題
首先我們需要明確的一件事情是對于ViewPager而言,頁面其實是跟隨著切換去加載和銷毀的孤荣,當(dāng)數(shù)據(jù)變化的時候其實ViewPager要做的只是讓緩存的頁面做出變化就可以啦甸陌。上文已經(jīng)說過 notifyDataSetChanged()最終會調(diào)用到ViewPager的dataSetChanged()方法须揣,接下來上源碼
void dataSetChanged() {
...
//mItems中存儲的是緩存頁面的信息
for (int i = 0; i < mItems.size(); i++) {
final ItemInfo ii = mItems.get(i);
//調(diào)用getItemPosition判斷頁面的位置是否變化
final int newPos = mAdapter.getItemPosition(ii.object);
//如果沒有變化
if (newPos == PagerAdapter.POSITION_UNCHANGED) {
continue;
}
//這個位置頁面需要重新加載
if (newPos == PagerAdapter.POSITION_NONE) {
mItems.remove(i);
i--;
if (!isUpdating) {
mAdapter.startUpdate(this);
isUpdating = true;
}
//調(diào)用PagerAdapter的destroyItem方法銷毀
mAdapter.destroyItem(this, ii.position, ii.object);
needPopulate = true;
if (mCurItem == ii.position) {
// Keep the current item in the valid range
newCurrItem = Math.max(0, Math.min(mCurItem, adapterCount - 1));
//標(biāo)記需要重新填充
needPopulate = true;
}
continue;
}
//如果只是頁面位置發(fā)生改變的話
if (ii.position != newPos) {
if (ii.position == mCurItem) {
// Our current item changed position. Follow it.
newCurrItem = newPos;
}
ii.position = newPos;
needPopulate = true;
}
}
if (isUpdating) {
mAdapter.finishUpdate(this);
}
//對緩存中的頁面按照位置先后排序
Collections.sort(mItems, COMPARATOR);
//填充
if (needPopulate)
final int childCount = getChildCount();
for (int i = 0; i < childCount; i++) {
final View child = getChildAt(i);
final LayoutParams lp = (LayoutParams) child.getLayoutParams();
if (!lp.isDecor) {
lp.widthFactor = 0.f;
}
}
setCurrentItemInternal(newCurrItem, false, true);
requestLayout();
}
}
重寫getItemPosition
看了上面的代碼我們知道如果數(shù)據(jù)發(fā)生變化,一定要重寫getItemPosition方法钱豁。比如:
public int getItemPosition(Object object) {
return POSITION_NONE;
}
這樣的話如果你使用FragmentStatePagerAdapter是沒有問題的耻卡,因為它緩存的Fragment是放在mFragments集合中的,當(dāng)調(diào)用destroyItem時候會調(diào)用 mFragments.set(position, null)
移除對應(yīng)的實例牲尺。但是FragmentPagerAdapter的Fragment是由FragmentManager管理的卵酪,當(dāng)調(diào)用destroyItem時候只是detach掉,而Fragment實例還存在其中谤碳。instantiateItem方法有這么幾行代碼:
final long itemId = getItemId(position);
String name = makeFragmentName(container.getId(), itemId);
Fragment fragment = mFragmentManager.findFragmentByTag(name);
我們看到Fragment的TAG是由makeFragmentName方法決定的溃卡,看下實現(xiàn):
public long getItemId(int position) {
return position;
}
private static String makeFragmentName(int viewId, long id) {
return "android:switcher:" + viewId + ":" + id;
}
因此對于FragmentPagerAdapter而言,只要是加載過的Fragment根本就不會被替換掉蜒简,因此我們在數(shù)據(jù)變化時候需要清空掉FragmentManager管理的Fragment瘸羡。
貼上代碼:
class LazyPagerAdapter extends FragmentPagerAdapter {
private List<FragmentCreator> list;
private FragmentManager mFragmentManager;
public void setFragments(List<FragmentCreator> list) {
FragmentTransaction transaction = mFragmentManager.beginTransaction();
for (Fragment f : mFragmentManager.getFragments()) {
transaction.remove(f);
}
transaction.commitNow();
this.list = list;
notifyDataSetChanged();
}
public LazyPagerAdapter(FragmentManager fm, List<FragmentCreator> list) {
super(fm);
this.list = list;
mFragmentManager = fm;
}
@Override
public Fragment getItem(int position) {
FragmentCreator fragmentCreator = list.get(position);
return fragmentCreator.createFragment();
}
@Override
public int getItemPosition(Object object) {
return POSITION_NONE;
}
@Override
public int getCount() {
return list.size();
}
}
本文就到這里啦,由于個人水平及精力有限搓茬,如有錯誤犹赖,打臉請輕點