Cuộn

Đối tượng sửa đổi cho thao tác cuộn

Đối tượng sửa đổi verticalScrollhorizontalScroll cung cấp cách đơn giản nhất để người dùng cuộn một phần tử khi nội dung của phần tử đó lớn hơn giới hạn kích thước tối đa. Với phương thức sửa đổi verticalScrollhorizontalScroll, bạn không cần dịch hoặc bù trừ phần nội dung.

@Composable
private fun ScrollBoxes() {
    Column(
        modifier = Modifier
            .background(Color.LightGray)
            .size(100.dp)
            .verticalScroll(rememberScrollState())
    ) {
        repeat(10) {
            Text("Item $it", modifier = Modifier.padding(2.dp))
        }
    }
}

Một danh sách theo chiều dọc đơn giản phản hồi các cử chỉ cuộn

ScrollState cho phép bạn thay đổi vị trí thanh cuộn hoặc xem trạng thái hiện tại của vị trí thanh cuộn. Để tạo lớp này với các tham số mặc định, hãy sử dụng rememberScrollState().

@Composable
private fun ScrollBoxesSmooth() {
    // Smoothly scroll 100px on first composition
    val state = rememberScrollState()
    LaunchedEffect(Unit) { state.animateScrollTo(100) }

    Column(
        modifier = Modifier
            .background(Color.LightGray)
            .size(100.dp)
            .padding(horizontal = 8.dp)
            .verticalScroll(state)
    ) {
        repeat(10) {
            Text("Item $it", modifier = Modifier.padding(2.dp))
        }
    }
}

Đối tượng sửa đổi cho các mục cuộn được (scrollable)

Đối tượng sửa đổi scrollable khác với đối tượng sửa đổi thao tác cuộn ở chỗ scrollable phát hiện các cử chỉ cuộn và ghi lại delta, nhưng không tự động bù trừ nội dung. Thay vào đó, việc này được uỷ quyền cho người dùng thông qua ScrollableState. Đây là điều kiện cần để đối tượng sửa đổi này hoạt động chính xác.

Khi xây dựng ScrollableState, bạn phải cung cấp một hàm consumeScrollDelta. Hàm này sẽ được gọi trong mỗi bước cuộn (thông qua cử chỉ nhập, cuộn hoặc hất nhẹ) với delta được tính bằng pixel. Hàm này phải trả về khoảng cách đã cuộn để đảm bảo truyền sự kiện đúng cách trong trường hợp có các phần tử lồng nhau có đối tượng sửa đổi scrollable.

Đoạn mã sau đây phát hiện các cử chỉ và cho thấy một giá trị dạng số cho một phần bù trừ, nhưng không bù trừ phần tử nào:

@Composable
private fun ScrollableSample() {
    // actual composable state
    var offset by remember { mutableStateOf(0f) }
    Box(
        Modifier
            .size(150.dp)
            .scrollable(
                orientation = Orientation.Vertical,
                // Scrollable state: describes how to consume
                // scrolling delta and update offset
                state = rememberScrollableState { delta ->
                    offset += delta
                    delta
                }
            )
            .background(Color.LightGray),
        contentAlignment = Alignment.Center
    ) {
        Text(offset.toString())
    }
}

Một thành phần trên giao diện người dùng phát hiện thao tác nhấn ngón tay và hiển thị giá trị dạng số cho vị trí của ngón tay

Cuộn lồng

Cuộn lồng nhau là một hệ thống trong đó nhiều thành phần cuộn nằm trong nhau hoạt động cùng nhau bằng cách phản ứng với một thao tác cuộn duy nhất và thông báo về delta (thay đổi) cuộn của chúng.

Hệ thống cuộn lồng cho phép điều phối giữa các thành phần có thể cuộn và được liên kết theo phân cấp (thường là bằng cách chia sẻ cùng một thành phần mẹ). Hệ thống này liên kết các vùng chứa cuộn và cho phép tương tác với các delta cuộn đang được truyền và chia sẻ giữa các vùng chứa.

Compose cung cấp nhiều cách để xử lý tính năng cuộn lồng nhau giữa các thành phần kết hợp. Ví dụ điển hình của tính năng cuộn trong lớp khác là một danh sách con nằm trong một danh sách lớn hơn. Ví dụ phức tạp hơn là thanh công cụ có thể thu gọn.

