在 Activity 的 XML 布局文件中通過 <fragment> 標簽靜態聲明 Fragment,是構建多窗格 UI (如平板雙欄、大屏適配) 最直觀的方式。本文詳解聲明語法、必要屬性、生命週期特點、與動態添加的區別、嵌套 Fragment 陷阱及最佳實踐。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
android:orientation="horizontal"
android:layout_width="match_parent"
android:layout_height="match_parent">
<!-- 列表 Fragment (左側, 佔 1/3) -->
<fragment
android:name="com.example.news.ArticleListFragment"
android:id="@+id/list_fragment"
android:layout_weight="1"
android:layout_width="0dp"
android:layout_height="match_parent" />
<!-- 詳情 Fragment (右側, 佔 2/3) -->
<fragment
android:name="com.example.news.ArticleReaderFragment"
android:id="@+id/viewer_fragment"
android:layout_weight="2"
android:layout_width="0dp"
android:layout_height="match_parent" />
</LinearLayout>
android:name (必須):Fragment 類的**完全限定名**。系統會實例化該類。android:id (必須,推薦):唯一標識,用於 findFragmentById() 獲取實例、**保存/恢復實例狀態** (配置變更時關鍵)。也可用 android:tag。android:layout_width/height:布局尺寸,配合父容器 (如 LinearLayout + weight) 實現響應式分配。tools:layout (可選):tools:layout="@layout/fragment_article_list",僅供預覽渲染,不影響運行。setContentView() 解析 XML。<fragment>,通過反射實例化 android:name 指定的類 (**必須有無參公共構造函數**)。onInflate() → onAttach() → onCreate() → onCreateView() (返回 View 或 0) → onViewCreated() → onActivityCreated() (已棄用) / onStart() → onResume()。| 維度 | 靜態聲明 (XML) | 動態添加 (代碼) |
|---|---|---|
| 適用場景 | 固定佈局、常駐 Fragment (導航欄、雙欄主界面) | 動態切換、條件顯示、Back Stack 管理、對話框、底部彈窗 |
| 事務管理 | 無 Back Stack,**不可 remove/replace/add**,生命週期綁定 Activity | 完全控制:add/replace/remove/hide/show/detach/attach + addToBackStack |
| 配置變更恢復 | **自動恢復** (靠 id/tag 重新關聯實例),開發者無感 | 需手動處理或依賴 setRetainInstance(true) / ViewModel |
| 參數傳遞 | 僅能通過 setArguments(Bundle) 在 onInflate 前設置 (罕用),通常在 onAttach 從 Activity 獲取 | 創建前 setArguments(),或工廠模式注入 |
| 嵌套 Fragment | **極易出錯** (見下文陷阱) | 使用 getChildFragmentManager() 相對可控 |
// Activity 中
ArticleListFragment listFragment = (ArticleListFragment) getSupportFragmentManager()
.findFragmentById(R.id.list_fragment); // 必須有 android:id
// 或使用 tag
ArticleReaderFragment readerFragment = (ArticleReaderFragment) getSupportFragmentManager()
.findFragmentByTag("viewer_tag"); // XML 中 android:tag="viewer_tag"
現象:父 Fragment 靜態聲明在 XML,其內部動態添加子 Fragment (如 ViewPager + FragmentPagerAdapter) 時,配置變更 (旋屏) 後子 Fragment 狀態丟失、重疊、崩潰。
原因:靜態 Fragment 重建時,子 FragmentManager 狀態恢復機制失效,子 Fragment 實例與新父實例關聯斷裂。
解決方案:
onCreate 中 replace),擁有完整事務控制權。Fragment 並在 onCreateView 中手動 inflate 包含 <fragment> 的佈局 (不推薦,複雜)。setRetainInstance(true) (已棄用) 或 ViewModel 跨實例保持數據,UI 重建接受閃爍。android:id 或 android:tag**,否則配置變更無法恢復實例。constructor() 或無參主構造函數)。tools:layout 提升開發效率。FragmentContainerView (API 28+,Jetpack 推薦),功能同 <fragment> 但修復了嵌套、動畫、Transition 等眾多 Bug,語法幾乎相同:<androidx.fragment.app.FragmentContainerView ... />靜態聲明 Fragment 簡潔聲明式、自動狀態恢復,是固定多窗格佈局的首選。但邊界要清晰:**固定結構用靜態,動態切換用事務**,切勿混用導致狀態管理混亂。