Android Developer Roadmap: Sử dụng Fragments, Dialogs, Bottom Sheets và Drawers – Xây dựng Giao diện Linh hoạt và Tương tác

“Fragment chết rồi, Compose làm hết” là câu đúng một nửa. App Compose-first không cần Fragment, nhưng rất nhiều codebase Android vẫn là View và vẫn gọi FragmentManager mỗi ngày. Fragments, Dialogs, Bottom Sheets và Drawers vì thế vẫn là kỹ năng bạn phải có — chỉ là cách triển khai đã tách thành hai nhánh rõ rệt.

Bài này không dạy lại định nghĩa. Nó chỉ ra cái nào còn dùng, cái nào nên thay, và những lỗi làm giao diện linh hoạt trở thành giao diện khó bảo trì: mất state, leak, transaction chồng nhau, sheet kẹt, drawer tự đóng.

Cập nhật 2026 cho Fragments, Dialogs, Bottom Sheets và Drawers

  • Material 3 1.4.0 stable: ModalBottomSheet, BottomSheetScaffold và ModalNavigationDrawer là API chuẩn cho Compose, một số vẫn cần @OptIn(ExperimentalMaterial3Api::class). Material 3 Expressive mới ở 1.5.0-rc01, chưa dùng production.
  • Compose BOM 2026.09.00, Compose runtime/UI/foundation 1.12.1. Dialog và AlertDialog không cần version riêng khi đã khai báo BOM.
  • Navigation 3 1.2.1 stable với NavDisplay và rememberNavBackStack; Navigation 2 (2.10.2) chỉ còn bảo trì. Drawer trong app Compose chỉ là lớp phủ, không phải nơi giữ back stack.
  • Views và Fragment vẫn được hỗ trợ đầy đủ, không phải legacy cần migrate gấp. AndroidX giữ minSdk 23, Fragment, DialogFragment và Material Components vẫn nhận bản vá.

Fragment: vẫn là xương sống của app View-based

Fragment là một phần UI kiêm hành vi sống bên trong Activity. FragmentManager giữ danh sách fragment, back stack và hàng đợi transaction. Một transaction là đơn vị thay đổi: add, replace, remove, hide/show, rồi commit().

commit() không chạy ngay — nó xếp transaction vào main thread ở cuối vòng lặp hiện tại. commitNow() chạy đồng bộ, và chính vì đồng bộ nên nó không được phép addToBackStack. Chọn sai giữa hai hàm này là nguồn gốc của nhiều lỗi thứ tự.

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

FragmentContainerView thay cho FrameLayout làm container: nó xử lý đúng thứ tự thêm view và không cho phép dùng <fragment> tĩnh lẫn lộn. Đây là transaction cũ mà bạn vẫn gặp trong phần lớn dự án View:

// File: MainActivity.kt
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        if (savedInstanceState == null) {
            supportFragmentManager.beginTransaction()
                .setReorderingAllowed(true)
                .replace(R.id.container, InboxFragment(), "inbox")
                .addToBackStack("inbox")
                .commit()
        }
    }
}

Điều kiện savedInstanceState == null không phải mẹo vặt. Sau xoay máy hoặc process death, FragmentManager tự dựng lại fragment và back stack; thêm lần nữa sẽ có hai bản trùng tag và một bản mồ côi. setReorderingAllowed(true) cho phép FragmentManager tối ưu thứ tự thực thi và chạy animation đúng.

Hai vòng đời, không phải một

Fragment có vòng đời bản thân: onAttach → onCreate → onStart → onResume → onPause → onStop → onDestroy → onDetach. Nó còn có vòng đời view: onCreateView → onViewCreated → onViewStateRestored → onDestroyView. Từ androidx.fragment 1.3, onActivityCreated đã bị deprecate và sau đó loại bỏ — đừng chờ callback này.

Hệ quả thực tế: View chỉ sống giữa onCreateView và onDestroyView. Binding, adapter, observer gắn với view phải được dọn trong onDestroyView. Khi collect Flow, dùng viewLifecycleOwner, không dùng this — vòng đời fragment dài hơn vòng đời view.

private var _binding: FragmentInboxBinding? = null
private val binding get() = _binding!!

override fun onCreateView(
    inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?
): View = FragmentInboxBinding.inflate(inflater, container, false).also { _binding = it }

