Android开发控件阴影详情

阅读原文时间：2023年07月10日阅读：2

前言

　　Android的阴影概念是跟随Material Design设计风格出现的，因为Material Design的设计有Z轴概念，就是每个View都有自己的深度层级。Z轴的概念有了之后必然有表现这一概念的阴影效果的实现。所以google在Android5.0版本添加这阴影效果的支持。此篇博客不啰嗦Material Design的部分，我们只聊聊阴影的实现。

实现阴影功能的Api组件有那些？

　　这里，先给出彻底了解阴影效果实现能涉及到的属性或者Api表。这样有一个笼统的概念，后面会一一讲解，就会了解这些组件各种涉及的功能范围。

.设置View的Z轴高度 android:elevation="10dp" 对应代码 setElevation();

2.设置View的Z轴高度 android:translationZ="10dp" 对应代码 setTranslationZ()

3.设置View阴影轮廓范围的模式 android:outlineProvider="" 对应代码 setOutlineProvider();

4.设置View的阴影颜色 android:outlineSpotShadowColor="#03A9F4" 对应代码 setOutlineSpotShadowColor()（请注意！此条属性必需在高于Android10版本包含10的版本才有效果）

5.设置View的阴影光环颜色，但是基本看不到，非常迷惑的属性。 android:outlineAmbientShadowColor="#03A9F4" 对应代码 setOutlineAmbientShadowColor（请注意！此条属性必需在高于Android10版本包含10的版本才有效果）

6.设置View自定义形状的阴影 setOutlineProvider(new ViewOutlineProvider(){ //略..});

特别需要注意的地方

　　在开始之前，还是说一下要避坑的地方。

请开启硬件加速功能 android:hardwareAccelerated="true" ，现在的设备一般是默认开启硬件加速的。但是如果你主动设置关闭会出现没有阴影效果的问题。
请检查好自己的Android版本，必需在5.0以上。设置阴影颜色效果必需需要在10.0以上。
阴影是绘制于父控件上的，所以控件与父控件的边界之间需有足够空间绘制出阴影才行。
如果未设置 android:outlineProvider="bounds" ，那么控件这个属性会默认为android:outlineProvider="background"，这个时候View必须设置背景色，且不能为透明，否则会没有阴影。
不能将elevation 或者 translationZ 的值设置的比整个View还大，这样会有阴影效果。但是阴影的渐进效果会被拉的很长很长，会看不清楚阴影效果，你会错认觉得没有阴影效果。

android:elevation与android:translationZ

这两个属性都是设置View的Z轴高度，他们的关系是：实际ViewZ轴高度 = elevation + translationZ

google为什么要这么别扭的弄出2个一样功能的实现来配置Z轴高度呢？这就是涉及到他们2个的区别：

elevation 是View的默认值Z轴高度
translationZ 是View的动态Z轴高度，什么是动态高度？就是假设你需要实现阴影动画，改变Z轴高度，你就应该使用此条属性。

实现阴影动画例子

xml：

<TextView  
    android:id="@+id/view\_1"  
    android:layout\_width="100dp"  
    android:layout\_height="100dp"  
    android:text="内容1"  
    android:elevation="10dp"  
    android:gravity="center"  
    android:layout\_marginTop="30dp"  
    android:outlineProvider="bounds"  
    android:outlineSpotShadowColor="#FF1100"  
    app:layout\_constraintTop\_toTopOf="parent"  
    app:layout\_constraintLeft\_toLeftOf="parent"  
    app:layout\_constraintRight\_toRightOf="parent">  
</TextView>

注意，因为下面的效果图是git，但是git图压缩的很厉害，为了阴影效果看的更清楚，所以我这里设置了 android:outlineProvider="bounds" 属性与改变了阴影颜色 android:outlineSpotShadowColor="#FF1100" 让下面的效果图更明显。如果你是自己实验此代码可以忽略这2个属性。

java

　　　　 mView1 = findViewById(R.id.view_1);
mView1.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
float[] floats = new float[]{50, 30, 0};
ObjectAnimator objectAnimator = ObjectAnimator.ofFloat(mView1, "translationZ", floats);
objectAnimator.setDuration(10 * 1000);
objectAnimator.setInterpolator(new CycleInterpolator(3f));
objectAnimator.start();
}
});

效果图：

android:outlineSpotShadowColor 与 android:outlineAmbientShadowColor

在上面已经说明过了，就是改变阴影的颜色，但是此api一定得需要Android10.0以上（包含10）版本才能生效。效果图也可以参考上面的。

android:outlineProvider

　　阴影有一个轮廓的概念，那就是这个View的是什么形状的，换句话说这个View背景是什么形状的，阴影就需要根据View的背景形状而改变阴影形状的。举一个栗子：假如有一个圆形背景的View出现了一个正方形轮廓的阴影。多么怪异，阴影都到圆形的外面了，不是环绕的圆形阴影。所以，深入了解android:outlineProvider可以配置4个属性对你需要什么轮廓的阴影是非常有意义的。

