【Android开发】Drawable标签总结大全

前言

我们在drawable目录下可以创建很多自定义的资源，其中用的最多的应该就是selector和shape。目前在Android中有21种drawable标签，了解和利用这些标签对我们的开发有很大的帮助。这个文章我们对这21种标签做一个介绍，让大家有一个印象。

本文中有些资料取自网上，当时记录在笔记中，但是由于时间久远，忘记出处了。

Android5.0前标签

shape

这个大家非常熟悉，简单列举一下属性和子标签，至于子标签的属性和具体使用就不细说了，网上有的是

属性

• android:dither 是否启动图片抖动

• android:shape 形状。分别为矩形、线、椭圆、环。默认为矩形rectangle

当为line时，一定要有stroke，实线虚线都可以，但是只能是横线，并且局中，主要用于分割线

• android:tint 给shape着色

• android:tintMode 着色类型（蒙版类型）

• android:visible

//下面这五个属性是shape为ring，即圆环是才使用的

• android:innerRadius

• android:innerRadiusRatio

• android:thickness

• android:thicknessRatio

• android:useLevel

子标签

• solid填充颜色

• corners圆角

• stroke描边

• padding边距

• size长宽

• gradient渐变

selector

选择器，也很常用，设置不同状态下不同的drawable。

属性

• android:dither 是否启动图片抖动

• android:visible

• android:enterFadeDuration 状态改变时，新状态展示时的淡入时间，以毫秒为单位

• android:exitFadeDuration 状态改变时，旧状态消失时的淡出时间，以毫秒为单位

• android:autoMirrored 设置图片是否需要镜像反转，当布局方向是RTL，即从右到左布局时才有用，API Level 19(Android 4.4)才添加的属性

在某些语言下如阿拉伯语习惯是从右到左，在manifest的application中需要设置android:supportsRtl，另外在组件中还有两个相关属性android:layoutDirection和android:textDirection

• android:variablePadding (基本不用)选择true时，drawable的内边距会根据状态的变化而变化，设置为true时，你必须为不同的状态配置layout，但是通常不建议这么做。选择false时，内边距保持一致，所有状态中最大的内边距。

• android:constantSize 当选择器各个状态的图片大小不一时，设置为 true表示以最大的图片的尺寸显示，设置为false以默认的图片的尺寸显示

子标签

• item 该标签下可以定义drawable类型的子标签

rotate

可以对资源进行旋转

属性

• android:drawable 指定drawable资源，如果不设置该属性，也可以定义drawable类型的子标签

• android:fromDegrees 起始的角度度数

• android:toDegrees 结束的角度度数，正数表示顺时针，负数表示逆时针

• android:pivotX 旋转中心的X坐标，浮点数或是百分比。浮点数表示相对于drawable的左边缘距离单位为px，如5; 百分比表示相对于drawable的左边缘距离按百分比计算，如5%; 另一种百分比表示相对于父容器的左边缘，如5%p; 一般设置为50%表示在drawable中心

• android:pivotY 旋转中心的Y坐标

• android:visible 设置初始的可见性状态，默认为false

子标签

当不设定android:drawable时，可以添加任意drawable的子标签，比如shape（其实也可以将shape单独放一个xml文件中，然后用android:drawable设定，其实是一样的，只不过直接通过shape标签可以减少一个文件），这样在通过旋转可以实现某些图形，如三角形。但是比较麻烦，也不常用，这里就不细说了。

bitmap

属性

• android:src 必填项，指定图片资源，只能是图片，不能是xml定义的drawable资源（所以svg不行）

• android:gravity 设置图片的对齐方式，比如在layer-list中，默认是填满整个视图则会拉伸，用这个值。多个取值可以用 | 分隔：

• android:antialias 设置是否开启抗锯齿

• android:dither 设置是否抖动，图片与屏幕的像素配置不同时会用到，比如图片是ARGB 8888的，而屏幕是RGB565

• android:filter 设置是否允许对图片进行滤波，对图片进行收缩或者延展使用滤波可以获得平滑的外观效果

• android:tint 着色

• android:tileMode 设置图片平铺的方式，其中clamp复制图片边缘的颜色来填充容器剩下的空白部分

• android:alpha 透明度

• android:mipMap 设置是否可以使用mipmap，但API Level最低要求是17，即Android 4.2

• android:autoMirrored 设置图片是否需要镜像反转，上面提到了

