NiceImageView 使用教程

项目介绍

NiceImageView 是一个高度定制化的 Android 图像视图组件，扩展自 AppCompatImageView，支持显示为圆形或设置圆角，并能设置边框、内层边框、圆角半径、遮罩颜色等属性。通过在 XML 布局文件中使用 NiceImageView，可以方便地调整图片视图的各种视觉效果。

项目快速启动

添加依赖

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

dependencies {
    implementation 'com.github.Othershe:NiceImageView:1.0.0'
}

在布局文件中使用

在 XML 布局文件中添加 NiceImageView：

<com.othershe.nicedImageView.NiceImageView
    android:layout_width="100dp"
    android:layout_height="100dp"
    app:isCircle="true"
    app:borderWidth="2dp"
    app:borderColor="#FF0000"
    app:innerBorderWidth="1dp"
    app:innerBorderColor="#00FF00"
    app:cornerRadius="10dp"
    app:maskColor="#80000000"
    android:src="@drawable/your_image" />

在代码中使用

在 Java 或 Kotlin 代码中使用 NiceImageView：

NiceImageView niceImageView = findViewById(R.id.niceImageView);
niceImageView.setImageResource(R.drawable.your_image);
niceImageView.setIsCircle(true);
niceImageView.setBorderWidth(2);
niceImageView.setBorderColor(Color.RED);
niceImageView.setInnerBorderWidth(1);
niceImageView.setInnerBorderColor(Color.GREEN);
niceImageView.setCornerRadius(10);
niceImageView.setMaskColor(0x80000000);

应用案例和最佳实践

圆形头像显示

在社交应用中，用户头像通常需要显示为圆形。使用 NiceImageView 可以轻松实现：

<com.othershe.nicedImageView.NiceImageView
    android:layout_width="100dp"
    android:layout_height="100dp"
    app:isCircle="true"
    android:src="@drawable/user_avatar" />

带边框的圆角图片

在电商应用中，商品图片可能需要带边框的圆角效果：

<com.othershe.nicedImageView.NiceImageView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:borderWidth="2dp"
    app:borderColor="#FF0000"
    app:cornerRadius="10dp"
    android:src="@drawable/product_image" />

典型生态项目

NiceImageView 可以与其他图片加载库（如 Glide 或 Picasso）结合使用，以实现更高效的图片加载和显示效果。以下是一个使用 Glide 加载图片的示例：

Glide.with(this)
    .load("https://example.com/image.jpg")
    .into(niceImageView);

通过结合 NiceImageView 和 Glide，可以实现高效的图片加载和美观的视觉效果，提升用户体验。