shadowlib

Library for colored, customizable, easy to use shadows on Android

This library is based on https://github.com/Devlight/ShadowLayout

Differences:

ported to kotlin
parameter names changed (similar to CSS)
removed angle parameter to give flexiblity of setting dx, dy
added ViewPump interceptor

Setup - without Viewpump

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

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

Step 2. Add the dependency

	dependencies {
	        implementation 'com.github.maciekczwa:shadowlib:1.0.2'
	}

Setup - with ViewPump

When using ViewPump additional steps are needed.

Add ViewPump to your build.gradle:

implementation 'io.github.inflationx:viewpump:1.0.0'

Library can automatically add ShadowLayout to existing view in hierarchy when you use ViewPump library and set ShadowInterceptor.

Setup ViewPump in Application:

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        ViewPump.init(ViewPump.builder()
                .addInterceptor(ShadowsInterceptor(this))
                .build())
    }
}

Setup ViewPump in Activity:

class MainActivity : AppCompatActivity() {

    override fun attachBaseContext(newBase: Context) {
        super.attachBaseContext(ViewPumpContextWrapper.wrap(newBase))
    }
}

Usage - without ViewPump

Just add ShadowLayout into your view and set shadow parameters:

       <pl.looksoft.shadowlib.ShadowLayout
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:shadowLayoutBlur="1dp"
            app:shadowLayoutColor="#33FF00FF"
            app:shadowLayoutDx="12dp"
            app:shadowLayoutDy="32dp"
            app:shadowLayoutSpread="-10dp">

            <Button
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="b4 - layout test"
                app:layout_constraintLeft_toLeftOf="@id/b1"
                app:layout_constraintTop_toBottomOf="@id/b2" />

        </pl.looksoft.shadowlib.ShadowLayout>

Usage - with ViewPump

When using ViewPump you don't need to add ShadowLayout - it will be automatically added during inflation if you set any of shadow parameters on the view.

Be sure not to include namespace in xml parameters.

    <Button
            android:id="@+id/b1"
            shadowLibBlur="5dp"
            shadowLibColor="#FF0000"
            shadowLibDx="10dp"
            shadowLibDy="5dp"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="b1 - auto add layout"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintRight_toRightOf="parent"
            app:layout_constraintTop_toTopOf="parent" />

You can also use styles:

       <Button
            android:id="@+id/b8"
            style="@style/ShadowReferenceStyle"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="b8 - reference style test"
            app:layout_constraintLeft_toLeftOf="@id/b1"
            app:layout_constraintTop_toBottomOf="@id/b7" />

   <style name="ShadowReferenceStyle">
        <item name="shadowLibBlur">@dimen/ten_dp</item>
        <item name="shadowLibColor">@color/colorPrimaryDark</item>
        <item name="shadowLibDx">@dimen/ten_dp</item>
        <item name="shadowLibDy">@dimen/ten_dp</item>
        <item name="shadowLibSpread">@dimen/ten_dp</item>
    </style>

Warning kotlin extensions won't work correctly for views which are put into ShadowLayout by injection, because ShadowLayout takes id of original view. Please use Activity.findShadowedView(@IdRes id: Int) or View.findShadowedView(@IdRes id: Int)

Known Problems

Kotlin extensions views don't work correctly when using ViewPump injection
View will be larger than on preview because of added padding (to show shadow) when using ViewPump incjection

maciekczwa/shadowlib