Tự động lồng tính năng cuộn trong lớp khác

Bạn không cần làm gì khi chỉ đơn giản lồng tính năng cuộn trong lớp khác. Những cử chỉ khởi tạo thao tác cuộn sẽ tự động được truyền tải từ phần tử con đến phần tử mẹ, chẳng hạn như khi phần tử con không thể cuộn thêm nữa thì cử chỉ sẽ do phần tử mẹ xử lý.

Một số thành phần và đối tượng sửa đổi của Compose hỗ trợ và cung cấp tính năng cuộn dạng lồng tự động ngay từ đầu như: các API verticalScroll, horizontalScroll, scrollable, LazyTextField. Tức là khi người dùng cuộn một phần tử con bên trong các thành phần lồng nhau, thì các đối tượng sửa đổi trước đó sẽ truyền delta cuộn đến những phần tử mẹ có hỗ trợ tính năng cuộn lồng.

Ví dụ sau đây cho thấy các phần tử có đối tượng sửa đổi verticalScroll và nằm trong một vùng chứa cũng có đối tượng sửa đổi verticalScroll.

@Composable
private fun AutomaticNestedScroll() {
    val gradient = Brush.verticalGradient(0f to Color.Gray, 1000f to Color.White)
    Box(
        modifier = Modifier
            .background(Color.LightGray)
            .verticalScroll(rememberScrollState())
            .padding(32.dp)
    ) {
        Column {
            repeat(6) {
                Box(
                    modifier = Modifier
                        .height(128.dp)
                        .verticalScroll(rememberScrollState())
                ) {
                    Text(
                        "Scroll here",
                        modifier = Modifier
                            .border(12.dp, Color.DarkGray)
                            .background(brush = gradient)
                            .padding(24.dp)
                            .height(150.dp)
                    )
                }
            }
        }
    }
}

Hai thành phần có thể cuộn dọc trên giao diện người dùng được lồng vào nhau, phản hồi với các cử chỉ bên trong và bên ngoài phần tử bên trong

Sử dụng đối tượng sửa đổi nestedScroll

Nếu bạn cần tạo một thao tác cuộn phối hợp nâng cao giữa nhiều phần tử, đối tượng sửa đổi nestedScroll sẽ giúp bạn tăng tính linh hoạt bằng cách xác định một hệ thống phân cấp cuộn khi lồng ghép vào nhau. Như đã đề cập trong phần trước, một số thành phần đã tích hợp sẵn chức năng hỗ trợ cuộn lồng. Tuy nhiên, đối với các thành phần kết hợp không tự động cuộn được, chẳng hạn như Box hoặc Column, các delta cuộn trên những thành phần đó sẽ không truyền trong hệ thống cuộn lồng, đồng thời sẽ không tiếp cận được NestedScrollConnection cũng như thành phần mẹ. Để giải quyết vấn đề này, bạn có thể sử dụng nestedScroll để trao quyền hỗ trợ cho các thành phần khác, bao gồm cả thành phần tuỳ chỉnh.

Vòng lặp cuộn lồng

Vòng lặp cuộn lồng nhau là luồng của các delta cuộn được gửi lên và xuống cây hệ phân cấp thông qua tất cả các thành phần (hoặc nút) thuộc hệ thống cuộn lồng nhau, ví dụ: bằng cách sử dụng các thành phần và đối tượng sửa đổi có thể cuộn hoặc nestedScroll.

Các giai đoạn của chu kỳ cuộn lồng nhau

Khi một sự kiện kích hoạt (ví dụ: một cử chỉ) được phát hiện bởi một thành phần có thể cuộn, trước khi hành động cuộn thực tế được kích hoạt, các delta được tạo sẽ được gửi đến hệ thống cuộn lồng nhau và trải qua ba giai đoạn: cuộn trước, tiêu thụ nút và cuộn sau.

Các giai đoạn của chu kỳ cuộn lồng nhau

