原生移动开发 / 系统课时
文本、按钮、图片与图标
文本、按钮、图片与图标
这一节用 Text、Button、Image 和 Icon 组成一个可交互的 Compose 页面。你会看到四类组件如何分工,并通过一次按钮点击验证状态变化和界面重组。
学习目标
- 使用
Text、Button、Image、Icon构建基础界面 - 理解
Image与Icon在语义和资源使用上的区别 - 用 Compose 状态驱动按钮交互并验证界面更新
组合四类基础组件
Text 显示文字,Button 提供点击入口,Image 适合展示照片、插画或较大的图形资源,Icon 则更适合表达操作或状态。Compose 不要求一个组件对应一个 XML 控件,界面通常是在 Column、Row 等布局中直接组合。
下面示例可以放进一个启用了 Jetpack Compose 的 Android 应用。图片使用 Android 系统自带 drawable,避免额外准备资源;按钮点击后会更新计数,触发相关 Composable 重新组合。
package com.example.basicwidgets
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.Image
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.res.painterResource
import androidx.compose.ui.unit.dp
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
BasicWidgetsScreen()
}
}
}
}
@Composable
fun BasicWidgetsScreen() {
var likes by remember { mutableIntStateOf(0) }
Column(
modifier = Modifier
.fillMaxSize()
.padding(24.dp),
verticalArrangement = Arrangement.spacedBy(16.dp),
horizontalAlignment = Alignment.CenterHorizontally
) {
Text(
text = "Compose 基础组件",
style = MaterialTheme.typography.headlineSmall
)
Image(
painter = painterResource(android.R.drawable.ic_menu_gallery),
contentDescription = "示例图片"
)
Button(onClick = { likes++ }) {
Row(
horizontalArrangement = Arrangement.spacedBy(8.dp),
verticalAlignment = Alignment.CenterVertically
) {
Icon(
painter = painterResource(android.R.drawable.btn_star_big_on),
contentDescription = null
)
Text("点赞 $likes")
}
}
}
}预期结果:应用启动后显示标题、一个示例图片和带星形图标的按钮。每点击一次按钮,按钮文字中的数字加一,例如从“点赞 0”变为“点赞 1”。
区分 Image 与 Icon
Image 的重点是“展示内容”,通常需要 painter,可以来自 drawable、位图或其他图像加载方案。只要图片传达了用户需要理解的信息,就应该提供有意义的 contentDescription;纯装饰图片可以设为 null。
Icon 的重点是“表达动作或状态”。它常和按钮、顶部栏、列表项一起使用,并会继承适合当前组件的颜色。示例中的图标位于按钮内部,而按钮本身已经通过文字“点赞”说明用途,因此图标的 contentDescription 设为 null,避免读屏重复播报同一含义。
用状态驱动交互
按钮点击不是直接“修改 Text 控件”,而是修改 likes 状态。mutableIntStateOf 保存整数状态,remember 让它在当前组合存续期间被保留;状态变化后,Compose 会重新执行读取该状态的界面代码,并用新值更新按钮文字。
这四个组件已经能覆盖很多基础页面:先用布局组织结构,再让数据通过参数进入 Text、Image 和 Icon,最后把用户操作放到 Button 的 onClick 中。保持“状态变化驱动界面变化”,比手动寻找并修改某个控件更符合 Compose 的工作方式。