辅助功能与全屏到边缘用户界面
支持 TalkBack、大字体和内边距。
辅助功能与全屏到边缘用户界面 是 CoddyKit 上的免费 Jetpack Compose Academy 课时。 这是第 1 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Jetpack Compose Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Jetpack Compose Academy 课程共包含 4 节课。
发布前完善应用
优秀的应用属于每个人。发布前,请确保它支持屏幕阅读器、大字体和现代的全屏布局,让所有人都能使用。
TalkBack 需要什么
Android 提供了名为 TalkBack 的屏幕阅读器。它会朗读界面,因此每个有意义的元素都必须带有清晰的标签供它读出。
为图标设置 contentDescription
图标和图片不显示文本,因此 TalkBack 会读取它们的 contentDescription。请为每个图标提供简短而有意义的短语,说明它的用途。
Icon(
Icons.Default.Share,
contentDescription = "Share post"
)对阅读器隐藏装饰元素
纯装饰图片被朗读出来只会增加干扰。请将 contentDescription 设置为 null,让 TalkBack 跳过它们,专注于重要内容。
Image(
painter = bg,
contentDescription = null
)适应更大的字体
用户可以放大系统文本。请使用 sp 而不是固定的 dp 设置文本大小,这样标签会随无障碍设置放大,而不会被裁剪。
Text("Welcome", fontSize = 16.sp)触摸目标应保持易于点击
按钮太小会难以点击。请将触摸目标设置为至少 48dp,让每个控件都便于手指和辅助开关操作。
Modifier.size(48.dp)实现全面屏
现代应用会绘制到状态栏和导航栏后方。请在 Activity 中调用 enableEdgeToEdge,让内容填满整个屏幕。
enableEdgeToEdge()
setContent { App() }避免内容隐藏在系统栏后
启用全面屏后,内容可能会延伸到系统栏下方。WindowInsets 会准确告诉您这些系统栏占用了多少空间,以便您在周围添加内边距。
快速检查
您添加了一个分享图标按钮。什么可以让 TalkBack 读出它的用途?
轻松应用内边距
最简单的解决方案是使用 safeDrawing 内边距修饰符。它会让内容避开挖孔区域和系统栏,无需手动计算。
Modifier.windowInsetsPadding(
WindowInsets.safeDrawing
)尽早测试无障碍功能
请在设备上开启 TalkBack 和无障碍扫描器。它们可以在审核人员或用户发现问题之前,找出缺失的标签和对比度过低的问题。
将相关内容分组
零散的标签听起来令人疲惫。请在语义设置中使用 mergeDescendants,让卡片作为一个整体被读出,为 TalkBack 用户带来更流畅的体验。
Modifier.semantics(
mergeDescendants = true
) {}回顾:无障碍与沉浸式体验
您为图标添加了标签,使用 sp 缩放文本,将目标保持在 48dp,并通过内边距实现了全面屏。现在,您的应用欢迎每一位用户。
用 AI 导师学习 Kotlin — 免费
在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。
- 课程
- 30
- 课程
- 120
常见问题解答
「辅助功能与全屏到边缘用户界面」课时是免费的吗?
是的 — 「辅助功能与全屏到边缘用户界面」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Jetpack Compose Academy 课程的其余内容,请升级到 CoddyKit PRO。 Jetpack Compose Academy 课程共包含 4 节课。
「辅助功能与全屏到边缘用户界面」这节课中我会学到什么?
支持 TalkBack、大字体和内边距。 你通过在浏览器中直接运行的动手代码来练习 Jetpack Compose Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Jetpack Compose Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Jetpack Compose Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 1 节课,共 4 节。
「辅助功能与全屏到边缘用户界面」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Jetpack Compose Academy 课中编写并运行代码吗?
能。每节 Jetpack Compose Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 辅助功能与全屏到边缘用户界面
- 实现快速启动的基线配置文件
- 已签名的发布应用包
- 面向 Compose Multiplatform 的架构