Trong giai đoạn trước khi cuộn đầu tiên, thành phần đã nhận được các delta sự kiện kích hoạt sẽ gửi các sự kiện đó lên thông qua cây hệ phân cấp đến thành phần mẹ trên cùng. Sau đó, các sự kiện delta sẽ được truyền xuống, nghĩa là delta sẽ được truyền từ phần tử mẹ gốc nhất xuống phần tử con đã bắt đầu chu kỳ cuộn lồng.

Giai đoạn trước khi cuộn – gửi lên

Điều này giúp các thành phần mẹ cuộn lồng nhau (các thành phần kết hợp sử dụng nestedScroll hoặc đối tượng sửa đổi có thể cuộn) có cơ hội thực hiện một số thao tác với delta trước khi chính nút có thể sử dụng delta đó.

Giai đoạn trước khi cuộn – đẩy xuống

Trong giai đoạn tiêu thụ nút, chính nút đó sẽ sử dụng bất kỳ delta nào mà các nút mẹ không sử dụng. Đây là thời điểm thao tác cuộn thực sự hoàn tất và hiển thị.

Giai đoạn tiêu thụ nút

Trong giai đoạn này, thành phần con có thể chọn sử dụng toàn bộ hoặc một phần cuộn còn lại. Mọi nội dung còn lại sẽ được gửi trở lại để trải qua giai đoạn sau khi cuộn.

Cuối cùng, trong giai đoạn sau khi cuộn, mọi nội dung mà chính nút không sử dụng sẽ được gửi lại cho các nút cấp trên để sử dụng.

Giai đoạn sau khi cuộn – gửi lên

Giai đoạn sau khi cuộn hoạt động tương tự như giai đoạn trước khi cuộn, trong đó bất kỳ thành phần mẹ nào cũng có thể chọn sử dụng hoặc không sử dụng.

Giai đoạn sau khi cuộn – đẩy xuống

Tương tự như thao tác cuộn, khi một cử chỉ kéo kết thúc, ý định của người dùng có thể được chuyển thành một vận tốc dùng để hất (cuộn bằng ảnh động) vùng chứa có thể cuộn. Thao tác hất cũng là một phần của chu kỳ cuộn lồng nhau và các tốc độ do sự kiện kéo tạo ra sẽ trải qua các giai đoạn tương tự: trước khi hất, tiêu thụ nút và sau khi hất. Xin lưu ý rằng ảnh động hất chỉ liên kết với cử chỉ chạm và sẽ không được kích hoạt bởi các sự kiện khác, chẳng hạn như a11y hoặc cuộn phần cứng.

Tham gia chu kỳ cuộn lồng nhau

Việc tham gia chu kỳ này có nghĩa là chặn, sử dụng và báo cáo mức sử dụng delta dọc theo hệ phân cấp. Compose cung cấp một bộ công cụ để ảnh hưởng đến cách hoạt động của hệ thống cuộn lồng và cách tương tác trực tiếp với hệ thống đó, chẳng hạn như khi bạn cần làm gì đó với delta cuộn trước khi thành phần có thể cuộn bắt đầu cuộn.

Nếu chu kỳ cuộn lồng nhau là một hệ thống hoạt động trên một chuỗi các nút, thì đối tượng sửa đổi nestedScroll là một cách để chặn và chèn vào các thay đổi này, đồng thời ảnh hưởng đến dữ liệu (delta cuộn) được truyền trong chuỗi. Bạn có thể đặt đối tượng sửa đổi này ở bất kỳ vị trí nào trong hệ phân cấp và đối tượng này sẽ giao tiếp với các thực thể đối tượng sửa đổi cuộn lồng nhau trên cây để có thể chia sẻ thông tin thông qua kênh này. Các khối xây dựng của đối tượng sửa đổi này là NestedScrollConnectionNestedScrollDispatcher.

NestedScrollConnection cung cấp một cách để phản hồi các giai đoạn của chu kỳ cuộn lồng và ảnh hưởng đến hệ thống cuộn lồng. Thành phần này bao gồm 4 phương thức gọi lại, mỗi phương thức đại diện cho một trong các giai đoạn tiêu thụ: trước/sau khi cuộn và trước/sau khi hất:

val nestedScrollConnection = object : NestedScrollConnection {
    override fun onPreScroll(available: Offset, source: NestedScrollSource): Offset {
        println("Received onPreScroll callback.")
        return Offset.Zero
    }

    override fun onPostScroll(
        consumed: Offset,
        available: Offset,
        source: NestedScrollSource
    ): Offset {
        println("Received onPostScroll callback.")
        return Offset.Zero
    }
}

