Android通過layer-list設置默認加載錯誤圖片的實現(xiàn)方案

更新時間：2025年04月27日 08:46:32 作者：_小馬快跑_

在需求開發(fā)中,經(jīng)常會遇到需要展示圖片列表的情況,然而,由于網(wǎng)絡問題、圖片鏈接失效等原因,某些圖片可能無法正常加載,為了優(yōu)化用戶體驗,通常會為加載失敗的圖片提供一個默認的占位圖,所以本文給大家介紹了Android通過layer-list設置默認加載錯誤圖片的實現(xiàn)方案

背景

在需求開發(fā)中，經(jīng)常會遇到需要展示圖片列表的情況。然而，由于網(wǎng)絡問題、圖片鏈接失效等原因，某些圖片可能無法正常加載。為了優(yōu)化用戶體驗，通常會為加載失敗的圖片提供一個默認的占位圖。

在常規(guī)的實現(xiàn)方式中，可能會直接使用一張默認圖片來作為占位圖（如果是個單色圖，可以直接用一個drawable文件）。然而，如果圖片列表里每個Item寬高比都是變化的時候，默認圖片會因為寬高比不同而導致變形，雖然可以通過 ImageView 的 scaleType 設置 CENTER_CROP 以適應不同的圖片比例不變形，但如果默認圖片本身包含一個居中的小圖標，在不同的寬高比下，小圖標的顯示效果可能會變形或錯位。

問題分析

假設我們的默認錯誤圖片是如下所示的樣式（背景色 + 一個居中的錯誤圖標）：

如果我們將其合成一張完整的 PNG 圖片并使用 CENTER_CROP 適配不同的 ImageView 尺寸，可能會遇到兩個問題： 1. 小圖標會跟隨圖片裁剪，可能會放大、變形，導致顯示不一致。 2. 不同比例的 ImageView 會截取不同區(qū)域，導致小圖標的位置和大小不可控。

為了解決這個問題，可以換一種思路，利用 layer-list 來動態(tài)組合背景和圖標，從而確保小圖標始終保持固定大小和居中位置。

解決方案：使用 layer-list

在 drawable 資源中，layer-list 允許我們疊加多個圖層，可以將背景和圖標分開定義，保證不同尺寸的 ImageView 顯示時，背景始終鋪滿，而小圖標始終居中，且不會因裁剪而變形。其中小圖片的資源如下：

創(chuàng)建 layer-list 資源文件

在 res/drawable/ 目錄下創(chuàng)建 drawable_default_error.xml：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 背景矩形 -->
    <item>
        <shape android:shape="rectangle">
            <solid android:color="@color/gray_normal" /> <!-- 設置背景顏色 -->
        </shape>
    </item>

    <!-- 居中的錯誤圖標 -->
    <item
        android:width="60dp"
        android:height="60dp"
        android:gravity="center">
        <bitmap
            android:gravity="center"
            android:src="@drawable/chat_ask_message_error" />
    </item>
</layer-list>

代碼中使用 layer-list

在使用 Glide 或其他圖片加載框架時，我們可以直接將 drawable_default_error.xml 作為 placeholder 和 error 資源：

Glide.with(activity)
    .load(url)
    .placeholder(R.drawable.drawable_default_error) // 加載中顯示的占位圖
    .error(R.drawable.drawable_default_error) // 加載失敗時顯示的默認圖
    .into(imageView)