news 2026/6/11 0:42:26

Android Jetpack Compose - TopAppBar、BottomAppBar、Scaffold

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Android Jetpack Compose - TopAppBar、BottomAppBar、Scaffold

一、TopAppBar

1、基本介绍
  • TopAppBar 用于实现顶部的应用栏，它封装了顶部的应用栏的常见样式和交互，例如，标题、导航图标、操作按钮、滚动联动
参数说明
title显示在应用栏中的文字
navigationIcon用于导航的主图标，显示在应用栏的左侧
actions可让用户访问关键操作的图标，它们显示在应用栏的右侧
scrollBehavior确定顶部应用栏如何响应容器内部内容的滚动
colors确定应用栏的显示方式
2、演示
TopAppBar(colors=topAppBarColors(containerColor=MaterialTheme.colorScheme.primaryContainer,titleContentColor=MaterialTheme.colorScheme.primary,),title={Text("顶部的应用栏")})
TopAppBar(colors=topAppBarColors(containerColor=MaterialTheme.colorScheme.primaryContainer,titleContentColor=MaterialTheme.colorScheme.primary,),navigationIcon={IconButton(onClick={}){Icon(imageVector=Icons.AutoMirrored.Filled.ArrowBack,contentDescription="返回")}},actions={IconButton(onClick={}){Icon(imageVector=Icons.Filled.Menu,contentDescription="菜单")}},title={Text("顶部的应用栏")})
valscrollBehavior=TopAppBarDefaults.pinnedScrollBehavior(rememberTopAppBarState())Column(modifier=Modifier.fillMaxSize()){TopAppBar(title={Text("顶部的应用栏")},scrollBehavior=scrollBehavior)LazyColumn(modifier=Modifier.fillMaxSize().nestedScroll(scrollBehavior.nestedScrollConnection),contentPadding=PaddingValues(top=8.dp)){items(50){Text("列表项${it+1}",modifier=Modifier.padding(16.dp))}}}
3、其他顶部应用栏
  1. 居中对齐顶部应用栏
valscrollBehavior=TopAppBarDefaults.pinnedScrollBehavior(rememberTopAppBarState())Column(modifier=Modifier.fillMaxSize()){CenterAlignedTopAppBar(colors=topAppBarColors(containerColor=MaterialTheme.colorScheme.primaryContainer,titleContentColor=MaterialTheme.colorScheme.primary,),navigationIcon={IconButton(onClick={}){Icon(imageVector=Icons.AutoMirrored.Filled.ArrowBack,contentDescription="返回")}},actions={IconButton(onClick={}){Icon(imageVector=Icons.Filled.Menu,contentDescription="菜单")}},title={Text("顶部的应用栏")},scrollBehavior=scrollBehavior)LazyColumn(modifier=Modifier.fillMaxSize().nestedScroll(scrollBehavior.nestedScrollConnection),contentPadding=PaddingValues(top=8.dp)){items(50){Text("列表项${it+1}",modifier=Modifier.padding(16.dp))}}}
  1. 中等顶部应用栏
MediumTopAppBar(colors=topAppBarColors(containerColor=MaterialTheme.colorScheme.primaryContainer,titleContentColor=MaterialTheme.colorScheme.primary,),title={Text("顶部的应用栏")})
  1. 大顶部应用栏
LargeTopAppBar(colors=topAppBarColors(containerColor=MaterialTheme.colorScheme.primaryContainer,titleContentColor=MaterialTheme.colorScheme.primary,),title={Text("顶部的应用栏")})

二、BottomAppBar

1、基本介绍
  • BottomAppBar 用于实现底部的应用栏，它封装了底部的应用栏的常见样式和交互，例如，操作按钮、浮动操作按钮
2、演示
  1. BottomAppBar 基本使用，BottomAppBar 默认不会固定在底部
BottomAppBar(actions={IconButton(onClick={}){Icon(Icons.Filled.Check,contentDescription="Check")}IconButton(onClick={}){Icon(Icons.Filled.Edit,contentDescription="Edit",)}IconButton(onClick={}){Icon(Icons.Filled.ThumbUp,contentDescription="ThumbUp",)}IconButton(onClick={}){Icon(Icons.Filled.MailOutline,contentDescription="MailOutline",)}},floatingActionButton={FloatingActionButton(onClick={},containerColor=BottomAppBarDefaults.bottomAppBarFabColor,elevation=FloatingActionButtonDefaults.bottomAppBarFabElevation()){Icon(Icons.Filled.Add,"Add")}})
  1. BottomAppBar 固定在底部实现
