A horizontal indicator for a Pager, representing the currently active page and total pages drawn using a Shape. It shows up to 6 pages on the screen and doesn't represent the exact page index if there are more than 6 pages. Instead of showing the exact position, HorizontalPageIndicator shows a half-size indicator on the left or on the right if there are more pages.
HorizontalPageIndicator
Android
@Composable
public fun HorizontalPageIndicator(
pageIndicatorState: PageIndicatorState,
modifier: Modifier = Modifier,
indicatorStyle: PageIndicatorStyle = PageIndicatorDefaults.style(),
selectedColor: Color = MaterialTheme.colors.onBackground,
unselectedColor: Color = selectedColor.copy(alpha = 0.3f),
indicatorSize: Dp = 6.dp,
spacing: Dp = 4.dp,
indicatorShape: Shape = CircleShape,
)
Parameters
| pageIndicatorState | The state object of a HorizontalPageIndicator to be used to observe the Pager's state. |
| modifier | Modifier to be applied to the HorizontalPageIndicator |
| indicatorStyle | The style of HorizontalPageIndicator - may be linear or curved. By default determined by the screen shape. |
| selectedColor | The color of the selected HorizontalPageIndicator item |
| unselectedColor | The color of unselected HorizontalPageIndicator items. Defaults to selectedColor with 30% alpha |
| indicatorSize | The size of each HorizontalPageIndicator item in Dp |
| spacing | The spacing between indicator items in Dp |
| indicatorShape | The shape of each HorizontalPageIndicator item. Defaults to CircleShape |