Android 阴影控件库

AShadow

项目地址：Mosect/AShadow 

简介： Android 阴影控件库

更多：作者   提 Bug   

标签：

 

Android 阴影控件库 旧版：AShadow1，维护中，但不添加新功能。

 

使用

implementation 'com.mosect.AShadow:2.0.5'

更新记录

2.0.5

• 修复部分开发工具无法预览问题（阴影效果无法预览，只能预览填充颜色效果）

2.0.4

• 修复无法预览阴影视图问题（只能预览填充色，阴影效果不支持）

2.0.2

• 优化阴影释放，不再需要手动释放阴影
• Shadow.unbind 和 ShadowManager.unbind 方法已过时

2.0.1

• 修复 RoundShadow.draw 方法空指针异常

XML 示例

<?xml version="1.0" encoding="utf-8"?>
<com.mosect.ashadow.ShadowLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#cccccc"
    android:orientation="vertical">

    <View
        android:layout_width="100dp"
        android:layout_height="100dp"
        android:layout_gravity="center"
        app:layout_clipShadow="false"
        app:layout_roundRadius="10dp"
        app:layout_shadowColor="#000000"
        app:layout_shadowRadius="10dp"
        app:layout_solidColor="#ffffff" />
</com.mosect.ashadow.ShadowLayout>

视图属性：

属性名	JAVA	XML	取值
阴影半径	ShadowLayout.LayoutParams.shadowKey.shadowRadius	app:layout_shadowRadius	dimen
阴影 X 偏移量	ShadowLayout.LayoutParams.shadowX	app:layout_shadowX	dimen
阴影 Y 偏移量	ShadowLayout.LayoutParams.shadowY	app:layout_shadowY	dimen
阴影颜色	ShadowLayout.LayoutParams.shadowKey.shadowColor	app:layout_shadowColor	color
圆角半径	ShadowLayout.LayoutParams.shadowKey.radii	app:layout_roundRadius	dimen
左上角圆角半径	ShadowLayout.LayoutParams.shadowKey.radii	app:layout_roundLT	dimen
右上角圆角半径	ShadowLayout.LayoutParams.shadowKey.radii	app:layout_roundRT	dimen
右下角圆角半径	ShadowLayout.LayoutParams.shadowKey.radii	app:layout_roundRB	dimen
左下角圆角半径	ShadowLayout.LayoutParams.shadowKey.radii	app:layout_roundLB	dimen
填充颜色	ShadowLayout.LayoutParams.shadowKey.solidColor	app:layout_solidColor	color
阴影占用空间	ShadowLayout.LayoutParams.spaceShadow	app:layout_spaceShadow	boolean
去除填充色	ShadowLayout.LayoutParams.noSolid	app:layout_noSolid	boolean

说明：

放到 ShadowLayout 中的视图都可以设置阴影，默认阴影半径和偏移量会影响其位置。可以通过设置 spaceShadow（ShadowLinearLayout 和 ShadowRelativeLayout 不支持）控制阴影是否影响视图位置。

自定义实现阴影或使用

• 可以通过 ShadowManager.get 方法获取一个阴影
• 如果有额外实现的阴影，需要在 ShadowManager 中添加 ShadowFactory（阴影工厂）
• Shadow 对象不在需要手动释放

Shadow（阴影）

Shadow，表示一种阴影，抽象类，需要去实现 draw 和 onDestroy 方法；调用 Shadow.draw 方法可以在画布的某个区域画出阴影效果。创建一个阴影对象需要 key 对象，key 对象包含实现此种阴影所需的信息，通过 Shadow.getKey 方法可以获取阴影对象的 key。

/**
 * 表示一种阴影
 */
public abstract class Shadow {

    /**
     * 获取阴影 key
     *
     * @return 阴影 key
     */
    public Object getKey() {
        return key;
    }

    /**
     * 将阴影对象画在画布上
     *
     * @param canvas 画布
     * @param rect   位置和大小
     * @param paint  额外画笔
     */
    public abstract void draw(@NonNull Canvas canvas, @NonNull Rect rect, @Nullable Paint paint);
}

ShadowManager（阴影管理器）

