ShadowLayout Android Library

ShadowLayout is a versatile layout component that allows any View to enjoy customizable shadows and system-level shape/selector functionality without needing extra drawable files.

Shadow Customization:

• Modify shadow color values.
• Set uniform or individual corner radii.
• Adjust X and Y offsets.
• Control shadow diffusion (size).
• Hide shadows on specific sides or completely.
• Dynamically modify shadows via code.

Shape and Selector Features:

• Supports pressed, selected, and ripple states.
• Background color and stroke (border) settings.
• Gradient background support.
• Clickable/non-clickable state backgrounds.
• Binding to TextView to react to text or color changes.
• Support for image backgrounds and image selectors.
• View clipping (useful for players or custom rounded corners).

When using ShadowLayout, be aware of the following version-specific changes:

• v3.0+: Significant changes to APIs and naming conventions. If you are migrating from v2.0, refer to the ShadowLayout 2.0 documentation.
• v3.4.0+: Fully compatible with AndroidX.
• v3.4.1+: Includes support for SmartLoadingView.

To use ShadowLayout in your Android project, add the JitPack repository to your project-level build.gradle and the dependency to your app-level build.gradle.

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

// App build.gradle
dependencies {
    implementation 'com.github.lihangleo2:ShadowLayout:2.1.8'
}

Follow these steps to import shadowLibrary as a local module and configure the Glide version:

1. Download the demo project and open it in Android Studio.
2. Go to File -> New -> Import Module.
3. Select the shadowLibrary folder and click Finish.
4. In your app's build.gradle file, add the following dependency:

   implementation project(':shadowLibrary')

5. Open the build.gradle file located inside the shadowLibrary module and update the Glide version to match your project's version.

If you encounter Glide version conflicts when using ShadowLayout, integrate the project as a module instead of a remote dependency. This allows you to manually override the Glide version used by the library to match your project's requirements.

Note: If you upgrade to a significantly newer version of Glide, you may need to update the Glide loading methods within GlideRoundUtils inside the shadowLibrary module to maintain compatibility.

To use SmartLoadingView in a standard workflow (like a follow button), set up the view in XML and control the loading state via code.

1. Start loading: Call startLoading() when the user clicks the button to initiate the loading animation.
2. Finish successfully: Call finishLoading() (or finishLoading(true)) when the network request succeeds.
3. Finish with failure: Call finishLoading(false) when the network request fails.

To use ShadowLayout in your Android project, follow these two steps:

1. Add the JitPack repository to your project-level build.gradle:

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

2. Add the dependency to your app-level build.gradle. Use the AndroidX version for modern projects:

dependencies {
    // AndroidX version
    implementation 'com.github.lihangleo2:ShadowLayout:3.4.5'

    // Non-AndroidX version
    // implementation 'com.github.lihangleo2:ShadowLayout:3.3.3'
}

Use the app:hl_button_type attribute in XML to define the animation behavior of the SmartLoadingView.

Available modes:

• smart_full_screen: Full-screen diffusion animation for page transitions (does not support 'follow/unfollow' logic).
• smart_button: Standard button animation (supports follow/unfollow logic).
• smart_tick: TikTok-style checkmark animation (supports follow/unfollow).
• smart_tick_hide: Checkmark animation followed by hiding the button (supports follow/unfollow).
• smart_tick_center_hide: Checkmark animation, hiding, and then moving to the center of the screen (supports follow/unfollow).

app:hl_button_type="smart_button"

If you are using version 3.2.4 and encounter dependency errors caused by JitPack/Gradle 7.0 compatibility issues, you must use the specific release suffix 3.2.4rz to resolve the issue. Alternatively, upgrading to version 3.3.2 or higher is recommended as the fix is included in those versions.

implementation 'com.github.lihangleo2:ShadowLayout:3.2.4rz'

Wrap your target view with com.lihang.ShadowLayout to apply customizable shadows. The layout supports corner radius, shadow color, background color, and shadow spread (limit).

<com.lihang.ShadowLayout
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:hl_cornerRadius="18dp"
    app:hl_shadowColor="#2aff0000"
    app:hl_shadowBackColor="#fff"
    app:hl_shadowLimit="5dp">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="36dp"
        android:paddingLeft="10dp"
        android:paddingRight="10dp"
        android:gravity="center"
        android:text="定制化你的阴影"
        android:textColor="#000" />

</com.lihang.ShadowLayout>