background

设置这个属性，阴影轮廓将跟随 android:background="@drawable/circle" 设置的shape形状改变。但是其实非常鸡肋，个人亲自验证过只有以下2种shape才会有轮廓阴影如下。其他2个ring与line，空心矩形，都不支持。另外不支持矢量图与位图，这2个别多想了

支持的圆形

支持的圆角矩形

例子：

<TextView  
    android:id="@+id/view\_1"  
    android:layout\_width="100dp"  
    android:layout\_height="100dp"  
    android:text="内容1"  
    android:elevation="10dp"  
    android:gravity="center"  
    android:background="@drawable/circle"  
    android:outlineProvider="background"  
    android:layout\_marginTop="30dp"  
    app:layout\_constraintTop\_toTopOf="parent"  
    app:layout\_constraintLeft\_toLeftOf="parent"  
    app:layout\_constraintRight\_toRightOf="parent">  
</TextView>

效果图：

none

设置阴影轮廓为null，设置后View将没有阴影。

bounds

设置这个属性，为视图View的边界生成不透明的轮廓

paddedBounds

与bounds类似，设置这个属性，为视图View的填充边界生成不透明的轮廓。

setOutlineProvider

　　此api其实就是对应android:outlineProvider这个属性的，除了可以在代码上设置3种不同的属性 BACKGROUND，BOUNDS，PADDED_BOUNDS （是的，少了none）。

3个预设属性

    mView1.setOutlineProvider(ViewOutlineProvider.BACKGROUND);  
    mView1.setOutlineProvider(ViewOutlineProvider.BOUNDS);  
    mView1.setOutlineProvider(ViewOutlineProvider.PADDED\_BOUNDS);

与直接设置android:outlineProvider不同的地方是，它可以自定义阴影轮廓。所以，这里就只重点关注怎么自定义阴影轮廓。

    mView1.setOutlineProvider(new ViewOutlineProvider() {  
        @Override  
        public void getOutline(View view, Outline outline) {

        }  
    });

实现自定义，我们需要new一个ViewOutlineProvider抽象方法，重写getOutline方法。这里面Outline这个返回值是处理阴影轮廓的重点。

Outline的Api

public void setOval(int left, int top, int right, int bottom) 　　　　　　　　　　　设置圆形阴影轮廓，参数是4个边的坐标值
public void setOval(@NonNull Rect rect)　　　　　　　　　　　　　　　　　　设置圆形阴影轮廓，包含4个坐标值的Rect
public void setRoundRect(int left, int top, int right, int bottom, float radius)　　　设置圆角矩形阴影轮廓，参数是4个边的坐标值与一个圆角半径
public void setRoundRect(@NonNull Rect rect, float radius) 　　　设置圆角矩形阴影轮廓，包含4个坐标值的Rect与一个圆角半径
public void setEmpty()　　　　　　　　　　　　　　　　　　　　　　　　　　设置为空，无阴影
public void set(@NonNull Outline src)　　　　　　　　　　　　　　　　　　　　设置另一个Outline并且复制成为当前View的阴影轮廓
public void setAlpha(@FloatRange(from=0.0, to=1.0) float alpha)　　　　　　　设置阴影的透明度，取值范围是0.0到 1.0
public void setConvexPath(@NonNull Path convexPath)　　　　　　　　　　　设置传入一个凸Path，成为阴影轮廓
public void offset(int dx, int dy)　　　　　　　　　　　　　　　　　　　　　　　设置阴影的坐标偏移

setOval()

设置阴影轮廓为圆形

xml

<TextView  
    android:id="@+id/view\_1"  
    android:layout\_width="100dp"  
    android:layout\_height="100dp"  
    android:text="内容1"  
    android:elevation="20dp"  
    android:background="@android:color/holo\_orange\_dark"  
    android:gravity="center"  
    android:layout\_marginTop="30dp"  
    app:layout\_constraintTop\_toTopOf="parent"  
    app:layout\_constraintLeft\_toLeftOf="parent"  
    app:layout\_constraintRight\_toRightOf="parent">  
</TextView>

java

    mView1.setOutlineProvider(new ViewOutlineProvider() {  
        @Override  
        public void getOutline(View view, Outline outline) {  
            outline.setOval(0, 0, view.getWidth(), view.getHeight());  
        }  
    });  
    mView1.setClipToOutline(true);//开启裁剪到轮廓

这里设置 mView1.setClipToOutline(true); 这个属性，在设置阴影轮廓为圆形的同时，也会将View的背景裁剪成圆。所以，有一些人会有一些奇思妙想，比如把这个作为裁剪View的手段。比如把ImageView裁剪成圆形，这样设置的ImageView的图片也会变成圆形。这种用法没错，但是与google的目的有些背道而驰，google只是希望快速的方便你根据阴影形状改变下View的背景形状，而不是将它作为裁剪View背景的方法。如果将setOutlineProvider与setClipToOutline的组合理解成裁剪View的背景，那就大错特错了。并且setClipToOutline 这个方法十分鸡肋，根本无法满足你裁剪View背景的需求，这个后面在说。（裁剪View的背景的正道还是自定义View，自己去实现onDraw方法）

