在此博客中,我们将介绍如何在Jetpack Compose中实现ViewPager2的功能。我们将使用Accompanist库中的Pager库,这是由Google开发的一个用于Jetpack Compose的库。
首先,需要将Pager库添加到你的项目中:
implementation 'androidx.compose.foundation:foundation:1.4.1'
创建Pager
然后,我们创建一个Pager:
案例1
@OptIn(ExperimentalFoundationApi::class)
@Preview
@Composable
fun HorizontalPagerSimpleExample1(){
val pagerState1 =rememberPagerState();
HorizontalPager(pageCount = 5, state = pagerState1) {
Box(modifier = Modifier
.fillMaxSize()
.background(Color.Green), contentAlignment = Alignment.Center){
Text(text = "页面:$it")
}
}
}
案例2: 带下一个和上一个按钮的水平寻呼机(手动滚动)
在下一个示例中,我们将添加“下一个”和“上一个”按钮以显示 的用法rememberPagerState
,您可以使用它们手动滚动到特定页面,如下例所示
@OptIn(ExperimentalFoundationApi::class)
@Preview
@Composable
fun HorizontalPagerWithNextPrevButtonExample(){
val pagerState = rememberPagerState()
val coroutineScope = rememberCoroutineScope()
Box(
modifier = Modifier
.fillMaxWidth()
.height(300.dp)
){
HorizontalPager(pageCount = 5, state = pagerState) { pagerIndex->
Box(modifier = Modifier
.fillMaxSize()
.background(Color.Green), contentAlignment = Alignment.Center){
Text(text = "页面索引$pagerIndex")
}
}
Row(modifier = Modifier
.align(Alignment.BottomCenter)
.padding(bottom = 16.dp), horizontalArrangement = Arrangement.spacedBy(8.dp)){
val preButtonVisible = remember{
derivedStateOf{
pagerState.currentPage>0
}
}
val nextButtonVisible= remember {
derivedStateOf {
pagerState.currentPage<4
}
}
Button(enabled = preButtonVisible.value,
onClick = {
val prevPageIndex = pagerState.currentPage-1
coroutineScope.launch { pagerState.animateScrollToPage(prevPageIndex) }
}) {
Text(text = "Prev")
}
Button(enabled = nextButtonVisible.value, onClick = {
val nextPageIndex= pagerState.currentPage+1
coroutineScope.launch { pagerState.animateScrollToPage(nextPageIndex) }
}) {
Text(text = "next")
}
}
}
}
我们用来在上面Box
放置Next
和按钮Prev
HorizontalPager
derivedStateOf
Api 用于确定何时启用Next
和Prev
按钮。derivedStateOf
在这里是一个理想的选择,因为我们不想每次页面索引更改时都重新组合按钮,以避免不必要的重新组合。
案例3:具有图像和点指示器的水平页面
在下一个示例中,我们希望显示内部图像HorizontalPager
,并在底部显示点指示器。对于点指 示器,我们将使用accompanistHorizontalPagerIndicator
的 Api 。Api 仍然没有移至官方的 compose 依赖项,这就是为什么我们必须使用accompanist并且它与Jetpack compose 基础依 赖项兼容。HorizontalPagerIndicator
HorizontalPager
添加以下依赖项,请参阅accompanistHorizontalPagerIndicator
的 github 存储库的 Readme 部分中的兼容版本。
implementation "com.google.accompanist:accompanist-pager-indicators:0.30.1"
@OptIn(ExperimentalFoundationApi::class)
@Composable
fun HorizontalPagerWithIndicators(images: List<Int>) {
val pagerState= rememberPagerState()
Box(modifier = Modifier
.fillMaxWidth()
.height(300.dp)){
HorizontalPager(pageCount = 5, state = pagerState) {
Image(painter = painterResource(id = images[it]),
contentScale = ContentScale.Crop,
modifier = Modifier.fillMaxWidth(),
contentDescription = "")
}
HorizontalPagerIndicator(
modifier=Modifier.align(Alignment.BottomCenter)
.padding(bottom = 10.dp),
pageCount = 5,
pagerState=pagerState,
)
}
}
HorizontalPagerIndicator
可组合性正在采取pageCount
和pagerState
pageCount
必须与我们传递的相同,其中HorizontalPager
也采用通过创建的pagerState
相同引用传递,因此两者和必须将相同的寻呼机状态传递给它们以便彼此同步。HorizontalPager
rememberPagerState() 和
HorizontalPager
HorizontalPagerIndicator
HorizontalPager
每页显示一个图像,正在使用当前页面的索引从图像列表中访问该图像。
Box
用于覆盖HorizontalPagerIndicator
在上面HorizontalPager
案例4:
带图像的垂直页面
HorizontalPager
我们在上面的故事中看到了一些例子。现在让我们看看VerticalPager.
我们将使用图像列表来显示VerticalPager
。下面的代码。
@Preview
@Composable
fun VerticalPagerWithImagesAndIndicatorsScreen() {
val images = listOf(
R.mipmap.img1,
R.mipmap.img2,
R.mipmap.img3,
R.mipmap.img4,
R.mipmap.img1,
)
Column {
VerticalPagerWithImagesAndIndicators(images)
}
}
@OptIn(ExperimentalFoundationApi::class)
@Composable
fun VerticalPagerWithImagesAndIndicators(images: List<Int>) {
val pagerState = rememberPagerState()
VerticalPager(
pageCount = 5,
pageSize = PageSize.Fixed(300.dp),
pageSpacing = 8.dp,
state = pagerState
) {
Image(
modifier=Modifier.fillMaxSize(),
painter = painterResource(id = images[it]),
contentDescription = "",
contentScale = ContentScale.Crop
)
}
}