• android:tileModeX 设置水平方向的平铺方式，这是API Level 21(Android 5.0)才添加的属性

• android:tileModeY 设置垂直方向的平铺方式，这是API Level 21(Android 5.0)才添加的属性

• android:tintMode 着色模式，也是API Level 21(Android 5.0)才添加的属性

nine-patch

属性

• android:src 必填项，必须指定点九类型的图片 xxx.9.png

其他属性与bitmap完全一样，不复述了。

color

属性

只有一个android:color属性，因为可以直接在color.xml设置颜色，所以这个用处不多。

inset

设置边距，注意这个边距不是指内容与view边界的padding（如shape中的padding），而是drawable与view边界的距离

比如做背景时，无论怎么设置view的padding，图案都是完整填充view的，设置了这个之后就可以让图案四周留出空白。

属性

• android:drawable 指定drawable资源，如果不设置该属性，也可以定义drawable类型的子标签

• android:visible 设置初始的可见性状态，默认为false

• android:insetLeft 左边距

• android:insetRight 右边距

• android:insetTop 顶部边距

• android:insetBottom 底部边距

• android:inset 设置统一边距，会覆盖上面四个属性，但API Level要求为21，即Android 5.0

子标签

如果不设置drawable属性，也可以定义drawable类型的子标签，如shape等

clip

使用clip标签可以对drawable进行裁剪，在做进度条时很有用。通过设置level值控制裁剪多少，level取值范围为0~10000，默认为0，表示完全裁剪，图片将不可见；10000则完全不裁剪，可见完整图片。

属性

• android:drawable 指定drawable资源，如果不设置该属性，也可以定义drawable类型的子标签

• android:clipOrientation 设置裁剪的方向

• android:gravity 设置裁剪的位置，可取值如下，多个取值用 | 分隔：

  1. top： 图片放于容器顶部，不改变图片大小。当裁剪方向为vertical时，会裁掉图片底部

  2. bottom： 图片放于容器底部，不改变图片大小。当裁剪方向为vertical时，会裁掉图片顶部

  3. left： 图片放于容器左边，不改变图片大小，默认值。当裁剪方向为horizontal，会裁掉图片右边部分

  4. right： 图片放于容器右边，不改变图片大小。当裁剪方向为horizontal，会裁掉图片左边部分

  5. center： 图片放于容器中心位置，包括水平和垂直方向，不改变图片大小。当裁剪方向为horizontal时，会裁掉图片左右部分；当裁剪方向为vertical时，会裁掉图片上下部分

  6. fill： 拉伸整张图片以填满容器的整个高度和宽度。这时候图片不会被裁剪，除非level设为了0，此时图片不可见

  7. center_vertical： 图片放于容器垂直方向的中心位置，不改变图片大小。裁剪和center时一样

  8. center_horizontal： 图片放于容器水平方向的中心位置，不改变图片大小。裁剪和center时一样

  9. fill_vertical： 在垂直方向上拉伸图片以填满容器的整个高度。当裁剪方向为vertical时，图片不会被裁剪，除非level设为了0，此时图片不可见

  10. fill_horizontal： 在水平方向上拉伸图片以填满容器的整个宽度。当裁剪方向为horizontal时，图片不会被裁剪，除非level设为了0，此时图片不可见

  11. clip_vertical： 附加选项，裁剪基于垂直方向的gravity设置，设置top时会裁剪底部，设置bottom时会裁剪顶部，其他情况会同时裁剪顶部和底部

  12. clip_horizontal： 附加选项，裁剪基于水平方向的gravity设置，设置left时会裁剪右侧，设置right时会裁剪左侧，其他情况会同时裁剪左右两侧

子标签

如果不设置drawable属性，也可以定义drawable类型的子标签，如shape等

注意

必须设置level才会生效，而level只能在代码中设置，ImageView.setImageLevel()。除了用于进度条，配合属性动画可以实现图片各种效果的逐渐展示。

scale

与clip类似，也需要设置level值，0-10000，10000是原大小，但是可以设置超过10000的值，则为放大。

属性

• android:drawable 指定drawable资源，如果不设置该属性，也可以定义drawable类型的子标签

• android:scaleHeight 设置可缩放的高度，用百分比表示，格式为XX%，0%表示不做任何缩放，50%表示只能缩放一半