ConstraintLayout(modifier=Modifier.fillMaxSize()){val(content,bottomBar)=createRefs()// 填满剩余空间LazyColumn(modifier=Modifier.constrainAs(content){top.linkTo(parent.top)start.linkTo(parent.start)end.linkTo(parent.end)bottom.linkTo(bottomBar.top)width=Dimension.fillToConstraints height=Dimension.fillToConstraints}.fillMaxWidth()){items(50){index->Text(text="Item${index+1}",modifier=Modifier.fillMaxWidth().padding(16.dp))}}BottomAppBar(modifier=Modifier.constrainAs(bottomBar){bottom.linkTo(parent.bottom)start.linkTo(parent.start)end.linkTo(parent.end)},actions={IconButton(onClick={}){Icon(Icons.Filled.Check,contentDescription="Check")}IconButton(onClick={}){Icon(Icons.Filled.Edit,contentDescription="Edit",)}IconButton(onClick={}){Icon(Icons.Filled.ThumbUp,contentDescription="ThumbUp",)}IconButton(onClick={}){Icon(Icons.Filled.MailOutline,contentDescription="MailOutline",)}},floatingActionButton={FloatingActionButton(onClick={},containerColor=BottomAppBarDefaults.bottomAppBarFabColor,elevation=FloatingActionButtonDefaults.bottomAppBarFabElevation()){Icon(Icons.Filled.Add,"Add")}})}

三、Scaffold

1、基本介绍
  • Scaffold 是 Compose 中用于构建标准化的页面结构的脚手架组件
@ComposablefunScaffold(modifier:Modifier=Modifier,topBar:@Composable()->Unit={},bottomBar:@Composable()->Unit={},snackbarHost:@Composable()->Unit={},floatingActionButton:@Composable()->Unit={},floatingActionButtonPosition:FabPosition=FabPosition.End,containerColor:Color=MaterialTheme.colorScheme.background,contentColor:Color=contentColorFor(containerColor),contentWindowInsets:WindowInsets=ScaffoldDefaults.contentWindowInsets,content:@Composable(PaddingValues)->Unit)
参数说明
modifier整体修饰符
topBar顶部栏
bottomBar底部栏
snackbarHostSnackbar 的组件
floatingActionButton浮动按钮
floatingActionButtonPosition浮动按钮位置
containerColor容器背景色
contentColor内容文字色
contentWindowInsets窗口边距
content主要内容区域
2、基本使用
varpressesbyremember{mutableIntStateOf(0)}Scaffold(topBar={TopAppBar(colors=topAppBarColors(containerColor=MaterialTheme.colorScheme.primaryContainer,titleContentColor=MaterialTheme.colorScheme.primary,),title={Text("顶部应用栏")})},bottomBar={BottomAppBar(containerColor=MaterialTheme.colorScheme.primaryContainer,contentColor=MaterialTheme.colorScheme.primary,){Text(modifier=Modifier.fillMaxWidth(),textAlign=TextAlign.Center,text="底部应用栏",)}},floatingActionButton={FloatingActionButton(onClick={presses++}){Icon(Icons.Default.Add,contentDescription="添加")}}){innerPadding->Column(modifier=Modifier.padding(innerPadding),){Text("点击了$presses次")}}
3、使用 floatingActionButtonPosition
（1）基本介绍
  • FabPosition 是用于控制 Scaffold 中 FloatingActionButton（FAB）位置的枚举类
枚举值说明
End屏幕右下角
Center屏幕底部正中央
Start屏幕左下角
EndOverlay屏幕右下角，悬浮在 BottomAppBar 上方
（2）演示
varpressesbyremember{mutableIntStateOf(0)}Scaffold(topBar={TopAppBar(colors=topAppBarColors(containerColor=MaterialTheme.colorScheme.primaryContainer,titleContentColor=MaterialTheme.colorScheme.primary,),title={Text("顶部应用栏")})},bottomBar={BottomAppBar(containerColor=MaterialTheme.colorScheme.primaryContainer,contentColor=MaterialTheme.colorScheme.primary,){Text(modifier=Modifier.fillMaxWidth(),textAlign=TextAlign.Center,text="底部应用栏",)}},floatingActionButton={FloatingActionButton(onClick={presses++}){Icon(Icons.Default.Add,contentDescription="添加")}},floatingActionButtonPosition=FabPosition.EndOverlay){innerPadding->Column(modifier=Modifier.padding(innerPadding),){Text("点击了$presses次")}}
4、关于 innerPadding
（1）基本介绍
  • innerPadding 是 Scaffold 自动计算并传递给主要内容区域的安全边距值，它确保内容不会被 Scaffold 的其他部分遮挡，例如，顶部栏、底部栏
（2）演示
  • 不使用 innerPadding，顶部内容会被顶部栏遮挡，底部内容会被底部栏遮挡
varpressesbyremember{mutableIntStateOf(0)}Scaffold(topBar={TopAppBar(colors=topAppBarColors(containerColor=MaterialTheme.colorScheme.primaryContainer,titleContentColor=MaterialTheme.colorScheme.primary,),title={Text("顶部应用栏")})},bottomBar={BottomAppBar(containerColor=MaterialTheme.colorScheme.primaryContainer,contentColor=MaterialTheme.colorScheme.primary,){Text(modifier=Modifier.fillMaxWidth(),textAlign=TextAlign.Center,text="底部应用栏",)}},floatingActionButton={FloatingActionButton(onClick={presses++}){Icon(Icons.Default.Add,contentDescription="添加")}}){innerPadding->Column(modifier=Modifier.fillMaxSize()){LazyColumn(modifier=Modifier.fillMaxSize()){items(50){Text("列表项${it+1}",modifier=Modifier.padding(16.dp))}}}}
5、使用 snackbarHost
varpressesbyremember{mutableIntStateOf(0)}valscope=rememberCoroutineScope()valsnackbarHostState=remember{SnackbarHostState()}Scaffold(topBar={TopAppBar(colors=topAppBarColors(containerColor=MaterialTheme.colorScheme.primaryContainer,titleContentColor=MaterialTheme.colorScheme.primary,),title={Text("顶部应用栏")})},bottomBar={BottomAppBar(containerColor=MaterialTheme.colorScheme.primaryContainer,contentColor=MaterialTheme.colorScheme.primary,){Text(modifier=Modifier.fillMaxWidth(),textAlign=TextAlign.Center,text="底部应用栏",)}},snackbarHost={SnackbarHost(hostState=snackbarHostState)},floatingActionButton={FloatingActionButton(onClick={scope.launch{presses++valresult=snackbarHostState.showSnackbar(message="点击了$presses次",actionLabel="撤销",duration=SnackbarDuration.Short)if(result==SnackbarResult.ActionPerformed){presses--}}}){Icon(Icons.Default.Add,contentDescription="添加")}}){innerPadding->Column(modifier=Modifier.padding(innerPadding),){Text("点击了$presses次")}}
版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/6/10 12:55:03

GNSS-SDR软件定义导航接收机：5分钟快速部署指南 [特殊字符]

GNSS-SDR软件定义导航接收机：5分钟快速部署指南 🚀 【免费下载链接】gnss-sdr GNSS-SDR, an open-source software-defined GNSS receiver 项目地址: https://gitcode.com/gh_mirrors/gn/gnss-sdr GNSS-SDR是一个功能强大的开源软件定义全球导航卫…

作者头像 李华
网站建设 2026/6/10 14:54:11

群晖NAS完美解锁Intel 2.5G网卡驱动：3步实现高速网络升级

群晖NAS完美解锁Intel 2.5G网卡驱动：3步实现高速网络升级 【免费下载链接】synology-igc Intel I225/I226 igc driver for Synology Kernel 4.4.180 项目地址: https://gitcode.com/gh_mirrors/sy/synology-igc 还在为群晖NAS无法识别Intel I225/I226 2.5G网…

作者头像 李华
网站建设 2026/6/9 18:33:37

mac-precision-touchpad：Windows苹果触控板终极解决方案完整指南

mac-precision-touchpad：Windows苹果触控板终极解决方案完整指南 【免费下载链接】mac-precision-touchpad Windows Precision Touchpad Driver Implementation for Apple MacBook / Magic Trackpad 项目地址: https://gitcode.com/gh_mirrors/ma/mac-precision-t…

作者头像 李华