Popularity
0.4
Stable
Activity
0.0
Stable
2
2
0

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

Animated Views Form alternatives and similar packages

Based on the "Animations" category.
Alternatively, view Animated Views Form alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Animated Views Form or a related project?

Add another 'Animations' Package

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)


*Note that all licence references and agreements mentioned in the Animated Views Form README section above are relevant to that project's source code only.