Android如何用drawable level-list XML实现电量或信号图标随状态变化？

在Android开发中，使用drawable下的level-list资源可以非常方便地根据一个整型level值，切换显示不同的图片图层。这种方式特别适合电量百分比图标、WiFi信号格、蓝牙连接状态等需要随数值或状态动态变化的场景。它把复杂的判断逻辑从Java或Kotlin代码转移到了XML资源中，既清晰又易于维护。

一、level-list的基本原理

level-list是Android Drawable资源的一种，定义在res/drawable目录下的XML文件中，根标签为<level-list>。在它内部可以放置多个<item>，每个item通过android:minLevel和android:maxLevel指定一个闭区间的level范围，并通过android:drawable指向具体的图片资源或另一个drawable。

当我们将该level-list设置为某个View（如ImageView）的src，或者设置为背景时，调用View的setImageLevel(int)（ImageView）或Drawable的setLevel(int)方法，系统会从上到下遍历item，找到第一个minLevel到maxLevel包含当前level值的item并展示其drawable。如果没有匹配项，则什么都不显示。需要注意的是，level的取值范围是0到10000，默认level为0。

1.1 minLevel与maxLevel的匹配规则

每个item的区间应当是明确且不重叠的，虽然Android允许重叠，但系统只会采用最先匹配的那一个。例如minLevel=0、maxLevel=20代表level在0到20（含）时命中此item。如果设置了多个item且区间有交叉，前面定义的优先级更高，这常常是导致图标显示不符合预期的原因。

另外，若某个item未指定minLevel，则默认为0；未指定maxLevel则默认为10000。开发中建议显式写出两个属性，避免因为默认值造成隐蔽bug。当level超过所有item的上限，界面上会留空，因此通常需要一个兜底的最大区间item。

二、电量图标变化的完整实现

假设我们有五张电量图：电量0、25%、50%、75%、100%，分别命名为ic_battery_0.png、ic_battery_25.png等。我们希望根据电量百分比自动切换图标，而不在代码里写一堆if-else。

首先在res/drawable中新建battery_level.xml，内容如下。这里将0-20映射为0格，21-40为25格，以此类推，最后96-100为满电。这样外部只需传入真实百分比数值即可。

<?xml version="1.0" encoding="utf-8"?>
<level-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:minLevel="0" android:maxLevel="20" android:drawable="@drawable/ic_battery_0" />
    <item android:minLevel="21" android:maxLevel="40" android:drawable="@drawable/ic_battery_25" />
    <item android:minLevel="41" android:maxLevel="60" android:drawable="@drawable/ic_battery_50" />
    <item android:minLevel="61" android:maxLevel="95" android:drawable="@drawable/ic_battery_75" />
    <item android:minLevel="96" android:maxLevel="100" android:drawable="@drawable/ic_battery_100" />
</level-list>

2.1 在布局与代码中引用

在布局文件里，将ImageView的src设为上述drawable。注意必须使用src而非background，因为setImageLevel只作用于ImageView的drawable；若用背景，则需要拿到background drawable再调用setLevel。

<ImageView
    android:id="@+id/batteryImg"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/battery_level" />

在Activity或Fragment中，根据电量变化更新level。下面以Kotlin为例，将百分比直接作为level传入，因为我们的区间就是按百分比设计的：

fun updateBattery(percent: Int) {
    val level = percent.coerceIn(0, 100)
    binding.batteryImg.setImageLevel(level)
}

2.2 使用背景drawable的写法

如果图标是作为View背景使用的，例如一个TextView前面带信号格背景，则可以这样更新：

val drawable = textView.background
if (drawable is LevelListDrawable) {
    drawable.level = signalStrength
}

这种方式同样适用，但要注意背景drawable可能不是LevelListDrawable类型，需要做类型判断。对于单纯图标展示，推荐用ImageView的src方案，语义更明确。

三、信号图标的多状态处理

信号格通常不止电量那种线性比例，还可能包含“无信号”“弱”“中”“强”“极强”等状态。我们也可以用level-list表达，只是level值由信号算法给出。例如WiFi有0到4级，我们在代码中将0级映射为level 0，4级映射为level 4，XML中每个item区间宽度为1。

<?xml version="1.0" encoding="utf-8"?>
<level-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:minLevel="0" android:maxLevel="0" android:drawable="@drawable/ic_wifi_0" />
    <item android:minLevel="1" android:maxLevel="1" android:drawable="@drawable/ic_wifi_1" />
    <item android:minLevel="2" android:maxLevel="2" android:drawable="@drawable/ic_wifi_2" />
    <item android:minLevel="3" android:maxLevel="3" android:drawable="@drawable/ic_wifi_3" />
    <item android:minLevel="4" android:maxLevel="4" android:drawable="@drawable/ic_wifi_4" />
</level-list>

代码侧调用setImageLevel(wifiLevel)即可。该方案的优点是：设计师新增一个信号状态，只需加一张图和一行item；产品调整阈值，只需改XML区间，无需发版改动逻辑代码。

相比用ViewFlipper或动态setImageResource，level-list减少了对象创建和视图切换开销，也避免了因状态判断遗漏而出现空白图标的问题。在列表项大量使用信号图标时，这种资源级方案能轻微提升滚动流畅度。

四、常见误区与排查

不少开发者遇到过设置了level但图标不变的情况。第一类原因是把level-list放在了background，却调用了setImageLevel，此时ImageView的src是空，当然没反应。第二类原因是item区间未覆盖传入的level，例如只写到maxLevel=90，却传了100，导致无匹配。第三类原因是图片资源本身尺寸或透明度问题，被误认为没切换。

排查时，可以先打印当前level值，再检查XML里是否有对应闭区间；如果用background，断点看Drawable是否是LevelListDrawable实例。此外，level-list里面的drawable也可以是selector或shape，实现更丰富的组合状态，但嵌套过深会影响可读性，建议适度使用。

4.1 与selector的配合

有时我们希望同一个电量下，按下状态有不同颜色。可以把item的drawable指向一个selector XML，而selector里再区分state_pressed。这样level-list负责“数值到图集”的映射，selector负责“交互状态到样式”的映射，职责分离清晰。

<item android:minLevel="0" android:maxLevel="20" android:drawable="@drawable/battery_0_selector" />

不过要注意，这种多层drawable会增加资源解析时间，在低端机上首次加载可能稍有延迟。如果产品没有按压反馈需求，直接引用png即可，保持简单可靠。

五、总结建议

利用level-list实现电量或信号图标变化，是一种低代码、高可维护的Android资源方案。它适合一切“一个整数值对应一组静态图”的场景，能显著简化UI状态同步逻辑。实际项目中，建议将level含义、区间划分写在XML注释或文档中，方便后续接手者理解。

当状态极其复杂、需要动画过渡或矢量动态绘制时，level-list可能不够用，此时应考虑自定义Drawable或Jetpack Compose的State驱动绘制。但在传统View体系下，面对常规信号和电量指示，level-list依旧是首选的轻量做法。

Androidlevel-listdrawable修改时间：2026-08-02 00:48:39