JumpingBeans Android Library

To use JumpingBeans in your Android project, ensure jcenter() is included in your root build.gradle file, then add the dependency to your module's build.gradle.

// In root build.gradle
allprojects {
    repositories {
        jcenter()
    }
}

// In module build.gradle
dependencies {
    compile 'net.frakbot:jumpingbeans:1.3.0'
}

To avoid resource waste and unexpected behavior, follow these rules:

• Do not change text in the TextView before calling stopJumping(); this causes unnecessary invalidation and wasted resources.
• Do not reuse the same animation on a different view; create a new JumpingBeans instance for every view.
• Do not use multiple instances on a single TextView; calling cleanup on one will affect all others on that view.
• Avoid large text blocks; the library is optimized for small views with a few words. Large text can cause expensive relayouts.
• Do not use attributes that strip Spans, such as textAllCaps.

You can emulate the Hangouts-style typing indicator by appending three jumping dots to a TextView. This method automatically handles the trailing ... (either by using existing dots or appending them).

final TextView textView1 = (TextView) findViewById(R.id.jumping_text_1);
jumpingBeans1 = JumpingBeans.with(textView1)
        .appendJumpingDots()
        .build();

You can animate a specific range of characters within a TextView. You can choose to animate them as a single block or as a wave.

final TextView textView2 = (TextView) findViewById(R.id.jumping_text_2);
jumpingBeans2 = JumpingBeans.with(textView2)
        .makeTextJump(0, textView2.getText().toString().indexOf(' '))
        .setIsWave(false)
        .setLoopDuration(1000)  // ms
        .build();

Use the JumpingBeans.Builder to fine-tune the animation behavior:

• setIsWave(boolean): Set whether the animation follows a wave pattern.
• setLoopDuration(int): Set the duration of the animation loop in milliseconds.
• setWavePerCharDelay(int): Set the delay between characters in a wave animation.
• setAnimatedDutyCycle(float): Adjust the pause duration between jumping cycles.