pulse-indicator
An Android system for indicating Views with fading pulses
Installation
repositories {
mavenCentral()
}
dependencies {
compile('com.jackpocket:pulse-indicator:2.0.0')
}
Usage
Layout Approach
Make the root of your Activity's layout one of the base PulseLayouts included in this library: the PulsingLinearLayout or the PulsingRelativeLayout. e.g.
<com.jackpocket.pulse.layouts.PulsingLinearLayout
...
>Then find it in your Activity and simply call PulseLayout.attachTo(Activity, View). Done. e.g.
((PulseLayout) findViewById(R.id.my_pulsing_layout))
.attachTo(this, findViewById(R.id.some_view_I_want_to_indicate);PulseView Approach
Just add a PulseView to your layout (make sure you're using a ViewGroup that allows overlapping children (e.g. RelativeLayout)).
<RelativeLayout>
<com.jackpocket.pulse.layouts.PulseView
android:layout_width="match_parent"
android:layout_height="match_parent"
... />
</RelativeLayout>You could then use it the same way you would going the Layout Approach mentioned above.
Custom Approach
If you want to add pulsing to your own custom layouts, just checkout one of the supplied layout class files for detailed information on how to implemented the PulsingController manually.
Changing the values at runtime can also be configured by working with the PulseController:
((PulseLayout) findViewById(R.id.my_pulsing_layout))
.getPulseController()
.setCirclePathOverride(false) // Set it to use the rectangular boundaries instead of circle pulsing
.setPulsingColor(0xFF22FF22) // Set the pulse starting color
.setPulsingStrokeWidth(10) // Override the dynamic stroke width with a custom one
.setDurationMs(1500) // Set the overall duration of the pulsing (will continue until no pulses exist)
.setPulseLifeSpanMs(900) // The length of time a pulse is visible
.setRespawnRateMs(300) // The rate at which a new pulse should be added
.setAlphaInterpolator(new AccelerateInterpolator()) // Set the Interpolator for the alpha animation
.setScaleInterpolator(new LinearInterpolator()) // Set the Interpolator for the scaling animation
// Set a callback to be triggered when the pulsing finished for a View.
// Calling attach() or stopPulsing() before it completes will prevent it from being triggered.
// The supplied PulseEventListener is weakly held by the PulseController.
.setFinishedListener(this)
// Attach the configured controller to the target and start pulsing
.attachTo(this, findViewById(R.id.some_view_I_want_to_indicate)); Configs
The default configs for pulsing color, duration, individual lifespan, respawn rates can be overwritten via the following, respectively:
R.color.pulse__color
R.integer.pulse__duration_default
R.integer.pulse__lifespan_default
R.integer.pulse__respawn_rate_default
Note, all time values are in milliseconds.
Moved to MavenCentral
As of version 2.0.0, pulse-indicator will be hosted on MavenCentral. Versions 1.1.0 and below will remain on JCenter.