在Android的XML资源文件中，layer-list常用于定义多个图层叠加的drawable资源，每个图层通过item标签配置，item的right属性可以直接控制当前图层距离整个drawable区域右边的距离，实现图层的偏移定位效果。
layer-list基础结构说明
layer-list是Android中drawable资源的一种类型，允许将多个drawable按顺序叠加展示，后定义的item会覆盖在先定义的item上方。每个item支持的定位属性包括left、top、right、bottom，分别对应图层距离整个drawable区域左、上、右、下的距离。
基础的layer-list结构如下：
<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
<!-- 第一个图层，作为底层 -->
<item
android:drawable="@drawable/ic_base"
android:left="0dp"
android:top="0dp"
android:right="0dp"
android:bottom="0dp"/>
<!-- 第二个图层，叠加在底层上方 -->
<item
android:drawable="@drawable/ic_overlay"
android:left="10dp"
android:top="10dp"
android:right="10dp"
android:bottom="10dp"/>
</layer-list>
right属性的作用逻辑
item的right属性表示当前图层的右边缘距离整个layer-list可绘制区域右边缘的距离，单位支持dp、px等常用尺寸单位。当设置right为正值时，图层会向左偏移，距离右边产生对应的间距；如果设置right为负值，图层的右边缘会超出layer-list的右边界。
需要注意，right属性的生效前提是图层本身有可绘制的drawable内容，且layer-list的容器本身有明确的尺寸范围，比如在View的background中使用时，View的宽高会决定layer-list的绘制区域大小。
具体使用示例
假设我们需要实现一个带右边距的叠加图标效果，底层是蓝色圆形，上层是白色图标，且白色图标距离整个drawable右边有20dp的距离，对应的XML代码如下：
<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
<!-- 底层蓝色圆形 -->
<item>
<shape android:shape="oval">
<solid android:color="#FF4081"/>
<size android:width="60dp" android:height="60dp"/>
</shape>
</item>
<!-- 上层白色图标，设置right距离右边20dp -->
<item
android:right="20dp"
android:drawable="@drawable/ic_arrow_right"
android:gravity="center"/>
</layer-list>
上述代码中，上层图标的right设置为20dp，意味着图标的右边缘会距离整个layer-list区域的右边缘20dp，视觉上图标会整体向左偏移20dp，形成右边留白的效果。
多属性配合调整位置
right属性通常和left、top、bottom属性配合使用，实现更精准的图层定位。比如需要让图层同时距离左边10dp、右边20dp，就可以同时设置left和right属性：
<item
android:left="10dp"
android:right="20dp"
android:drawable="@drawable/ic_content"/>
这种情况下，图层的宽度会被自动拉伸，左右分别留出10dp和20dp的间距，适合需要固定左右边距的图层场景。
常见问题说明
- 如果设置right后没有效果，首先检查layer-list所在的View是否有明确的宽高，wrap_content模式下可能无法体现边距效果。
- right属性是距离右边的距离，不是图层自身的右边距，不要和View的margin属性混淆。
- 当item中同时设置了<bitmap>标签和right属性时，right属性依然生效，会控制bitmap的偏移位置。
注意：layer-list的item属性中，right、left、top、bottom的优先级高于drawable内部的gravity属性，当同时设置时，距离属性会优先生效。
Androidlayer-listitem_rightXML布局图层间距修改时间：2026-07-17 10:24:25