Mỗi lệnh gọi lại cũng cung cấp thông tin về delta đang được truyền: delta available cho giai đoạn cụ thể đó và delta consumed được sử dụng trong các giai đoạn trước. Nếu muốn ngừng truyền delta lên hệ phân cấp bất cứ lúc nào, bạn có thể sử dụng kết nối cuộn lồng nhau để thực hiện việc này:

val disabledNestedScrollConnection = remember {
    object : NestedScrollConnection {
        override fun onPostScroll(
            consumed: Offset,
            available: Offset,
            source: NestedScrollSource
        ): Offset {
            return if (source == NestedScrollSource.SideEffect) {
                available
            } else {
                Offset.Zero
            }
        }
    }
}

Tất cả lệnh gọi lại đều cung cấp thông tin về loại NestedScrollSource.

NestedScrollDispatcher khởi tạo chu kỳ cuộn lồng. Việc sử dụng trình điều phối và gọi các phương thức của trình điều phối sẽ kích hoạt chu kỳ. Các vùng chứa có thể cuộn có một trình điều phối tích hợp sẵn sẽ gửi các delta được ghi lại trong cử chỉ vào hệ thống. Vì lý do này, hầu hết các trường hợp sử dụng để tuỳ chỉnh tính năng cuộn lồng nhau đều liên quan đến việc sử dụng NestedScrollConnection thay vì trình điều phối để phản ứng với các delta đã có sẵn thay vì gửi các delta mới. Hãy xem NestedScrollDispatcherSample để biết thêm cách sử dụng.

Đổi kích thước hình ảnh khi cuộn

Khi người dùng cuộn, bạn có thể tạo hiệu ứng hình ảnh động trong đó hình ảnh thay đổi kích thước dựa trên vị trí cuộn.

Đổi kích thước hình ảnh dựa trên vị trí cuộn

Đoạn mã này minh hoạ cách đổi kích thước hình ảnh trong LazyColumn dựa trên vị trí cuộn dọc. Hình ảnh sẽ thu nhỏ khi người dùng cuộn xuống và tăng lên khi họ cuộn lên, vẫn nằm trong giới hạn kích thước tối thiểu và tối đa đã xác định:

@Composable
fun ImageResizeOnScrollExample(
    modifier: Modifier = Modifier,
    maxImageSize: Dp = 300.dp,
    minImageSize: Dp = 100.dp
) {
    var currentImageSize by remember { mutableStateOf(maxImageSize) }
    var imageScale by remember { mutableFloatStateOf(1f) }

    val nestedScrollConnection = remember {
        object : NestedScrollConnection {
            override fun onPreScroll(available: Offset, source: NestedScrollSource): Offset {
                // Calculate the change in image size based on scroll delta
                val delta = available.y
                val newImageSize = currentImageSize + delta.dp
                val previousImageSize = currentImageSize

                // Constrain the image size within the allowed bounds
                currentImageSize = newImageSize.coerceIn(minImageSize, maxImageSize)
                val consumed = currentImageSize - previousImageSize

                // Calculate the scale for the image
                imageScale = currentImageSize / maxImageSize

                // Return the consumed scroll amount
                return Offset(0f, consumed.value)
            }
        }
    }

    Box(Modifier.nestedScroll(nestedScrollConnection)) {
        LazyColumn(
            Modifier
                .fillMaxWidth()
                .padding(15.dp)
                .offset {
                    IntOffset(0, currentImageSize.roundToPx())
                }
        ) {
            // Placeholder list items
            items(100, key = { it }) {
                Text(
                    text = "Item: $it",
                    style = MaterialTheme.typography.bodyLarge
                )
            }
        }

        Image(
            painter = ColorPainter(Color.Red),
            contentDescription = "Red color image",
            Modifier
                .size(maxImageSize)
                .align(Alignment.TopCenter)
                .graphicsLayer {
                    scaleX = imageScale
                    scaleY = imageScale
                    // Center the image vertically as it scales
                    translationY = -(maxImageSize.toPx() - currentImageSize.toPx()) / 2f
                }
        )
    }
}