override fun onDestroyView() {
    super.onDestroyView()
    _binding = null
}

childFragmentManager

Fragment lồng trong Fragment phải dùng childFragmentManager, không phải parentFragmentManager. Nhầm hai manager này làm transaction của con rơi vào back stack của cha, và back stack bắt đầu nhảy lung tung. ViewPager2 với FragmentStateAdapter cũng nhận childFragmentManager. Lưu ý: ViewPager2 là View-based; app Compose dùng HorizontalPager.

State loss: lỗi im lặng đắt nhất

Sau khi Activity đã gọi onSaveInstanceState, FragmentManager coi mọi transaction mới là mất state và ném IllegalStateException. commitAllowingStateLoss() nuốt exception đó. Cái giá: UI có thể lệch với state đã lưu — bạn tưởng dialog đã đóng, nhưng sau process death nó quay lại; bạn tưởng tab đã đổi, nhưng người dùng thấy tab cũ.

Không dùng commitAllowingStateLoss để chữa crash. Chỉ dùng khi mất state thật sự chấp nhận được, ví dụ một thay đổi chỉ để log. Cách sửa đúng là commit ở điểm chắc chắn trước khi state bị lưu, hoặc truyền kết quả bằng Fragment Result API thay vì gọi chéo fragment.

Fragment hay composable?

Tiêu chí Fragment (View) Composable (Compose)
Host Activity + FragmentContainerView ComponentActivity + NavDisplay
State savedInstanceState, ViewModel rememberSaveable, ViewModel
Back stack FragmentManager back stack Navigation 3 back stack
Màn hình lồng childFragmentManager, ViewPager2 Hàm composable, HorizontalPager
Tái sử dụng Layout XML + class Fragment Hàm @Composable nhận tham số

Kết luận thực dụng: màn hình mới trong app Compose không cần Fragment. App View-based đang chạy tốt cũng không cần migrate chỉ vì Fragment “cũ”. Chỉ migrate khi bạn đang sửa cả màn hình đó và có test để bắt hồi quy.

Dialogs: DialogFragment và Dialog/AlertDialog

Dialog chặn tương tác với lớp bên dưới. Vì thế nó chỉ nên xuất hiện cho một quyết định ngắn: xác nhận xoá, huỷ tải, đổi tài khoản. Mọi luồng dài hơn nên là màn hình hoặc bottom sheet.

View: DialogFragment

class DeleteNoteDialog : DialogFragment() {
    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog =
        MaterialAlertDialogBuilder(requireContext())
            .setTitle("Xoá ghi chú?")
            .setMessage("Thao tác này không thể hoàn tác.")
            .setPositiveButton("Xoá") { _, _ -> /* gửi kết quả */ }
            .setNegativeButton("Huỷ", null)
            .create()
}

Hiển thị bằng show(parentFragmentManager, "delete_note") khi gọi từ Fragment, hoặc supportFragmentManager khi gọi từ Activity. DialogFragment tồn tại qua xoay máy vì nó được restore cùng Activity. Hai điểm dễ sai: gọi show hai lần với cùng tag sẽ có hai dialog chồng nhau, và interface listener cũ sẽ mất sau khi restore — hãy dùng setFragmentResult/setFragmentResultListener.

Compose: AlertDialog

var showDelete by rememberSaveable { mutableStateOf(false) }

if (showDelete) {
    AlertDialog(
        onDismissRequest = { showDelete = false },
        title = { Text("Xoá ghi chú?") },
        text = { Text("Thao tác này không thể hoàn tác.") },
        confirmButton = {
            TextButton(onClick = { showDelete = false; onDelete() }) { Text("Xoá") }
        },
        dismissButton = {
            TextButton(onClick = { showDelete = false }) { Text("Huỷ") }
        },
    )
}

Trong Compose, dialog chỉ là một nhánh if theo state. Không có lifecycle riêng, không có transaction, không có state loss — đó là lợi ích lớn nhất. Dùng rememberSaveable để cờ sống qua xoay máy. Khi cần layout riêng, dùng Dialog của androidx.compose.ui.window; chỉ bật DialogProperties(dismissOnBackPress = false, dismissOnClickOutside = false) khi thật sự cần chặn, vì người dùng rất ghét dialog không thoát được.

Bottom sheets: BottomSheetDialogFragment và ModalBottomSheet

