horizontalScroll

Modifier in Compose Foundation

Modify element to allow to scroll horizontally when width of the content is bigger than max constraints allow.

Last updated: 2024-10-22 13:47

Installation

dependencies {
   implementation("androidx.compose.foundation:foundation:1.8.0-alpha04")
}

Overloads

fun Modifier.horizontalScroll(
    state: ScrollState,
    enabled: Boolean = true,
    flingBehavior: FlingBehavior? = null,
    reverseScrolling: Boolean = false
)

Parameters

name	description
state	state of the scroll
enabled	whether or not scrolling via touch input is enabled
flingBehavior	logic describing fling behavior when drag has finished with velocity. If null, default from [ScrollableDefaults.flingBehavior] will be used.
reverseScrolling	reverse the direction of scrolling, when true, 0 [ScrollState.value] will mean right, when false, 0 [ScrollState.value] will mean left

Code Example

HorizontalScrollSample

@Composable
fun HorizontalScrollSample() {
    val scrollState = rememberScrollState()
    val gradient =
        Brush.horizontalGradient(
            listOf(Color.Red, Color.Blue, Color.Green),
            0.0f,
            10000.0f,
            TileMode.Repeated
        )
    Box(
        Modifier.horizontalScroll(scrollState)
            .size(width = 10000.dp, height = 200.dp)
            .background(brush = gradient)
    )
}