• android:scaleWidth 设置可缩放的宽度，用百分比表示，格式为XX%，0%表示不做任何缩放，50%表示只能缩放一半

• android:scaleGravity 设置drawable缩放后的位置，取值和bitmap标签的一样，就不一一列举说明了，不过默认值是left

• android:useIntrinsicSizeAsMinimum 设置drawable原有尺寸作为最小尺寸，设为true时，缩放无效

• android:level 要求api>=24，但是设置没有效果，待研究

子标签

如果不设置drawable属性，也可以定义drawable类型的子标签，如shape等

level-list

当需要在一个View中显示不同图片的时候，比如手机剩余电量不同时显示的图片不同，level-list就可以派上用场了。level-list可以管理一组drawable，每个drawable设置一组level范围，最终会根据level值选取对应的drawable绘制出来。

子标签

item

item属性

• android:drawable 指定drawable资源，如果不设置该属性，也可以定义drawable类型的子标签

• android:minLevel 该item的最小level值

• android:maxLevel 该item的最大level值

通过level-list我们就可以不用在使用if-else来动态改变图片或者背景了，直接改变level就可以了。

layer-list

这个也比较常用，主要是将几个drawable叠加在一起，通过简单的drawable实现复杂的图形。

属性

• android:autoMirrored 自动镜像，上面解释过,api>=19

• android:opacity 透明模式，根据官方注释理解设置了这个时候，子标签对应的这个属性都失效，没测试过

• android:paddingMode 堆叠模式，api>=21。有两种模式

  1. nest是默认的，将每一层都嵌套到上一层中，所以上一层的padding对这一层有效果
  2. stack将每一层直接堆叠在上一层上，上一个的padding对本层无效果

  简单解释一下，假设第一层是shape，设置了android:left=“10dp”。在nest模式下第二层是从左边10dp才开始填充，而在stack模式下第二层是从左边0dp开始填充。

• android:paddingXXX 设置内容边距（如设置为背景时）

子标签

-item 该标签下可以定义drawable类型的子标签

transition

transition其实是继承自layer-list的transition只能管理两层drawable（多余的item无效），提供了两层drawable之间切换的方法，切换时还会有淡入淡出的动画效果。

属性

都是继承layer-list，且都无效

子标签

• item 该标签下可以定义drawable类型的子标签

注意

在代码中，transition标签生成的Drawable对应的类为TransitionDrawable，要切换时，需要主动调用TransitionDrawable的startTransition()方法，参数为动画的毫秒数，也可以调用reverseTransition()方法逆向切换。

((TransitionDrawable)drawable).startTransition(500); //正向切换，即从第一个drawable切换到第二个

((TransitionDrawable)drawable).reverseTransition(500); //逆向切换，即从第二个drawable切换回第一个

animation-list

通过animation-list可以将一系列drawable构建成帧动画，就是将一个个drawable，一帧一帧的播放。

属性

• android:visible

• android:oneshot 是否循环播放

• android:variablePadding 上面提到过

子标签

• item 该标签下可以定义drawable类型的子标签。item的属性有drawable和duration

animation-rotate

这个很好理解，就是让一个drawable以某处为中心不停地做旋转动画，没旋转角度和时间，比如加载动画。

属性

• android:drawable 指定drawable资源，如果不设置该属性，也可以定义drawable类型的子标签

• android:pivotX 旋转中心的X坐标

• android:pivotY 旋转中心的Y坐标

• android:visible 设置初始的可见性状态，默认为false

子标签

如果不设置drawable属性，也可以定义drawable类型的子标签，如shape等

android5.0新增标签

vector

svg矢量图

属性

• android:name 名称

• android:width Drawable宽度

• android:height Drawable的高度

• android:viewportWidth 定义矢量图形的视图(viewport)空间的宽度，viewport是一个虚拟的canvas，这不是drawable的宽度，是指这个坐标系横向最大的数值，即将drawable横向分成多少份。

• android:viewportHeight 定义矢量图形的可视区域的高度。

• android:tint 着色

• android:tintMode 着色模式

• android:autoMirrored 自动镜像，上面提到过

• android:alpha 透明度，取值0～1

子标签：