Các điểm chính về mã

  • Mã này sử dụng NestedScrollConnection để chặn các sự kiện cuộn.
  • onPreScroll tính toán sự thay đổi về kích thước hình ảnh dựa trên delta cuộn.
  • Biến trạng thái currentImageSize lưu trữ kích thước hiện tại của hình ảnh, bị ràng buộc giữa minImageSizemaxImageSize. imageScale bắt nguồn từ currentImageSize.
  • Độ lệch LazyColumn dựa trên currentImageSize.
  • Image sử dụng đối tượng sửa đổi graphicsLayer để áp dụng tỷ lệ được tính toán.
  • translationY trong graphicsLayer đảm bảo hình ảnh vẫn nằm ở giữa theo chiều dọc khi điều chỉnh theo tỷ lệ.

Kết quả

Đoạn mã trước đó sẽ tạo hiệu ứng hình ảnh theo tỷ lệ khi cuộn:

Hình 1. Hiệu ứng điều chỉnh tỷ lệ hình ảnh khi cuộn.

Khả năng tương tác cuộn lồng

Khi cố gắng lồng các phần tử View cuộn được trong thành phần kết hợp có thể cuộn được hoặc ngược lại, bạn có thể gặp một vài sự cố. Sự cố đáng kể nhất sẽ xảy ra khi bạn cuộn thành phần con và tiếp cận ranh giới bắt đầu hoặc kết thúc, đồng thời mong đợi thành phần mẹ sẽ cuộn qua. Tuy nhiên, hành vi dự kiến này có thể không xảy ra hoặc có thể không hoạt động như mong đợi.

Vấn đề này là do việc kỳ vọng các thành phần kết hợp có thể cuộn được mà ra. Các thành phần kết hợp có thể cuộn đều có quy tắc "nested-scroll-by-default", nghĩa là bất kỳ vùng chứa nào có thể cuộn cũng đều phải tham gia vào chuỗi cuộn lồng, cả ở dạng thành phần mẹ thông qua NestedScrollConnection và thành phần con thông qua NestedScrollDispatcher. Sau đó thành phần con sẽ đẩy hoạt động cuộn lồng cho cha mẹ khi nó tiếp cận ranh giới. Ví dụ: quy tắc này cho phép Compose Pager và Compose LazyRow hoạt động hiệu quả cùng nhau. Tuy nhiên, khi thực hiện thao tác cuộn tương tác với ViewPager2 hoặc RecyclerView, vì các thao tác này không triển khai được NestedScrollingParent3 nên không thể cuộn liên tục từ thành phần con sang thành phần mẹ.

Để bật API tương tác cuộn lồng giữa các phần tử View có thể cuộn và thành phần kết hợp có thể cuộn đồng thời lồng theo cả hai hướng, bạn có thể sử dụng API tương tác có thể cuộn lồng để giảm thiểu những vấn đề này trong các trường hợp sau.

Thành phần mẹ hợp tác View chứa một thành phần con ComposeView

Thành phần mẹ hợp tác View là một thành phần đã triển khai NestedScrollingParent3, và do đó có thể nhận các delta cuộn được từ thành phần kết hợp con hợp tác được lồng. ComposeView sẽ đóng vai trò là con trong trường hợp này và cần (gián tiếp) triển khai NestedScrollingChild3. androidx.coordinatorlayout.widget.CoordinatorLayout là một ví dụ về vai trò hợp tác của thành phần mẹ.

Nếu cần khả năng tương tác cuộn lồng giữa vùng chứa thành phần mẹ View cuộn được và các thành phần kết hợp con có thể cuộn lồng, bạn có thể sử dụng rememberNestedScrollInteropConnection().

rememberNestedScrollInteropConnection() nhận và ghi nhớ NestedScrollConnection, cho phép bật khả năng tương tác cuộn lồng giữa một View mẹ có thể triển khai NestedScrollingParent3 và một Compose con. Bạn nên dùng thuộc tính này cùng với công cụ sửa đổi nestedScroll. Vì tính năng cuộn lồng được bật theo mặc định trên Compose nên bạn có thể sử dụng kết nối này để cho phép cả cuộn lồng từ View, đồng thời thêm logic kết dính cần thiết giữa Views và thành phần kết hợp.