管理阴影的创建和释放，提供了默认的阴影管理器：ShadowManager.getDefault()。创建阴影需要阴影工厂（ShadowFactory），可以使用 addFactory 和 removeFactory 方法进行增加和移除阴影工厂。

/**
 * 阴影管理器
 */
public class ShadowManager {

    /**
     * 获取一个默认的阴影管理器
     *
     * @return 阴影管理器
     */
    public static ShadowManager getDefault() {
    }

    /**
     * 绑定一个阴影（阴影）
     *
     * @param key 阴影 key
     * @return 阴影对象
     * @throws UnsupportedKeyException 不支持的阴影 key
     */
    public Shadow get(@NonNull Object key) throws UnsupportedKeyException {
    }

    /**
     * 解绑一个阴影
     *
     * @param shadow 阴影对象
     * @return true，解绑成功
     */
    public boolean unbind(@NonNull Shadow shadow) {
    }

    /**
     * 添加阴影工厂
     *
     * @param factory 阴影工厂
     */
    public void addFactory(@NonNull ShadowFactory factory) {
    }

    /**
     * 移除阴影工厂
     *
     * @param factory 阴影工厂
     */
    public void removeFactory(@NonNull ShadowFactory factory) {
    }
}

ShadowFactory（阴影工厂）

一种阴影对应一个工厂，工厂接口提供以下方法：

/**
 * 阴影工厂
 */
public interface ShadowFactory {

    /**
     * 判断是否支持此阴影 key
     *
     * @param key 阴影 key
     * @return true，支持此阴影 key
     */
    boolean supportKey(@NonNull Object key);

    /**
     * 复制阴影 key
     *
     * @param key 阴影 key
     * @return key 的备份
     * @throws UnsupportedKeyException 不支持的阴影 key
     */
    @NonNull
    Object copyKey(@NonNull Object key) throws UnsupportedKeyException;

    /**
     * 创建阴影
     *
     * @param key 阴影 key
     * @return 阴影
     * @throws UnsupportedKeyException 不支持的阴影 key
     */
    @NonNull
    Shadow create(@NonNull Object key) throws UnsupportedKeyException;
}

RoundShadow（圆角矩形阴影）

对 Shadow 的实现，可以绘制圆角矩形阴影效果

RoundShadow.Key（圆角矩形阴影创建的 key，即阴影信息）

    /**
     * 圆角矩形阴影的 key，可以用来创建阴影对象和比较阴影对象是否一样
     */
    public static class Key implements Serializable, Cloneable {

        public int shadowColor;
        public float shadowRadius;
        public int solidColor;
        public float[] radii;
        public boolean noSolid;

        /**
         * 克隆此对象
         *
         * @return 此对象副本
         */
        @Override
        public Key clone() {
        }

        @Override
        public int hashCode() {
        }

        @Override
        public boolean equals(@Nullable Object obj) {
        }

        /**
         * 检查阴影参数是否有效，无效抛异常
         */
        public void check() {
        }

        /**
         * 判断是否含有圆角
         *
         * @return true，含有圆角
         */
        public boolean hasRound() {
        }
    }

RoundShadowFactory（圆角矩形阴影工厂）

RoundShadow 的工厂类

ShadowHelper

阴影辅助工具类，帮组视图更好的绘制阴影。

package com.mosect.ashadow;

/**
 * 阴影辅助器
 */
public class ShadowHelper {

    private Rect childRect = new Rect();

    /**
     * 将阴影画在画布上
     *
     * @param canvas 画布
     * @param rect   阴影位置和大小
     * @param shadow 阴影对象
     * @param matrix 阴影转换矩阵
     * @param paint  画笔
     */
    public void drawShadow(
    }

    /**
     * 绘制子视图阴影
     *
     * @param canvas  画布
     * @param child   子视图
     * @param shadow  阴影
     * @param shadowX 阴影偏移量：X
     * @param shadowY 阴影偏移量：Y
     */
    public void drawChildShadow(
    }
}

联系信息

QQ：905340954
邮箱：zhouliuyang1995@163.com
网站：http://www.mosect.com （建设中）