CrazyShadow

Additional

Language
Java
Version
v1.0.1 (Nov 11, 2016)
Created
Oct 18, 2016
Updated
Dec 26, 2016
Owner
Hitomi (Hitomis)
Contributor
Hitomi (Hitomis)
1
Activity
Badge
Generate
Download
Source code
APK file

Blurb

CrazyShadow

CrazyShadow 是一个专门为 View 添加阴影效果的库。 CrazyShadow 支持自定义阴影实现方式、阴影颜色、阴影经度大小、阴影附加方位。

说明:
CrazyShadow 主要是因为自己一直想为最近编写的 ActivitySwitch 添加阴影效果,之前在网上一直没有找到合适的可以用的参考案例。所以只能自己去编写这样一个 library。

而在实际运用在,发现理想总是丰满的,现实很骨感。虽然可以实现优美的效果以及多功能性,但是使用场景比较单一:只能 为传统的矩形UI(即最终显示效果)添加阴影。为什么结果会是这样呢?大家都知道,一个 View 显示的模型肯定是一个矩形,不 管如何自定义 View 都有 left、top、right、bottom 以及 width、height 等一些概念,而这些概念也定位了 View 的模 型必定为一个矩形。所以 阴影效果的添加依据模型必定也是一个矩形。

虽然有了很多限制,我想既然都做了,还是尽自己最大努力吧,目前 CrazyShadow 支持三种方式为 View 添加阴影效果。

  1. wrap : 以包装 View 的方式添加阴影效果。该方式会改变 View 的大小。因为如果保持 View 大小不变同时又在 View四周添加了阴影,那么 View 的尺寸定会比之前大,这样可能会引起 View 周围其他 View 的位置变化。

  2. float : 以 View 的根视图(ContentFrameLayout) 中添加一层阴影效果。不过因为与 View 不在一个布局层面上,所以当发生用户交互使原 View 的位置发生改变后,阴影还是会留在原来的位置。此种方式只能在位置不会发生改变的 View 上使用。慎用啊

  3. drawable : 直接创建一个附带阴影效果的矩形(支持圆角) drawable 作为 View 的 background, 简单粗暴。不过因为 background 的最大尺寸为原 View 的尺寸,所以设置了阴影后,原 View 大小会依据配置的阴影大小发生变化,并且原 View 的位置会向上的偏移来显示出阴影的效果。

Preview

Import

Gradle

Step 1. Add the JitPack repository to your build file

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

Step 2. Add the dependency

dependencies {
        compile 'com.github.Hitomis:CrazyShadow:v1.0.1'
}

Maven

Step 1. Add the JitPack repository to your build file

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

Step 2. Add the dependency

<dependency>
    <groupId>com.github.Hitomis</groupId>
    <artifactId>CrazyShadow</artifactId>
    <version>v1.0.1</version>
</dependency>

Usage

​
    new CrazyShadow.Builder()
            .setContext(this)
            .setDirection(CrazyShadowDirection.ALL)
            .setShadowRadius(dip2Px(3))
            .setCorner(dip2Px(5))
            .setBackground(Color.parseColor("#96a993"))
            .setImpl(CrazyShadow.IMPL_DRAW)
            .action(findViewById(R.id.relay_draw1));
​

更多示例代码可以查看 MainActivity

Attribute

属性 说明
impl 以何种方式添加阴影,支持 wrap、float、drawable 三种方式
baseShadowColor 阴影的基本颜色,即最深的颜色,与 colors 表示为同一个作用, 如果baseShadowColor 与 colors 都不设置,阴影会使用默认颜色
background 修改 View 的背景色,如果使用 drawable 方式添加阴影,那么该属性必须添加
colors 绘制阴影时需要的一个颜色由深到浅且长度为3的数组, 该属性与 baseShadowColor 起同一个作用,如果单单只设置 baseShadowColor 也会自动转换成为 colors
corner 阴影顶点的内侧弧度。以适配被设置的 View 是圆角的情况, 对使用 drawable 方式设置阴影时,该属性表示为圆角矩形背景的圆角角度
shadowRadius 阴影大小
direction 设定阴影在 View 上显示的方位, 支持的方位详情可以查看 CrazyShadowDirection

Method

方法 说明
make 为 View 添加阴影效果, 使用 Builder 的 action 方法时会自动调用
remove 移除阴影
hide 隐藏阴影,与 remove 不同的是,hide 只是隐藏了 View 周围的阴影效果,并没有移除
show 如果调用了 hide ,可以再使用 show 将阴影效果显示出来

Licence

  Copyright 2016 Hitomis, Inc.

  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.