Animated Views Form

Android librarie that allows you to easily find and animate child views from one or multiple ViewGroups using their tag, type, visibility and much more.

Description

ViewsFrom is an android librarie that allows you to easily find and animate child views from one or multiple ViewGroups using their tag, type, visibility and much more. This librairie is Android 14+ compatible.

This library is update for Jaouan's ViewForms Library https://github.com/Jaouan/ViewsFrom

Programming language: Java

License: Apache License 2.0

Tags: UI     Android     Animations     Java     Views     Android-library    

Latest version: v1.1.1

README

ViewsFrom is an android librarie that allows you to easily find and animate child views from one or multiple ViewGroups using their tag, type, visibility and much more. This librairie is Android 14+ compatible.

This library is update for Jaouan's ViewForms Library https://github.com/Jaouan/ViewsFrom

[demo](art/demo.gif)

Installation

Gradle

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

    dependencies {
            implementation 'com.github.MGRagab:AnimatedViewsForm:VERSION'
    }

Usage

Use Views class as entry point, and let the librarie guides you.

First example : Animate all visible views from rootView.

Views.from(rootView)
     .withVisibility(View.VISIBLE)
     .animateWith(context, R.anim.my_awesome_animation)
     .start();

Second example : Show all EditText with tags "example" from two group views.

Views.from(myFirstLinearLayout, mySecondLinearLayout)
     .withType(EditText.class)
     .withTag("example")
     .forEach((view, index, count) -> {
       view.setVisibility(View.VISIBLE);
     });

A bit more complete example that shows what you can do :

// Defines root views of your views finder.
Views.from(groupView1 /*, groupView2, ...*/)

     // Basics filters.
     .withTag("abc" /*, "efg", ...*/)
     .withTagRegex("[a-z]*" /*, "anotherRegex", ...*/)
     .withId(R.id.my_wonderful_id,  /*, R.id.my_another_id, ...*/)
     .withType(TextView.class /*, EditText.class, ...*/)
     .withVisibility(View.GONE /*, View.INVISIBLE, ...*/)

      // Negate "with*" filters by prefixing with "not" method.
      not().withId(R.id.one_more_id /*, R.id.gimme_more_id*/)

      // Custom filter.
     .filteredWith((view) -> {
       return /* your own filter */;
     })

     // Exclude views.
     .excludeView(myView1 /*, myViews2, ... */)

     // Options.
     .includingFromViews()
     .excludingChildsFromFilteredGroupViews()

     // Concate with a new views finder, with its own filters and options.
     .andFrom(group2)
     .withTag("xyz")

     // Order views.
     .orderedBy((view1, view2) -> {
       return /* your own comparator */;
     }

     // And animate them all !
     .animateWith(context, R.anim.my_awesome_animation)
     .withDelayBetweenEachChild(250)
     .withViewsVisibilityBeforeAnimation(View.INVISIBLE)
     .withEndAction(() -> {
       Log.i("ViewsFromLibExample", "It's finally over.");
     })
     .start();

You have 3 end points : Find, iterate and animate.

Find

Returns a views list.

Views.from(groupView)
     .find();

Iterate

Iterates all views.

Views.from(groupView)
     .forEach((view, index, count) -> {});

Animate

Views.from(groupView)
     .animateWith(() -> {
       return /* your animation instance */;
     })
     // or
     // .animateWith(context, R.anim.my_awesome_animation)
     .withDelayBetweenEachChild(250)
     .withViewsVisibilityBeforeAnimation(View.INVISIBLE)
     .withEndAction(() -> {})
     .start();

Views animator

If you know which views has to be animated, you can still use ViewsAnimator as below :

new ViewsAnimator(context, viewsIWantToAnimate, R.anim.my_smooth_animation)
     .withDelayBetweenEachChild(250)
     .withViewsVisibilityBeforeAnimation(View.INVISIBLE)
     .withEndAction(() -> {})
     .start();

ViewsAnimator's start() method can be called multiple times if you want.

// First call.
ViewsAnimator viewsAnimator = Views.from(groupView)
     .animateWith(context, R.anim.my_awesome_animation)
     .start();

// Second call.
myButton.setOnClickListener((view) -> {
  viewsAnimator.start();
});

Note

Be aware that when an end point is called, every child views are iterated in order to find which satisfies filters. If your layout is very complex, prefer using multiple little group views instead of one big root view.

License

[Apache License Version 2.0](LICENSE)