# AShadow2 **Repository Path**: mosect/AShadow2 ## Basic Information - **Project Name**: AShadow2 - **Description**: Android阴影控件库 - **Primary Language**: Java - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 3 - **Created**: 2022-06-05 - **Last Updated**: 2025-03-20 ## Categories & Tags **Categories**: android-modules **Tags**: shadowlayout, Android, shadow, shadowview ## README # AShadow2 Android阴影控件库 旧版：[AShadow1](https://github.com/Mosect/AShadow/tree/AShadow1)，维护中，但不添加新功能。 ![AShadow2](img/01.jpg) ![AShadow2](img/02.jpg) ![AShadow2](img/03.jpg) ## 使用 [![](https://jitpack.io/v/Mosect/AShadow2.svg)](https://jitpack.io/#Mosect/AShadow2) 在项目根节点的build.gradle中配置： ``` allprojects { repositories { maven { url 'https://jitpack.io' } } } ``` 在需要引入的项目build.gradle中添加 ``` implementation 'com.github.Mosect:ViewUtils:1.0.8' implementation 'com.github.Mosect:AShadow2:2.0.6' ``` ## 更新记录 ### 2.0.6 * 弃用jcenter,更改成jitpack ### 2.0.5 * 修复部分开发工具无法预览问题（阴影效果无法预览，只能预览填充颜色效果） ### 2.0.4 * 修复无法预览阴影视图问题（只能预览填充色，阴影效果不支持） ### 2.0.2 * 优化阴影释放，不再需要手动释放阴影 * Shadow.unbind和ShadowManager.unbind方法已过时 ### 2.0.1 * 修复RoundShadow.draw方法空指针异常 ## XML示例 ``` ``` 视图属性： 属性名 | 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 （建设中） ```