• group： 可以包含子group和path。它的属性：
  • android:name
  • android:rotation 旋转
  • android:pivotX 旋转和缩放时的中心点的X轴坐标。取值基于viewport视图的坐标系，不能使用百分比。
  • android:pivotY 旋转和缩放时的中心点的Y轴坐标。取值基于viewport视图的坐标系，不能使用百分比。
  • android:scaleX 在X轴上的缩放比例，最先应用到图形上。
  • android:scaleY 在Y轴上的缩放比例，最先应用到图形上。
  • android:translateX 在X轴的平移距离，取值基于viewport视图的坐标系。最后应用到图形上。
  • android:translateY 在Y轴的平移距离，取值基于viewport视图的坐标系。最后应用到图形上。
• path：路径，它的属性：
  • android:name
  • android:pathData 路径的数据。主要属性，数据格式比较复杂，不在这细说了。
  • android:fillColor 填充路径的颜色，在SDK24及以上，可以指定一个颜色状态列表或者一个渐变的颜色。如果在此属性上做渐变动画，新的属性值会覆盖此值。
  • android:strokeColor 指定路径线条的颜色，在SDK24及以上，可以指定一个颜色状态列表或者一个渐变的颜色。如果在此属性上做渐变动画，新的属性值会覆盖此值。
  • android:strokeWidth 指定路径线条的宽度，基于viewport视图的坐标系
  • android:strokeAlpha 指定路径线条的透明度
  • android:fillAlpha 指定填充区域的透明度
  • android:trimPathStart 取值从0到1，表示路径从哪里开始绘制。0~trimPathStart区间的路径不会被绘制出来。
  • android:trimPathEnd 取值从0到1，表示路径绘制到哪里。trimPathEnd~1区间的路径不会被绘制出来。
  • android:trimPathOffset 平移可绘制区域，取值从0到1，线条从trimPathOffset+trimPathStart绘制到trimPathOffset+trimPathEnd，注意：trimPathOffset+trimPathEnd如果超过1，其实也是绘制的的，绘制的是0～trimPathOffset+trimPathEnd-1的位置。
  • android:strokeLineCap 设置线条首尾的外观，三个值：butt（默认，向线条的每个末端添加平直的边缘）, round（向线条的每个末端添加圆形线帽）, square（向线条的每个末端添加正方形线帽。）。
  • android:strokeLineJoin 设置当两条线条交汇时，创建什么样的边角（线段连接类型）：三个值：miter（默认，创建尖角）,round（创建圆角）,bevel（创建斜角） 。
  • android:strokeMiterLimit 设置设置最大斜接长度，斜接长度指的是在两条线交汇处内角和外角之间的距离。只有当 lineJoin 属性为 “miter” 时，miterLimit 才有效。
  • android:fillType 设置路径的填充类型
    clip-path： 只有在剪切路径内的才会显示出来，它的属性：
  • android:name
  • android:pathData 裁切路径，取值与上面讲的pathData相同。

animated-vector

svg矢量动画，需要配合动画xml（anim、animator）使用。

属性

• android:drawable svg矢量图，即VectorDrawable

子标签：

• target： 它的属性
  1. android:name vector中group或path的name
  2. android:animation group或path执行的动画，anim或animator

说明

举个列子简单来说一下，假设我们想让菜单icon（三条横线）变成后退icon（箭头）

首先我们要定义一个VectorDrawable，其中包含多条path或group，例子中是三个path，即三条横线。

然后需要定义几个anim或animator，例子中需要定义两个动画，分别是逆时针和顺时针旋转的动画

最好定义animated-vector，这样执行时可以看到上下两条横线旋转与中间横线交接，由菜单icon转成了后退icon。

这里注意，当我们使用animator直接改变pathData的时候，比如：

<objectAnimator xmlns:android="http://schemas.android.com/apk/res/android"
    android:duration="500"
    android:propertyName="pathData"
    android:valueFrom="M20,20L80,20"
    android:valueTo="M50,20L80,50"
    android:valueType="pathType" />

一定要将valueType显式设置为pathType，否则会crash，且没有crash日志。

另外经测试，在valueFrom和valueTo中的path格式要一一对应，否则也会crash，也没有日志，我的理解是因为无法计算出动画数据。

比如：

android:valueFrom="M4,8h4L8,4L4,4v4zM10,20h4v-4h-4v4zM4,20h4v-4L4,16v4zM4,14h4v-4L4,10v4zM10,14h4v-4h-4v4zM16,4v4h4L20,4h-4zM10,8h4L14,4h-4v4zM16,14h4v-4h-4v4zM16,20h4v-4h-4v4z"
android:valueTo="M4,0h4L8,4L4,4v4zM10,20h4v-4h-4v4zM4,20h4v-4L0,16v4zM4,14h4v-4L4,10v4zM10,14h4v-4h-4v4zM16,4v4h4L20,4h-4zM10,8h4L14,4h-4v4zM16,14h4v-4h-4v4zM16,20h4v-4h-4v4z"

