動態添加 Fragment 是構建靈活單 Activity 多 Fragment 架構 (如底部導航、抽屜菜單、多步驟向導) 的核心技能。本文詳解 FragmentManager、FragmentTransaction 核心 API、添加/替移除/隱藏顯示操作、Back Stack 管理、容器佈局選擇、參數傳遞、生命週期交互及常見坑點,提供標準化封裝工具類。
<!-- activity_main.xml -->
<FrameLayout
android:id="@+id/fragment_container"
android:layout_width="match_parent"
android:layout_height="match_parent" />
<!-- 或 androidx.fragment.app.FragmentContainerView (推薦, API 28+) -->
<androidx.fragment.app.FragmentContainerView
android:id="@+id/fragment_container"
android:name="com.example.HomeFragment" // 可選:預置初始 Fragment
android:layout_width="match_parent"
android:layout_height="match_parent" />
關鍵:使用 FrameLayout 或 FragmentContainerView 作為容器,**不要**在 XML 中靜態聲明 <fragment> (除非永不替換)。
FragmentManager fm = getSupportFragmentManager(); // Activity
// 或 fm = getChildFragmentManager(); // Fragment 中嵌套
// 或 fm = getParentFragmentManager(); // Fragment 中訪問父
FragmentTransaction ft = fm.beginTransaction();
// 基礎操作
ft.add(R.id.container, fragment, "tag"); // 添加 (疊加)
ft.replace(R.id.container, fragment, "tag"); // 替換 (移除同容器所有 + 添加) **最常用**
ft.remove(fragment); // 移除 (銷毀 View, 實例保留若未加 backStack)
ft.hide(fragment); // 隱藏 (View GONE, 實例保活)
ft.show(fragment); // 顯示
ft.attach(fragment); // 附加 (View 重建)
ft.detach(fragment); // 分離 (View 銷毀, 實例保留)
// 事務屬性
ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); // 動畫
ft.setCustomAnimations(enterAnim, exitAnim, popEnterAnim, popExitAnim); // 自定義動畫
ft.addToBackStack("name"); // 加入回棧 (名字可為 null)
ft.setReorderingAllowed(true); // 優化動畫重排 (API 26+ 推薦開啟)
// 提交
ft.commit(); // 異步提交,排隊執行
ft.commitNow(); // 同步執行 (需 API 24+,慎用)
ft.commitAllowingStateLoss(); // 狀態丟失風險下提交 (如 onSaveInstanceState 後)
// 低效模式:每次 replace 重建 View,狀態丟失
// ft.replace(R.id.container, new Fragment()).commit();
// 高效模式:hide/show 保持實例 (需配合 FragmentTransaction.show/hide)
public void switchFragment(Fragment target, String tag) {
FragmentManager fm = getSupportFragmentManager();
FragmentTransaction ft = fm.beginTransaction();
// 隱藏所有已添加 Fragment
for (Fragment f : fm.getFragments()) {
if (f != null && f.isAdded()) ft.hide(f);
}
Fragment existing = fm.findFragmentByTag(tag);
if (existing != null) {
ft.show(existing); // 復用實例
} else {
ft.add(R.id.container, target, tag); // 首次添加
}
ft.commit();
}
public void navigateTo(Fragment nextFragment, String tag, boolean addToBackStack) {
FragmentTransaction ft = getSupportFragmentManager().beginTransaction();
ft.replace(R.id.container, nextFragment, tag);
if (addToBackStack) ft.addToBackStack(tag); // 關鍵:入棧
ft.commit();
}
// Activity 處理返回鍵 (可選,默認自動 popBackStack)
@Override public void onBackPressed() {
if (getSupportFragmentManager().getBackStackEntryCount() > 0) {
getSupportFragmentManager().popBackStack();
} else {
super.onBackPressed(); // 退出 Activity
}
}
// 無需容器 ID,直接 show
MyDialogFragment dialog = MyDialogFragment.newInstance(args);
dialog.show(getSupportFragmentManager(), "dialog_tag");
// 底部彈窗
BottomSheetDialogFragment sheet = BottomSheetFragment.newInstance();
sheet.show(getSupportFragmentManager(), "sheet_tag");
setArguments(Bundle)// 創建時設置 (Fragment 構造函數不傳參!)
public static MyFragment newInstance(int id, String title) {
MyFragment f = new MyFragment();
Bundle args = new Bundle();
args.putInt("arg_id", id);
args.putString("arg_title", title);
f.setArguments(args);
return f;
}
// Fragment 內獲取
@Override public void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
int id = getArguments().getInt("arg_id", -1);
String title = getArguments().getString("arg_title");
}
原因:系統重建 Fragment 時 (配置變更、進程死後重活) 會自動保存/恢復 arguments,構造函數參數會丟失。
replace 觸發舊 Fragment:onPause -> onStop -> onDestroyView -> onDestroy -> onDetach。hide 觸發:onPause -> onStop -> onHiddenChanged(true) (View 變 GONE)。show 觸發:onHiddenChanged(false) -> onStart -> onResume。setMaxLifecycle(state) (API 26+):限制 Fragment 最大生命週期狀態 (如 STARTED 防止 onResume),ViewPager2 預啟用。FragmentNavigatorpublic class FragmentNavigator {
private final FragmentManager fm;
private final int containerId;
public FragmentNavigator(FragmentActivity activity, int containerId) {
this.fm = activity.getSupportFragmentManager();
this.containerId = containerId;
}
public void replace(Fragment fragment, String tag, boolean addToBackStack) {
FragmentTransaction ft = fm.beginTransaction();
ft.replace(containerId, fragment, tag);
if (addToBackStack) ft.addToBackStack(tag);
ft.setReorderingAllowed(true);
ft.commit();
}
public void add(Fragment fragment, String tag) {
fm.beginTransaction().add(containerId, fragment, tag).commit();
}
public void popBackStack() {
fm.popBackStack();
}
public void clearBackStack() {
fm.popBackStack(null, FragmentManager.POP_BACK_STACK_INCLUSIVE);
}
public Fragment findFragment(String tag) {
return fm.findFragmentByTag(tag);
}
}
onSaveInstanceState 後提交拋 IllegalStateException。用 commitAllowingStateLoss() 或確保在 onResume 前提交。getChildFragmentManager() 管理子 Fragment,Activity 用 getSupportFragmentManager()。**切勿混用**。FragmentStateAdapter (行為類後者)。<fragment> 嵌套 Bug、支持 android:name 預置、Transition 動畫正確、findFragmentById 即時生效。**全面替換 FrameLayout**。掌握動態 Fragment 事務管理、Back Stack 控制、容器選擇與參數傳遞規範,即可構建結構清晰、導航流暢、生命週期安全的現代 Android 應用架構。