Modal sheet che nền và buộc người dùng chọn hoặc đóng. Persistent sheet nằm trong layout, kéo lên xuống được, phù hợp cho nội dung luôn hiện diện như thanh phát nhạc. Trong Compose: ModalBottomSheet cho modal, BottomSheetScaffold cho persistent.

View: BottomSheetDialogFragment

class ShareSheet : BottomSheetDialogFragment() {
    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?
    ): View = inflater.inflate(R.layout.sheet_share, container, false)
}

Layout của sheet cần app:layout_behavior="com.google.android.material.bottomsheet.BottomSheetBehavior" trên view gốc, và chiều cao wrap_content. Ưu điểm của cách này là thừa hưởng toàn bộ cơ chế lifecycle, restore và back của Fragment; nhược điểm là mọi lỗi Fragment ở trên cũng áp dụng cho sheet.

Compose: ModalBottomSheet (Material 3 1.4.0)

// File: ShareSheet.kt
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun ShareSheet(onDismiss: () -> Unit, actions: List<ShareAction>) {
    val sheetState = rememberModalBottomSheetState(skipPartiallyExpanded = true)

    ModalBottomSheet(
        onDismissRequest = onDismiss,
        sheetState = sheetState,
        dragHandle = { BottomSheetDefaults.DragHandle() },
    ) {
        Column(
            Modifier
                .fillMaxWidth()
                .navigationBarsPadding()
                .padding(horizontal = 24.dp),
        ) {
            Text("Chia sẻ liên kết", style = MaterialTheme.typography.titleMedium)
            LazyColumn(Modifier.weight(1f)) {
                items(actions, key = { it.id }) { action ->
                    ListItem(
                        headlineContent = { Text(action.label) },
                        leadingContent = { Icon(action.icon, contentDescription = null) },
                        modifier = Modifier.clickable { action.onClick() },
                    )
                }
            }
        }
    }
}

Gọi sheet bằng một boolean ở screen và truyền onDismiss = { showSheet = false }. Đừng gọi sheetState.hide() rồi tự đổi boolean: hide() là suspend và chạy animation, đổi cờ ngay sau đó sẽ làm sheet biến mất giữa animation. Nếu cần chờ, scope.launch { sheetState.hide() } rồi mới đặt cờ.

Với nội dung cuộn được, chỉ để một scrollable trong sheet. Bọc LazyColumn trong Column có verticalScroll là cách nhanh nhất để sheet kẹt ở nửa màn hình và danh sách không cuộn. skipPartiallyExpanded = true giúp tránh trạng thái lửng lơ khi nội dung ngắn.

Drawers: DrawerLayout/NavigationView và ModalNavigationDrawer

Navigation drawer chứa các đích chính của app. Trên điện thoại nó là lớp phủ; trên tablet, drawer vĩnh viễn hoặc NavigationRail thường tốt hơn — material3-adaptive 1.3.0 (qua BOM) giúp bạn rẽ nhánh theo width class thay vì tự đo màn hình.

View: DrawerLayout + NavigationView

<androidx.drawerlayout.widget.DrawerLayout
    android:id="@+id/drawer_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true">

    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/container"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

    <com.google.android.material.navigation.NavigationView
        android:id="@+id/nav_view"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:layout_gravity="start"
        app:menu="@menu/drawer_menu" />
</androidx.drawerlayout.widget.DrawerLayout>

layout_gravity="start" quyết định cạnh trượt ra và tự đảo chiều với ngôn ngữ RTL. ActionBarDrawerToggle đồng bộ icon hamburger với trạng thái drawer; NavigationView.setNavigationItemSelectedListener xử lý chọn mục, và bạn phải tự gọi closeDrawers() sau khi điều hướng.

Compose: ModalNavigationDrawer

// File: AppDrawer.kt
@Composable
fun AppDrawer(
    selected: Destination,
    onSelect: (Destination) -> Unit,
    content: @Composable () -> Unit,
) {
    val drawerState = rememberDrawerState(DrawerValue.Closed)
    val scope = rememberCoroutineScope()

    ModalNavigationDrawer(
        drawerState = drawerState,
        drawerContent = {
            ModalDrawerSheet {
                Spacer(Modifier.height(12.dp))
                Destination.entries.forEach { dest ->
                    NavigationDrawerItem(
                        label = { Text(dest.label) },
                        selected = dest == selected,
                        onClick = {
                            onSelect(dest)
                            scope.launch { drawerState.close() }
                        },
                        modifier = Modifier.padding(NavigationDrawerItemDefaults.ItemPadding),
                    )
                }
            }
        },
        content = content,
    )
}

