API 默认值

Material、Compose 界面和 Foundation API 默认实现并提供许多无障碍功能实践。它们包含遵循其特定角色和功能的内置语义。这意味着，只需很少或无需额外工作，即可获得大部分无障碍支持。

为相应用途使用适当的 API 意味着，组件通常会附带预定义的无障碍功能行为，涵盖标准使用情形。不过，请务必仔细检查这些默认设置是否符合您的无障碍需求。如果不是，Compose 提供了多种方法来满足更具体的要求。

了解 Compose API 中的默认无障碍语义和模式有助于您在开发时考虑到无障碍性。它还有助于您在更多自定义组件中支持无障碍功能。

最小触摸目标尺寸

屏幕上可供用户点击、触摸或可与用户互动的任何元素都必须足够大，让用户能够进行可靠的互动。调整这些元素的尺寸时，请确保将最小尺寸设置为 48dp，以正确遵循 Material Design 无障碍指南。

Checkbox、RadioButton、Switch、Slider 和 Surface 等 Material 组件在内部设置此最小尺寸，但仅在相应组件可接收用户操作时设置。例如，当 Checkbox 的 onCheckedChange 参数设为非 null 值时，复选框会添加内边距以让宽度和高度至少为 48 dp。

@Composable
private fun CheckableCheckbox() {
    Checkbox(checked = true, onCheckedChange = {})
}

一个具有默认内边距且宽度和高度均为 48 dp 的复选框。
图 1. 具有默认边衬区的复选框。

当 onCheckedChange 参数设为 null 时，将不会添加内边距，因为用户无法直接与该组件互动。