FragmentPagerAdapter.java revision 79398eaefea45e61d839cf4e0534f0eafee70a09
1ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn/* 2ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * Copyright (C) 2011 The Android Open Source Project 3ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * 4ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * Licensed under the Apache License, Version 2.0 (the "License"); 5ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * you may not use this file except in compliance with the License. 6ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * You may obtain a copy of the License at 7ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * 8ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * http://www.apache.org/licenses/LICENSE-2.0 9ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * 10ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * Unless required by applicable law or agreed to in writing, software 11ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * distributed under the License is distributed on an "AS IS" BASIS, 12ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * See the License for the specific language governing permissions and 14ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * limitations under the License. 15ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn */ 16ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 17ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackbornpackage android.support.v13.app; 18ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 19ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackbornimport android.app.Fragment; 20ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackbornimport android.app.FragmentManager; 21ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackbornimport android.app.FragmentTransaction; 22ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackbornimport android.os.Parcelable; 235c1637087453de15e31861f073eae5133c4e9f7bDianne Hackbornimport android.support.v4.view.PagerAdapter; 24ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackbornimport android.util.Log; 25ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackbornimport android.view.View; 26ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 275c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn/** 285c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * Implementation of {@link android.support.v4.view.PagerAdapter} that 295c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * represents each page as a {@link android.app.Fragment} that is persistently 305c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * kept in the fragment manager as long as the user can return to the page. 315c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn */ 325c1637087453de15e31861f073eae5133c4e9f7bDianne Hackbornpublic abstract class FragmentPagerAdapter extends PagerAdapter { 33ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn private static final String TAG = "FragmentPagerAdapter"; 34ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn private static final boolean DEBUG = false; 35ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 36ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn private final FragmentManager mFragmentManager; 37ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn private FragmentTransaction mCurTransaction = null; 382a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn private Fragment mCurrentPrimaryItem = null; 39ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 40ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn public FragmentPagerAdapter(FragmentManager fm) { 41ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn mFragmentManager = fm; 42ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 43ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 44ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn /** 45ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn * Return the Fragment associated with a specified position. 46ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn */ 47ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn public abstract Fragment getItem(int position); 48ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 49ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn @Override 505c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public void startUpdate(View container) { 51ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 52ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 53ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn @Override 545c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public Object instantiateItem(View container, int position) { 55ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn if (mCurTransaction == null) { 56ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn mCurTransaction = mFragmentManager.beginTransaction(); 57ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 58ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 59ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn // Do we already have this fragment? 605c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn String name = makeFragmentName(container.getId(), position); 61ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn Fragment fragment = mFragmentManager.findFragmentByTag(name); 62ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn if (fragment != null) { 63ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn if (DEBUG) Log.v(TAG, "Attaching item #" + position + ": f=" + fragment); 64ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn mCurTransaction.attach(fragment); 65ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } else { 66ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn fragment = getItem(position); 67ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn if (DEBUG) Log.v(TAG, "Adding item #" + position + ": f=" + fragment); 685c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn mCurTransaction.add(container.getId(), fragment, 695c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn makeFragmentName(container.getId(), position)); 70ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 712a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn if (fragment != mCurrentPrimaryItem) { 722a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn FragmentCompat.setMenuVisibility(fragment, false); 7379398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell FragmentCompat.setUserVisibleHint(fragment, false); 742a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn } 75ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 76ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn return fragment; 77ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 78ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 79ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn @Override 805c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public void destroyItem(View container, int position, Object object) { 81ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn if (mCurTransaction == null) { 82ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn mCurTransaction = mFragmentManager.beginTransaction(); 83ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 84ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn if (DEBUG) Log.v(TAG, "Detaching item #" + position + ": f=" + object 85ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn + " v=" + ((Fragment)object).getView()); 86ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn mCurTransaction.detach((Fragment)object); 87ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 88ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 89ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn @Override 902a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn public void setPrimaryItem(View container, int position, Object object) { 912a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn Fragment fragment = (Fragment)object; 922a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn if (fragment != mCurrentPrimaryItem) { 932a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn if (mCurrentPrimaryItem != null) { 942a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn FragmentCompat.setMenuVisibility(mCurrentPrimaryItem, false); 9579398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell FragmentCompat.setUserVisibleHint(mCurrentPrimaryItem, false); 962a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn } 972a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn if (fragment != null) { 982a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn FragmentCompat.setMenuVisibility(fragment, true); 9979398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell FragmentCompat.setUserVisibleHint(fragment, true); 1002a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn } 1012a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn mCurrentPrimaryItem = fragment; 1022a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn } 1032a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn } 1042a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn 1052a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn @Override 1065c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public void finishUpdate(View container) { 107ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn if (mCurTransaction != null) { 1082a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn mCurTransaction.commitAllowingStateLoss(); 109ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn mCurTransaction = null; 110ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn mFragmentManager.executePendingTransactions(); 111ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 112ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 113ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 114ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn @Override 115ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn public boolean isViewFromObject(View view, Object object) { 116ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn return ((Fragment)object).getView() == view; 117ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 118ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 119ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn @Override 120ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn public Parcelable saveState() { 121ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn return null; 122ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 123ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 124ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn @Override 1255c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public void restoreState(Parcelable state, ClassLoader loader) { 126ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 127ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn 128ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn private static String makeFragmentName(int viewId, int index) { 129ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn return "android:switcher:" + viewId + ":" + index; 130ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn } 131ea2c91b0198855073983b4a8437aa71cbd83872fDianne Hackborn}