Mở drawer từ TopAppBar bằng scope.launch { drawerState.open() }; đóng sau khi chọn mục cũng phải qua coroutine vì cả hai đều là suspend. Điểm quan trọng: drawerState phải được tạo ở screen và truyền xuống, không tạo lại bên trong content. Nếu tạo trong content, mỗi lần content được dựng lại state về Closed và drawer tự đóng trước mắt người dùng.

Với Navigation 3, NavDisplay nằm trong content; đổi đích là đẩy key mới vào back stack, còn drawer chỉ mở/đóng lớp phủ. Đừng gắn trạng thái drawer vào back stack — người dùng bấm back để thoát màn hình, không phải để đóng menu.

Bảy bẫy thường gặp

Bẫy Dấu hiệu Cách sửa
State loss IllegalStateException sau onSaveInstanceState Commit sớm, hoặc commitNow ở điểm lifecycle an toàn; không dùng commitAllowingStateLoss để che lỗi
Giữ tham chiếu Fragment Fragment cũ còn sống sau recreate, leak bộ nhớ Lấy lại bằng findFragmentByTag; giao tiếp qua Fragment Result API; không cất Fragment trong ViewModel
Transaction chồng nhau Back stack nhảy sai, pop hai lần mới thoát Gộp thành một transaction, không pop khi còn transaction chờ
Giữ Activity context Leak Activity trong singleton hoặc ViewModel applicationContext cho singleton; requireContext() chỉ dùng trong scope của view
Bottom sheet + nested scroll Sheet kẹt nửa màn hình, list không cuộn Một scrollable duy nhất; bỏ verticalScroll bao ngoài LazyColumn
Drawer state không hoist Drawer tự đóng sau recompose rememberDrawerState ở screen, truyền state và callback xuống
Dialog cho luồng chặn Dialog không dismiss được, mất ngữ cảnh Dùng destination toàn màn hình hoặc bottom sheet; dialog chỉ cho quyết định ngắn

Chọn thành phần nào?

Thành phần App View-based App Compose-first
Màn hình con Fragment + FragmentManager Composable + Navigation 3
Hộp thoại xác nhận DialogFragment AlertDialog
Modal bottom sheet BottomSheetDialogFragment ModalBottomSheet
Drawer điều hướng DrawerLayout + NavigationView ModalNavigationDrawer

Nhìn tới 2027

Material 3 Expressive (1.5.0-rc01) khi lên stable sẽ mang theo bottom sheet, drawer với hình thức mới — API cốt lõi vẫn là ModalBottomSheet và ModalNavigationDrawer, nên code hôm nay không phải viết lại. Navigation 3 tiếp tục thay Navigation 2 trong app mới. Views và Fragment vẫn nhận bản vá, nhưng mọi tính năng UI mới sẽ ra cho Compose trước. Về phía Play: target API 36 đã bắt buộc từ 31/08/2026 (gia hạn tới 01/11/2026), và từ 01/02/2027 bản cập nhật có native library không hỗ trợ page size 16 KB sẽ bị chặn.

Checklist trước khi rời bài này

  • Kiểm tra mọi transaction có guard savedInstanceState == null và có setReorderingAllowed(true).
  • Soát lại các chỗ gọi commitAllowingStateLoss: mỗi chỗ phải có lý do chấp nhận mất state.
  • Null binding trong onDestroyView; dùng viewLifecycleOwner khi collect Flow.
  • Chuyển dialog xác nhận sang cờ rememberSaveable trong Compose, bỏ interface listener cũ.
  • Kiểm tra sheet chỉ có một scrollable và drawer state được tạo ở screen.
  • Chạy thử: xoay máy khi dialog mở, khi drawer mở, và khi bottom sheet đang mở.

Đọc tiếp trong chuỗi: các View cơ bản để nắm lớp nền mà Fragment bọc bên trong, Jetpack Compose để hiểu vì sao dialog và sheet trong Compose không cần Fragment, và Navigation để nối các đích lại với nhau. Toàn bộ thứ tự học nằm ở lộ trình Android.