Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robinhood/ticker
An Android text view with scrolling text change animation
https://github.com/robinhood/ticker
android android-animation android-ui
Last synced: 1 day ago
JSON representation
An Android text view with scrolling text change animation
- Host: GitHub
- URL: https://github.com/robinhood/ticker
- Owner: robinhood
- License: apache-2.0
- Created: 2016-07-15T21:37:52.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-11-23T18:03:23.000Z (about 1 year ago)
- Last Synced: 2024-12-04T20:58:39.306Z (9 days ago)
- Topics: android, android-animation, android-ui
- Language: Java
- Homepage: https://medium.com/robinhood-engineering/hello-ticker-20eaf6e51689
- Size: 1.6 MB
- Stars: 4,388
- Watchers: 83
- Forks: 464
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-github-android-ui - ticker - 显示滚动文本 (TextView)
README
Migrating to version 2
======================
There are some breaking API changes introduced in ticker 2.0. Please refer to the
[2.0 migration doc](https://github.com/robinhood/ticker/blob/master/2_0_migration.md).
What is Ticker?
===============
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').
Getting started
---------------
Add the ticker dependency to your `build.gradle`.
```groovy
implementation 'com.robinhood.ticker:ticker:2.0.4'
```
Usage
-----
Define the `TickerView` in XML:
```xml
```
Then add the character array to specify the animation style:
```java
final TickerView tickerView = findViewById(R.id.tickerView);
tickerView.setCharacterLists(TickerUtils.provideNumberList());
```
That's it! Now you can call `setText` to display your data.
Customization
-------------
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:
```xml
android:gravity="center"
android:textColor="@color/colorPrimary"
android:textSize="16sp"
app:ticker_animationDuration="1500"
app:ticker_preferredScrollingDirection="any"
```
Or Java:
```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);
```
For the full list of XML attributes that we support, please refer to the
[attrs](https://github.com/robinhood/ticker/blob/master/ticker/src/main/res/values/attrs.xml) file.
Performance
-----------
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](https://github.com/robinhood/ticker/tree/master/ticker-sample)
is a bit over-zealous but animates smoothly with a screen full of tickers.
License
=======
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.