Material 图标

The Icon 可组合函数是在屏幕上绘制遵循 Material Design 指南 的单色图标的便捷方法。若要使用 Icon,请包含 Compose Material 库(或 Compose Material 3 库)。

例如,如果您有一个想要使用 Material 默认值加载的矢量可绘制对象,您可以按如下方式使用 Icon 可组合函数

Icon(
    painter = painterResource(R.drawable.baseline_directions_bus_24),
    contentDescription = stringResource(id = R.string.bus_content_description)
)

默认情况下,Icon 可组合函数使用 LocalContentColor.current 着色,大小为 24.dp。它还公开了 tint 颜色参数(它利用了与 图像着色 部分中描述的相同的着色机制)。Icon 可组合函数旨在用于小型图标元素。对于更多自定义选项,您应该使用 Image 可组合函数。

Material Icon 库 还包含一组预定义的 Icons,这些图标可以在 Compose 中使用,无需手动导入 SVG。若要绘制 购物车图标 的圆角版本

Icon(
    Icons.Rounded.ShoppingCart,
    contentDescription = stringResource(id = R.string.shopping_cart_content_desc)
)

Shopping cart vector with Icon
图 1:使用 Icon 的购物车矢量图

值得注意的是,不需要使用 Icon 在屏幕上渲染 VectorDrawable,在后台,Icon 使用 Modifier.paint(painterResource(R.drawable.ic_bus_stop)) 在屏幕上绘制 Icon。有关所有可用图标的更多信息,请查看 Icons 文档