Việc dùng CoordinatorLayout, CollapsingToolbarLayout và một thành phần kết hợp con là những trường hợp sử dụng thường xuyên, như trong ví dụ sau:

<androidx.coordinatorlayout.widget.CoordinatorLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.google.android.material.appbar.AppBarLayout
        android:id="@+id/app_bar"
        android:layout_width="match_parent"
        android:layout_height="100dp"
        android:fitsSystemWindows="true">

        <com.google.android.material.appbar.CollapsingToolbarLayout
            android:id="@+id/collapsing_toolbar_layout"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:fitsSystemWindows="true"
            app:layout_scrollFlags="scroll|exitUntilCollapsed">

            <!--...-->

        </com.google.android.material.appbar.CollapsingToolbarLayout>

    </com.google.android.material.appbar.AppBarLayout>

    <androidx.compose.ui.platform.ComposeView
        android:id="@+id/compose_view"
        app:layout_behavior="@string/appbar_scrolling_view_behavior"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</androidx.coordinatorlayout.widget.CoordinatorLayout>

Trong Hoạt động hoặc Mảnh, bạn cần phải thiết lập thành phần kết hợp con và NestedScrollConnection bắt buộc:

open class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        findViewById<ComposeView>(R.id.compose_view).apply {
            setContent {
                val nestedScrollInterop = rememberNestedScrollInteropConnection()
                // Add the nested scroll connection to your top level @Composable element
                // using the nestedScroll modifier.
                LazyColumn(modifier = Modifier.nestedScroll(nestedScrollInterop)) {
                    items(20) { item ->
                        Box(
                            modifier = Modifier
                                .padding(16.dp)
                                .height(56.dp)
                                .fillMaxWidth()
                                .background(Color.Gray),
                            contentAlignment = Alignment.Center
                        ) {
                            Text(item.toString())
                        }
                    }
                }
            }
        }
    }
}

Thành phần kết hợp mẹ chứa AndroidView con

Tình huống này bao gồm việc triển khai API tương tác cuộn lồng ở phía Compose – khi bạn có một thành phần kết hợp mẹ chứa AndroidView con. AndroidView triển khai NestedScrollDispatcher, vì nó hoạt động như một phần tử con đối với thành phần mẹ đang cuộn trong Compose, cũng như NestedScrollingParent3 vì nó hoạt động như một thành phần mẹ của View con đang cuộn. Sau đó, thành phần mẹ trong Compose sẽ có thể nhận được các delta cuộn lồng từ một View con có thể cuộn lồng.

Hãy xem ví dụ sau để biết cách bạn có thể đạt được khả năng tương tác cuộn lồng trong tình huống này, cùng với thanh công cụ thu gọn Compose:

@Composable
private fun NestedScrollInteropComposeParentWithAndroidChildExample() {
    val toolbarHeightPx = with(LocalDensity.current) { ToolbarHeight.roundToPx().toFloat() }
    val toolbarOffsetHeightPx = remember { mutableStateOf(0f) }

    // Sets up the nested scroll connection between the Box composable parent
    // and the child AndroidView containing the RecyclerView
    val nestedScrollConnection = remember {
        object : NestedScrollConnection {
            override fun onPreScroll(available: Offset, source: NestedScrollSource): Offset {
                // Updates the toolbar offset based on the scroll to enable
                // collapsible behaviour
                val delta = available.y
                val newOffset = toolbarOffsetHeightPx.value + delta
                toolbarOffsetHeightPx.value = newOffset.coerceIn(-toolbarHeightPx, 0f)
                return Offset.Zero
            }
        }
    }

    Box(
        Modifier
            .fillMaxSize()
            .nestedScroll(nestedScrollConnection)
    ) {
        TopAppBar(
            modifier = Modifier
                .height(ToolbarHeight)
                .offset { IntOffset(x = 0, y = toolbarOffsetHeightPx.value.roundToInt()) }
        )

        AndroidView(
            { context ->
                LayoutInflater.from(context)
                    .inflate(R.layout.view_in_compose_nested_scroll_interop, null).apply {
                        with(findViewById<RecyclerView>(R.id.main_list)) {
                            layoutManager = LinearLayoutManager(context, VERTICAL, false)
                            adapter = NestedScrollInteropAdapter()
                        }
                    }.also {
                        // Nested scrolling interop is enabled when
                        // nested scroll is enabled for the root View
                        ViewCompat.setNestedScrollingEnabled(it, true)
                    }
            },
            // ...
        )
    }
}

