AShadow

Project Url: Mosect/AShadow
Introduction: Android 阴影控件库
More: Author   ReportBugs   
Tags:

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

AShadow2

AShadow2

AShadow2

使用

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 (建设中)
Apps
About Me
Google+: Trinea trinea
GitHub: Trinea