这样就没问题，因为path的每小段的数据都是完全对应，只是每个小部分中的数值有变化

而：

android:valueFrom="M4,8h4L8,4L4,4v4zM10,20h4v-4h-4v4zM4,20h4v-4L4,16v4zM4,14h4v-4L4,10v4zM10,14h4v-4h-4v4zM16,4v4h4L20,4h-4zM10,8h4L14,4h-4v4zM16,14h4v-4h-4v4zM16,20h4v-4h-4v4z"
android:valueTo="M19,3L5,3c-1.1,0 -2,0.9 -2,2v14c0,1.1 0.9,2 2,2h14c1.1,0 2,-0.9 2,-2L21,5c0,-1.1 -0.9,-2 -2,-2zM9,17L7,17v-7h2v7zM13,17h-2L11,7h2v10zM17,17h-2v-4h2v4z"

则会crash，因为path的数据完全对应不上，无法计算出动画的中间数据

ripple

水纹效果

属性

• android:color 必填，水纹颜色

• android:radius 响应半径

子标签

• item： 如果不设置drawable属性，该标签下可以定义drawable类型的子标签

说明

item的drawable会一直显示作为背景，水纹则在其上面。

radius响应半径的意思是，以view的中心为圆心，以radius的值为半径的一个圆形区域，如果radius未设置则是view的所有区域。

当点击时，这个响应区域会填充颜色，同时产生水纹。但是水纹是以触碰点为圆心的，也就是说响应区域和水纹区域不重合。

但是如果触碰点在响应区域外，则水纹的圆心不会超出响应区域。

animated-selector

实现selector的动画，状态改变时会有一个动画效果。

属性

它是继承selector的，所以属性都一样

子标签

• item： 与selector的item子标签一样。如果不设置drawable属性，该标签下可以定义drawable类型的子标签

• transition： 它的属性：

  • android:fromId 开始item的id
  • android:toId 结束item的id
    它的子标签：
  • animation-list 过渡的帧动画

说明

这里举个例子说一下：

<animated-selector xmlns:android="http://schemas.android.com/apk/res/android">

    <item

        android:id="@+id/state_on"

        android:drawable="@drawable/btn_check_0"

        android:state_checked="false" />

    <item

        android:id="@+id/state_off"

        android:state_checked="true"

        android:drawable="@drawable/btn_check_15" />

    <transition

        android:fromId="@id/state_on"

        android:toId="@id/state_off">

        <animation-list> 

            <item

                android:drawable="@drawable/btn_check_0"

                android:duration="30" />

            ...

        animation-list>

    transition>

animated-selector>

可以看到在上面的例子中，实现了点击效果的动画，在非点击和点击两种状态转换时播放帧动画。这样可以实现不同状态间播放不同的动画。

adaptive-icon

自适应图标，必须在xxx-v26目录下，且其他版本目录中也要有对应资源，比如在mipmap-anydpi-v26中有一个adaptive-icon资源，在mipmap-xhdpi目录要有一个同名的png等资源。
否则在其他目录下直接使用这个标签会crash，其他版本目录中没有对应资源也会crash。

属性

• android:drawable

子标签

• foreground 前景，如果不设置drawable属性，该标签下可以定义drawable类型的子标签

• background 背景，如果不设置drawable属性，该标签下可以定义drawable类型的子标签

这两个标签还有一些设置位置的属性，比较简单，不一一介绍了

maskable-icon

据了解，被adaptive-icon替代了，完全一样

属性

• android:drawable

子标签

• foreground

• background

drawable

api>=24

只有一个属性class，值是类的全名，如android.graphics.drawable.ColorDrawable，否则会提示找不到类

这个标签没有找到文档，猜测是将一个自定义的drawable的java类转成xml资源

总结

熟练使用这些标签，不仅会提高你的开发效率，还会提高代码质量，减少APK体积等。比如通过一些标签可以有效的对资源进行复用，这样就可以减少大量重复冗余资源，减少APK提交，具体可以参考《Android中的资源复用小技巧》