Skip to content

可定制化阴影的万能阴影布局ShadowLayout 3.0 震撼上线。效果赶超CardView。阴影支持x,y轴偏移,支持阴影扩散程度,支持阴影圆角,支持单边或多边不显示阴影;控件支持动态设置shape和selector(项目里再也不用画shape了);支持随意更改颜色值,支持随意更改颜色值,支持随意更改颜色值。重要的事情说三遍

License

Notifications You must be signed in to change notification settings

onlyeLC/ShadowLayout

Repository files navigation

万能阴影布局,定制化你要的阴影:ShadowLayout。 (嵌套后即可享受阴影,甩掉CardView几条街)

支持定制化阴影:
    1. 随意修改阴影颜色值
    2. 阴影圆角:可统一设置圆角,也可对某几个角单独设置
    3. x,y轴阴影偏移
    4. 随意修改阴影扩散程度
    5. 隐藏阴影:隐藏某边或多边阴影,或完全隐藏
    
不止于阴影;系统shape功能:项目中shape、selector、ripple统统拥有。解放你的双手,清空项目drawable文件夹
    1. shape样式:pressed(按钮点击)、selected(按钮选择)、ripple(点击水波纹)
    2. 背景色设置
    3. stroke边框设置
    4. 渐变色背景色值
    5. 按钮是否可被点击

3.1.0更新功能及ShadowLayout成长历程

  • shapeMode新增了ripple(点击水波纹样式),具体会在README中说明
  • ShadowLayout,新增了渐变色,这也是issues大量出现的需求,感谢大家的支持

Shadow成长历程

注意

因为3.0修改了大量api及规范命名,如不方便转移还在使用2.0的。可查看2.0文档ShadowLayout 2.1.8

效果展示(截图分辨率模糊,真机运行效果赶超CardView)

基础功能展示 各属性展示 随意更改颜色

2.0功能更新

2.1.6新增shape,selector功能 2.1.7isSym属性对比 2.1.8单独更改某圆角大小
Sample

3.0.1版本来袭

stroke边框及点击 shape及图片selector 组合使用
Sample

3.1.0新增ripple及渐变色

stroke边框及点击

gif为了流畅清晰度模糊,扫描二维体验效果(下载密码是:123456)


添加依赖

  • 项目build.gradle添加如下
    allprojects {
     	repositories {
     		maven { url 'https://jitpack.io' }
     	}
     }
  • app build.gradle添加如下
    dependencies {
            implementation 'com.github.lihangleo2:ShadowLayout:3.1.0'
    }

基本使用

一、阴影的简单使用

            <com.lihang.ShadowLayout
                android:id="@+id/mShadowLayout"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_gravity="center_horizontal"
                app:hl_cornerRadius="10dp"
                app:hl_shadowColor="#2a000000"
                app:hl_shadowLimit="5dp"
                >

                <TextView
                    android:id="@+id/txt_test"
                    android:layout_width="wrap_content"
                    android:layout_height="36dp"
                    android:gravity="center"
                    android:paddingLeft="10dp"
                    android:paddingRight="10dp"
                    android:text="圆角"
                    android:textColor="#000" />
            </com.lihang.ShadowLayout>

二、stroke边框的简单使用

            <com.lihang.ShadowLayout
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_gravity="center_horizontal"
                app:hl_cornerRadius="10dp"
                app:hl_strokeColor="#000">

                <TextView
                    android:layout_width="wrap_content"
                    android:layout_height="36dp"
                    android:gravity="center"
                    android:paddingLeft="10dp"
                    android:paddingRight="10dp"
                    android:text="圆角边框"
                    android:textColor="#000" />
            </com.lihang.ShadowLayout>

三、shape selector的简单使用

            <com.lihang.ShadowLayout
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_gravity="center_horizontal"
                android:layout_marginTop="10dp"
                app:hl_cornerRadius="30dp"
                app:hl_cornerRadius_leftTop="0dp"
                app:hl_layoutBackground="#F76C6C"
                app:hl_layoutBackground_true="#89F76C6C"
                app:hl_shapeMode="pressed">

                <TextView
                    android:layout_width="wrap_content"
                    android:layout_height="36dp"
                    android:gravity="center"
                    android:paddingLeft="10dp"
                    android:paddingRight="10dp"
                    android:text="selector的pressed用法,请点击"
                    android:textColor="#fff" />
            </com.lihang.ShadowLayout>

