Sparkline: a very small line chart, typically drawn without axes or coordinates. It presents the general shape of the variation (typically over time) in some measurement, such as temperature or stock market price, in a simple and highly condensed way.
-- en.wikipedia.org/wiki/Sparkline
Spark is a simple Android library that takes a series of x,y points at any scale and draws them as a sparkline chart.
Spark is setup with reasonable default values out of the box. Just add a SparkView
to your layout:
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<com.robinhood.spark.SparkView
android:id="@+id/sparkview"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
Then, just give it a SparkAdapter
to graph your data:
SparkView sparkView = (SparkView) findViewById(R.id.sparkview);
sparkView.setAdapter(new MyAdapter(data));
...
public class MyAdapter extends SparkAdapter {
private float[] yData;
public MyAdapter(float[] yData) {
this.yData = yData;
}
@Override
public int getCount() {
return yData.length;
}
@Override
public Object getItem(int index) {
return yData[index];
}
@Override
public float getY(int index) {
return yData[index];
}
}
See spark-sample for a complete sample app.
Spark is very theme-friendly! It has default styles set for you, and welcomes any overrides:
In your Activity
/Fragment
/View
:
sparkView.setLineColor(getColor(R.color.brand_color_primary));
In your layout xml:
<com.robinhood.spark.SparkView
android:id="@+id/sparkview"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:spark_lineColor="@color/brand_color_primary"/>
Set a default style for all SparkView
s in your app's theme:
<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="spark_SparkViewStyle">@style/MySparkViewStyle</item>
</style>
<style name="MySparkViewStyle" parent="@style/spark_SparkView">
<item name="spark_lineColor">@color/line_color</item>
<item name="spark_lineWidth">@dimen/line_width</item>
<item name="spark_cornerRadius">@dimen/corner_radius</item>
<item name="spark_fill">false</item>
<item name="spark_baseLineColor">@color/base_line_color</item>
<item name="spark_baseLineWidth">@dimen/base_line_width</item>
<item name="spark_scrubLineColor">@color/scrub_line_color</item>
<item name="spark_scrubLineWidth">@dimen/scrub_line_width</item>
<item name="spark_scrubEnabled">true</item>
<item name="spark_animateChanges">true</item>
</style>
</resources>
Scrubbing is when the user taps and drags their finger along the sparkline chart. It is very useful to display additional detail information about the point the user is currently scrubbing over.
Enable scrubbing via xml:
<com.robinhood.spark.SparkView
...
app:spark_scrubEnabled="true" />
or programatically:
sparkView.setScrubEnabled(true);
and then add a SparkView.OnScrubListener
to get callbacks:
sparkView.setScrubListener(new SparkView.OnScrubListener() {
@Override
public void onScrubbed(Object value) {
scrubInfoTextView.setText(getString(R.string.scrub_format, value));
}
});
It's frequently useful to show a "base line" against which the rest of the sparkline chart will be
compared. Simply return this value from your SparkAdapter
s getBaseline()
method.
Spark assumes that your graph's points are evenly distributed across the x-axis. If that's not true,
just override getX(int index)
in your SparkAdapter
to give SparkView
the correct value.
To animate path changes, set app:spark_animateChanges="true"
or call sparkView.setAnimateChanges(true);
.
Spark is a very simple library and cannot possibly meet everyone's use-cases. A more robust charting library (such as MP Android Chart) may be a better fit if you're looking for things like axes or advanced touch gestures. Spark aims to be lightweight alternative for showing simple sparklines. Spark will prioritize simplicity over new use-cases the vast majority of the time.
Gradle:
compile 'com.robinhood.spark:spark:1.1.0'
Copyright 2016 Robinhood Markets, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.