如何在 Android 中实现 Shapeable ImageView？

在 Android 中，我们经常使用 ImageView 来显示图片，但是默认的 ImageView 是一个矩形的形状。如果我们想要显示圆形、椭圆形或其他自定义形状的图片，可以使用 Shapeable ImageView。Shapeable ImageView 是 AndroidX 的一个库，提供了方便的方法来设置 ImageView 的形状。

使用 Shapeable ImageView

首先，在项目的 build.gradle 文件中添加以下依赖：

implementation 'com.google.android.material:material:1.5.0'

然后，在布局文件中使用 ShapeableImageView 替换普通的 ImageView：

<com.google.android.material.imageview.ShapeableImageView
    android:id="@+id/image_view"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/my_image"
    app:shapeAppearance="@style/ShapeAppearance.MyShape"
    app:strokeColor="#FF0000"
    app:strokeWidth="2dp" />

注意，通过 app:shapeAppearance 属性可以指定 ImageView 的形状。你可以使用预定义的形状如 @style/ShapeAppearance.Material，或者自定义的形状样式。

在代码中，我们可以通过以下方式来为 ShapeableImageView 设置形状：

ShapeableImageView imageView = findViewById(R.id.image_view);
ShapeAppearanceModel shapeAppearanceModel = imageView.getShapeAppearanceModel()
    .toBuilder()
    .setAllCornerSizes(ShapeAppearanceModel.PILLOW)
    .build();
imageView.setShapeAppearanceModel(shapeAppearanceModel);

上述代码中，使用 getShapeAppearanceModel() 获取原始的 ShapeAppearanceModel，然后使用 toBuilder() 创建一个新的构造器，通过设置 setAllCornerSizes() 方法来将所有的角设置为圆角。最后，通过 setShapeAppearanceModel() 将新的 ShapeAppearanceModel 应用到 ImageView 上。

我们还可以为 ShapeableImageView 添加边框，通过 app:strokeColor 和 app:strokeWidth 属性来指定边框的颜色和宽度。

自定义形状

除了使用预定义的形状样式，我们还可以创建自定义的形状样式来适应不同的需求。通过 ShapeAppearanceModel 的 setAllCornerSizes() 方法可以设置所有的角为同样的大小，也可以使用 setTopLeftCornerSize()、setTopRightCornerSize()、setBottomRightCornerSize() 和 setBottomLeftCornerSize() 方法来分别设置每个角的大小。

另外，ShapeAppearanceModel 还提供了其他一些方法来设置形状，比如 setCornerSize() 可以设置所有角的大小为同一个数值，setCornerSizePx() 可以以像素为单位设置角的大小。

通过组合这些方法，我们可以创建出各种形状和角的组合来满足不同的设计需求。

总结

ShapeableImageView 是一个方便实用的库，可以帮助我们在 Android 中实现各种形状的 ImageView。通过简单的配置，我们可以将普通的 ImageView 转换成圆形、椭圆形或自定义形状的图片展示控件。在实际项目中使用 ShapeableImageView 可以提升用户界面的美观性和交互性。

如果你想更深入了解 ShapeableImageView 的相关用法和属性，可以查阅官方文档：ShapeableImageView - Material Components for Android。