三、图片 selector的简单使用

    <com.lihang.ShadowLayout
        android:id="@+id/ShadowLayout_shape"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"
        android:layout_marginTop="10dp"
        app:hl_cornerRadius="18dp"
        app:hl_cornerRadius_rightTop="0dp"
        app:hl_layoutBackground="@mipmap/test_background_false"
        app:hl_layoutBackground_true="@mipmap/test_background_true">


        <TextView
            android:layout_width="wrap_content"
            android:layout_height="36dp"
            android:gravity="center"
            android:paddingLeft="10dp"
            android:paddingRight="10dp"
            android:text="图片selector"
            android:textColor="#fff" />

    </com.lihang.ShadowLayout>

如果你觉得麻烦,你还可以这样

            <com.lihang.ShadowLayout
                android:id="@+id/ShadowLayout_image"
                android:layout_width="50dp"
                android:layout_height="50dp"
                android:layout_gravity="center_horizontal"
                android:layout_marginTop="10dp"
                app:hl_layoutBackground="@mipmap/game_6_right"
                app:hl_layoutBackground_true="@mipmap/game_6_wrong"
                app:hl_shapeMode="pressed" />

四、渐变色的简单使用

            <com.lihang.ShadowLayout
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                app:hl_cornerRadius="18dp"
                app:hl_startColor="#ff0000"
                app:hl_endColor="#0000ff"
                >

                <TextView
                    android:layout_width="160dp"
                    android:layout_height="40dp"
                    android:gravity="center"
                    android:text="渐变色"
                    android:textColor="#fff" />

            </com.lihang.ShadowLayout>

五、水波纹ripple的使用

            <com.lihang.ShadowLayout
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                app:hl_cornerRadius="18dp"
                app:hl_shadowColor="#2a000000"
                app:hl_shadowLimit="7dp"
                app:hl_layoutBackground="#fff"
                app:hl_layoutBackground_true="#ff0000"
                app:hl_shapeMode="ripple"
                >

                <TextView
                    android:layout_width="160dp"
                    android:layout_height="40dp"
                    android:gravity="center"
                    android:text="水波纹"
                    />

            </com.lihang.ShadowLayout>

属性表格

一、关于阴影

name format description
hl_shadowHidden boolean 是否隐藏阴影(默认false)
hl_shadowColor color 阴影颜色值,如不带透明,默认透明16%
hl_shadowLimit dimension 阴影扩散程度(dp)
hl_shadowOffsetX dimension x轴的偏移量(dp)
hl_shadowOffsetY dimension y轴的偏移量(dp)
hl_shadowHiddenLeft boolean 左边的阴影不可见,其他3边同理
hl_shadowSymmetry boolean 控件区域是否对称(默认true)根据此图理解
Sample

二、关于圆角

name format description
hl_cornerRadius dimension 包括阴影圆角、shape圆角(dp)
hl_cornerRadius_leftTop dimension 左上圆角,其他角还是hl_cornerRadius值;同理其他3角(dp)

三、关于shape

  • 3.1、关于shape样式及背景色

name format description
hl_shapeMode enum 有3种模式:pressed和selected。和系统shape一样,以及ripple点击水波纹
hl_layoutBackground reference/color 背景色,为false时展示:可以是颜色值,图片以及系统shape样式
hl_layoutBackground_true reference/color 背景色,为true时展示:可以是颜色值,图片以及系统shape样式

  • 3.2、关于stroke边框

name format description
hl_strokeWith dimension stroke边框线宽度
hl_strokeColor color 边框颜色值,为false展示
hl_strokeColor_true color 边框颜色值,为true展示

  • 3.3、关于渐变色

name format description
hl_startColor color 渐变起始颜色(设置渐变色后,hl_layoutBackground属性将无效)
hl_centerColor color 渐变中间颜色(可不填)
hl_endColor color 渐变的终止颜色
hl_angle integer 渐变角度(默认0)

四、关于clickable

name format description
clickable boolean 设置ShadowLayout是否可以被点击;代码设置:mShadowLayout.setClickable(false);(默认true)
hl_layoutBackground_clickFalse reference/color Clickable为false时,要展示的图片或颜色。(此属性应当在app:hl_shapeMode="pressed"时生效)

关于作者。

Android工作多年了,一直向往大厂。在前进的道路上是孤独的。如果你在学习的路上也感觉孤独,请和我一起。让我们在学习道路上少些孤独


Licenses

MIT License

Copyright (c) 2019 leo

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

About

可定制化阴影的万能阴影布局ShadowLayout 3.0 震撼上线。效果赶超CardView。阴影支持x,y轴偏移,支持阴影扩散程度,支持阴影圆角,支持单边或多边不显示阴影;控件支持动态设置shape和selector(项目里再也不用画shape了);支持随意更改颜色值,支持随意更改颜色值,支持随意更改颜色值。重要的事情说三遍

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 100.0%