private class NestedScrollInteropAdapter :
    Adapter<NestedScrollInteropAdapter.NestedScrollInteropViewHolder>() {
    val items = (1..10).map { it.toString() }

    override fun onCreateViewHolder(
        parent: ViewGroup,
        viewType: Int
    ): NestedScrollInteropViewHolder {
        return NestedScrollInteropViewHolder(
            LayoutInflater.from(parent.context)
                .inflate(R.layout.list_item, parent, false)
        )
    }

    override fun onBindViewHolder(holder: NestedScrollInteropViewHolder, position: Int) {
        // ...
    }

    class NestedScrollInteropViewHolder(view: View) : ViewHolder(view) {
        fun bind(item: String) {
            // ...
        }
    }
    // ...
}

Ví dụ này cho thấy cách bạn có thể sử dụng API với công cụ sửa đổi scrollable:

@Composable
fun ViewInComposeNestedScrollInteropExample() {
    Box(
        Modifier
            .fillMaxSize()
            .scrollable(rememberScrollableState {
                // View component deltas should be reflected in Compose
                // components that participate in nested scrolling
                it
            }, Orientation.Vertical)
    ) {
        AndroidView(
            { context ->
                LayoutInflater.from(context)
                    .inflate(android.R.layout.list_item, null)
                    .apply {
                        // Nested scrolling interop is enabled when
                        // nested scroll is enabled for the root View
                        ViewCompat.setNestedScrollingEnabled(this, true)
                    }
            }
        )
    }
}

Sau cùng, ví dụ này cho thấy cách API tương tác cuộn lồng được sử dụng với BottomSheetDialogFragment để đạt được hành vi kéo và loại bỏ thành công:

class BottomSheetFragment : BottomSheetDialogFragment() {

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        val rootView: View = inflater.inflate(R.layout.fragment_bottom_sheet, container, false)

        rootView.findViewById<ComposeView>(R.id.compose_view).apply {
            setContent {
                val nestedScrollInterop = rememberNestedScrollInteropConnection()
                LazyColumn(
                    Modifier
                        .nestedScroll(nestedScrollInterop)
                        .fillMaxSize()
                ) {
                    item {
                        Text(text = "Bottom sheet title")
                    }
                    items(10) {
                        Text(
                            text = "List item number $it",
                            modifier = Modifier.fillMaxWidth()
                        )
                    }
                }
            }
            return rootView
        }
    }
}

Xin lưu ý rằng rememberNestedScrollInteropConnection() sẽ cài đặt NestedScrollConnection trong phần tử bạn đã đính kèm vào đó. NestedScrollConnection chịu trách nhiệm truyền các delta từ cấp Compose sang cấp View. Điều này cho phép phần tử đó tham gia vào quá trình cuộn lồng, nhưng không cho phép tự động cuộn các phần tử. Đối với các thành phần kết hợp không thể tự động cuộn, chẳng hạn như Box hoặcColumn, các delta cuộn trên những thành phần đó sẽ không truyền trong hệ thống cuộn lồng và không tiếp cận được NestedScrollConnection do rememberNestedScrollInteropConnection() cung cấp, theo đó các delta này sẽ không tiếp cận được thành phần View mẹ. Để giải quyết vấn đề này, hãy đảm bảo bạn cũng đặt công cụ sửa đổi có thể cuộn cho các loại thành phần kết hợp có thể lồng ghép. Bạn có thể tham khảo phần trước về Cuộn lồng để biết thêm thông tin chi tiết.

View mẹ không hợp tác chứa ComposeView con

Chế độ xem không hợp tác là chế độ không triển khai các giao diệnNestedScrolling cần thiết ở phía View. Vui lòng lưu ý điều này có nghĩa là khả năng tương tác cuộn lồng với các Views này không hoạt động hiệu quả. Views không hợp tác là RecyclerViewViewPager2.