效果图：

setRoundRect()

设置阴影轮廓为圆角矩形

xml

与上面圆形阴影一样

java

    mView1.setOutlineProvider(new ViewOutlineProvider() {  
        @Override  
        public void getOutline(View view, Outline outline) {  
            outline.setRoundRect(0, 0, view.getWidth(), view.getHeight(), 30);  
        }  
    });  
    mView1.setClipToOutline(true);//开启裁剪到轮廓

效果图：

setConvexPath()

这个方法就很有趣了，我经过多次尝试终于明白了，这个方法怎么使用。这些说明setConvexPath方法的特别注意点：

1.setConvexPath 设置的Path必需是凸的

2.setConvexPath 无法配合 setClipToOutline方法裁剪View的背景，所以在前面说setClipToOutline其实很鸡肋。

setConvexPath 设置的Path必需是凸的

这里我用2个图片举例，你就会明白什么是凸的图像。

凸图像：

凸图像的意思是，这个图像必需是闭合且是实心的。不能只是2个线条，必需是3个以上的线条组成的一个闭合实心图像。这个矩形就是凸的图像，它有4个边线组成且是实心的。

不是凸的图像：

这个空心矩形就不是凸的。

给一个View是三角形背景加阴影轮廓的例子

给一个View是三角形背景加阴影轮廓，假设我们现在需要给下面的矢量图背景添加一个阴影轮廓。

如果我们只使用xml属性的，期望android:outlineProvider="background" 这个属性实现阴影，可以看到完全没有阴影的View。因为之前说了 background 这个属性不支持矢量图与位图的。

xml

<TextView  
    android:id="@+id/view\_1"  
    android:layout\_width="100dp"  
    android:layout\_height="100dp"  
    android:text="内容1"  
    android:elevation="20dp"  
    android:background="@drawable/ic\_triangle"  
    android:gravity="center"  
    android:layout\_marginTop="30dp"  
    android:outlineProvider="background"  
    app:layout\_constraintTop\_toTopOf="parent"  
    app:layout\_constraintLeft\_toLeftOf="parent"  
    app:layout\_constraintRight\_toRightOf="parent">  
</TextView>

没有阴影效果的View：

通过自定义阴影轮廓给View加上一个三角形的阴影轮廓

xml

<TextView  
    android:id="@+id/view\_1"  
    android:layout\_width="100dp"  
    android:layout\_height="100dp"  
    android:text="内容1"  
    android:elevation="30dp"  
    android:background="@drawable/ic\_triangle"  
    android:gravity="center"  
    android:layout\_marginTop="30dp"  
    android:outlineProvider="bounds"  
    app:layout\_constraintTop\_toTopOf="parent"  
    app:layout\_constraintLeft\_toLeftOf="parent"  
    app:layout\_constraintRight\_toRightOf="parent">  
</TextView>

java

    mView1.setOutlineProvider(new ViewOutlineProvider() {  
        @Override  
        public void getOutline(View view, Outline outline) {  
            Path path = new Path();  
            path.moveTo(0,0);  
            path.lineTo(view.getWidth(), 0);  
            path.lineTo(0, view.getHeight());  
            //闭合路径  
            path.close();  
            outline.setConvexPath(path);

        }  
    });

带三角形阴影轮廓的效果图：

如何取消Button控件阴影?

android:elevation="0dp" 设置为0就已经取消了控件的阴影.但是这里Button有一个坑…

关于Button坑

在Android5.1之后Button控件其实是强制保持在所有控件最上面的,android:elevation="0dp" 无法让Button的强制最上层属性被改变.这个时候需要就需要android:stateListAnimator="@null"这个属性.

End

手机扫一扫

移动阅读更方便

你可能感兴趣的文章

Android13深入了解 Android 小窗口模式和窗口类型

Android开发 控件阴影详情

前言

实现阴影功能的Api组件有那些？

特别需要注意的地方

android:elevation与android:translationZ

实现阴影动画例子

android:outlineSpotShadowColor 与 android:outlineAmbientShadowColor

android:outlineProvider

background

例子：

none

bounds

paddedBounds

setOutlineProvider

Outline的Api

setOval()

setRoundRect()

setConvexPath()

setConvexPath 设置的Path必需是凸的

给一个View是三角形背景加阴影轮廓的例子

如果我们只使用xml属性的，期望android:outlineProvider="background" 这个属性实现阴影，可以看到完全没有阴影的View。因为之前说了 background 这个属性不支持矢量图与位图的。

通过自定义阴影轮廓给View加上一个三角形的阴影轮廓

如何取消Button控件阴影?

关于Button坑

Android开发控件阴影详情