1 /* 2 * Copyright (C) 2011 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package android.support.v4.app; 18 19 import android.os.Parcelable; 20 import android.support.v4.view.PagerAdapter; 21 import android.util.Log; 22 import android.view.View; 23 import android.view.ViewGroup; 24 25 /** 26 * Implementation of {@link android.support.v4.view.PagerAdapter} that 27 * represents each page as a {@link Fragment} that is persistently 28 * kept in the fragment manager as long as the user can return to the page. 29 * 30 * <p>This version of the pager is best for use when there are a handful of 31 * typically more static fragments to be paged through, such as a set of tabs. 32 * The fragment of each page the user visits will be kept in memory, though its 33 * view hierarchy may be destroyed when not visible. This can result in using 34 * a significant amount of memory since fragment instances can hold on to an 35 * arbitrary amount of state. For larger sets of pages, consider 36 * {@link FragmentStatePagerAdapter}. 37 * 38 * <p>When using FragmentPagerAdapter the host ViewPager must have a 39 * valid ID set.</p> 40 * 41 * <p>Subclasses only need to implement {@link #getItem(int)} 42 * and {@link #getCount()} to have a working adapter. 43 * 44 * <p>Here is an example implementation of a pager containing fragments of 45 * lists: 46 * 47 * {@sample development/samples/Support4Demos/src/com/example/android/supportv4/app/FragmentPagerSupport.java 48 * complete} 49 * 50 * <p>The <code>R.layout.fragment_pager</code> resource of the top-level fragment is: 51 * 52 * {@sample development/samples/Support4Demos/res/layout/fragment_pager.xml 53 * complete} 54 * 55 * <p>The <code>R.layout.fragment_pager_list</code> resource containing each 56 * individual fragment's layout is: 57 * 58 * {@sample development/samples/Support4Demos/res/layout/fragment_pager_list.xml 59 * complete} 60 */ 61 public abstract class FragmentPagerAdapter extends PagerAdapter { 62 private static final String TAG = "FragmentPagerAdapter"; 63 private static final boolean DEBUG = false; 64 65 private final FragmentManager mFragmentManager; 66 private FragmentTransaction mCurTransaction = null; 67 private Fragment mCurrentPrimaryItem = null; 68 FragmentPagerAdapter(FragmentManager fm)69 public FragmentPagerAdapter(FragmentManager fm) { 70 mFragmentManager = fm; 71 } 72 73 /** 74 * Return the Fragment associated with a specified position. 75 */ getItem(int position)76 public abstract Fragment getItem(int position); 77 78 @Override startUpdate(ViewGroup container)79 public void startUpdate(ViewGroup container) { 80 } 81 82 @Override instantiateItem(ViewGroup container, int position)83 public Object instantiateItem(ViewGroup container, int position) { 84 if (mCurTransaction == null) { 85 mCurTransaction = mFragmentManager.beginTransaction(); 86 } 87 88 final long itemId = getItemId(position); 89 90 // Do we already have this fragment? 91 String name = makeFragmentName(container.getId(), itemId); 92 Fragment fragment = mFragmentManager.findFragmentByTag(name); 93 if (fragment != null) { 94 if (DEBUG) Log.v(TAG, "Attaching item #" + itemId + ": f=" + fragment); 95 mCurTransaction.attach(fragment); 96 } else { 97 fragment = getItem(position); 98 if (DEBUG) Log.v(TAG, "Adding item #" + itemId + ": f=" + fragment); 99 mCurTransaction.add(container.getId(), fragment, 100 makeFragmentName(container.getId(), itemId)); 101 } 102 if (fragment != mCurrentPrimaryItem) { 103 fragment.setMenuVisibility(false); 104 fragment.setUserVisibleHint(false); 105 } 106 107 return fragment; 108 } 109 110 @Override destroyItem(ViewGroup container, int position, Object object)111 public void destroyItem(ViewGroup container, int position, Object object) { 112 if (mCurTransaction == null) { 113 mCurTransaction = mFragmentManager.beginTransaction(); 114 } 115 if (DEBUG) Log.v(TAG, "Detaching item #" + getItemId(position) + ": f=" + object 116 + " v=" + ((Fragment)object).getView()); 117 mCurTransaction.detach((Fragment)object); 118 } 119 120 @Override setPrimaryItem(ViewGroup container, int position, Object object)121 public void setPrimaryItem(ViewGroup container, int position, Object object) { 122 Fragment fragment = (Fragment)object; 123 if (fragment != mCurrentPrimaryItem) { 124 if (mCurrentPrimaryItem != null) { 125 mCurrentPrimaryItem.setMenuVisibility(false); 126 mCurrentPrimaryItem.setUserVisibleHint(false); 127 } 128 if (fragment != null) { 129 fragment.setMenuVisibility(true); 130 fragment.setUserVisibleHint(true); 131 } 132 mCurrentPrimaryItem = fragment; 133 } 134 } 135 136 @Override finishUpdate(ViewGroup container)137 public void finishUpdate(ViewGroup container) { 138 if (mCurTransaction != null) { 139 mCurTransaction.commitAllowingStateLoss(); 140 mCurTransaction = null; 141 mFragmentManager.executePendingTransactions(); 142 } 143 } 144 145 @Override isViewFromObject(View view, Object object)146 public boolean isViewFromObject(View view, Object object) { 147 return ((Fragment)object).getView() == view; 148 } 149 150 @Override saveState()151 public Parcelable saveState() { 152 return null; 153 } 154 155 @Override restoreState(Parcelable state, ClassLoader loader)156 public void restoreState(Parcelable state, ClassLoader loader) { 157 } 158 159 /** 160 * Return a unique identifier for the item at the given position. 161 * 162 * <p>The default implementation returns the given position. 163 * Subclasses should override this method if the positions of items can change.</p> 164 * 165 * @param position Position within this adapter 166 * @return Unique identifier for the item at position 167 */ getItemId(int position)168 public long getItemId(int position) { 169 return position; 170 } 171 makeFragmentName(int viewId, long id)172 private static String makeFragmentName(int viewId, long id) { 173 return "android:switcher:" + viewId + ":" + id; 174 } 175 } 176