| Setup Guide | Report new issue

ComposeFadingEdges

The ComposeFadingEdges is a powerful Android Compose library that seamlessly incorporates customisable fading edges with horizontal or vertical orientations, static or scrollable content, clip or color draw.

Features:

• Multiple Modifiers: Add fading edges with custom orientation, gravity, length, content and fill type.
• Scrolls States: Ready for ScrollState, LazyListState, LazyGridState, LazyStaggeredGridState.
• Scrolling Settings: Configure fading edges scroll behavior with dynamic, full, or static settings.
• Text Marquee: Easily add fading edges to text marquee with automatic layout alignment.
• Adjustable Fade: Choose between fade clip or fade color fill types for fading edges.
• Sample App: Explore and experiment with sample app.

Sample App

Sample 1	Sample 2	Sample 3

Download or clone this repository to discover the sample app.

Setup

Add to the root settings.gradle.kts:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

Add to the package build.gradle.kts:

dependencies {
    implementation("com.github.GIGAMOLE:ComposeFadingEdges:{latest-version}")
}

Latest version: .

Also, it's possible to download the latest artifact from the releases page.

Guide

The ComposeFadingEdges comes with multiple Modifiers: Modifier.horizontalFadingEdges(...) , Modifier.verticalFadingEdges(...), etc.

For more technical and detailed documentation, read the library KDoc.

Fading Edges Modifiers

The fading edges Modifiers are available for different content orientation and type.

In case, contentType is not provided, the FadingEdgesContentType equals to Static.

The ComposeFadingEdges also provides fading edges for text marquee.

FadingEdgesContentType

The FadingEdgesContentType can be Static or Dynamic.

The Dynamic content sub-type can be the following:

• Scroll: The dynamic fading edges for a ScrollState content.
• Lazy.List: The dynamic fading edges for a LazyListState content.
• Lazy.Grid: The dynamic fading edges for a LazyGridState content.
• Lazy.StaggeredGrid: The dynamic fading edges for a LazyStaggeredGridState content.

The Dynamic content type requires FadingEdgesScrollConfig.

FadingEdgesScrollConfig

The FadingEdgesScrollConfig can be Dynamic, Full or Static.

All of them can configure fading edges scroll based offset animationSpec.

The Dynamic configuration comes with additional params:

FadingEdgesFillType

The FadingEdgesFillType can be FadeClip or FadeColor.

The fading edges fill gradient is automatically faded from max alpha to min alpha.

All of them can configure fading edges fill gradient fillStops and secondStopAlpha.

The FadeClip type clips the content with the fading edges fill gradient.

The FadeColor type requires a color param and draws the fading edges fill gradient over the content.

Modifier.marqueeHorizontalFadingEdges

The utility Modifier to add fading edges to the text marquee (custom or default basicMarquee).

This Modifier comes with common fading edges params and a few additional params:

License

MIT License. See the LICENSE file for more details.

Credits

Special thanks to the GoDaddy for the amazing color picker library.

Author:

Basil Miller
[email protected]