This project is based on the original work of Robinhood Markets, Inc., licensed under the Apache License, Version 2.0.
The following changes have been made by The Plant:
- 2024-12-19: Support animate unchanged lower characters.
- 2024-12-20: Support baseline alignment.
For the original project, see [https://github.com/robinhood/ticker].
There are some breaking API changes introduced in ticker 2.0. Please refer to the 2.0 migration doc.
Ticker is a simple Android UI component for displaying scrolling text. Think about how an odometer scrolls when going from one number to the next, that is similar to what Ticker does. The Ticker handles smooth animations between strings and also string resizing (e.g. animate from "9999" to "10000").
You can specify how the animations proceed by defining an array of characters in order. Each character displayed by Ticker is controlled by this array which dictates how to animate from a starting character to a target character. For example, if you just use a basic ASCII character list, when animating from 'A' to 'Z', it will go from 'A' -> 'B' -> ... 'Z'. We will perform wrap-around animation when it's faster (e.g. 'Z' to 'A' will just animate 'Z' -> 'A').
Step 1. Add the JitPack repository to your root build.gradle.
repositories {
maven { url 'https://jitpack.io' }
}
Step 2. Add the ticker dependency to your build.gradle.
implementation 'com.github.theplant:ticker:Tag'Define the TickerView in XML:
<com.robinhood.ticker.TickerView
android:id="@+id/tickerView"
android:layout_width="wrap_content"
android:layout_height="wrap_content" />Then add the character array to specify the animation style:
final TickerView tickerView = findViewById(R.id.tickerView);
tickerView.setCharacterLists(TickerUtils.provideNumberList());That's it! Now you can call setText to display your data.
We currently support a fairly limited subset of customizations at the moment so please let us know what new features / APIs you need exposed for your use-case and we'll consider it for future releases (or of course feel free to fork!).
You can customize the looks and feels of the TickerView via XML:
android:gravity="center"
android:textColor="@color/colorPrimary"
android:textSize="16sp"
app:ticker_animationDuration="1500"
app:ticker_preferredScrollingDirection="any"
app:ticker_animateUnchangedLowerCharacters="true"Or Java:
tickerView.setTextColor(textColor);
tickerView.setTextSize(textSize);
tickerView.setTypeface(myCustomTypeface);
tickerView.setAnimationDuration(500);
tickerView.setAnimationInterpolator(new OvershootInterpolator());
tickerView.setGravity(Gravity.START);
tickerView.setPreferredScrollingDirection(TickerView.ScrollingDirection.ANY);
tickerView.setAnimateUnchangedLowerCharacters(true);For the full list of XML attributes that we support, please refer to the attrs file.
We decided to extend from the base View class and achieve everything by drawing directly
onto the canvas. The primary benefit from this is having full flexibility and control over
memory allocations and minimize performance impact by using native draw operations. We
pre-allocate and pre-compute as much as possible for each transition so that the only thing
we need to do in the draw path is perform the actual drawing operations. The performance test
UI included in the ticker-sample
is a bit over-zealous but animates smoothly with a screen full of tickers.
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.