Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rosenpin/fading-text-view
A TextView that changes its content automatically every few seconds
https://github.com/rosenpin/fading-text-view
android android-library animation textview
Last synced: 1 day ago
JSON representation
A TextView that changes its content automatically every few seconds
- Host: GitHub
- URL: https://github.com/rosenpin/fading-text-view
- Owner: rosenpin
- Created: 2016-12-08T17:30:56.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-12-29T16:56:35.000Z (about 1 year ago)
- Last Synced: 2025-01-05T02:56:41.556Z (8 days ago)
- Topics: android, android-library, animation, textview
- Language: Kotlin
- Homepage:
- Size: 939 KB
- Stars: 1,739
- Watchers: 36
- Forks: 222
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
- awesome-github-android-ui - FadingTextView - 自动改变其内容的TextView (TextView)
README
# FadingTextView
[](https://jitpack.io/#rosenpin/fading-text-view)
A TextView that changes its content automatically every few seconds
## Usage
### Download
FadingTextView is available on [JitPack](https://jitpack.io/#rosenpin/fading-text-view/3.3)
Step 1. Add the JitPack repository to your root build.gradle
``` gradle
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
```
Step 2. Add the dependency
``` gradle
dependencies {
implementation 'com.github.rosenpin:fading-text-view:3.3'
}
```
### Texts
First, you need to create a string-array in your values folder like so:
``` xml
Hello
Fading TextView
```
Then in your layout
``` xml
```
### Timeout
You can set the amount of time that each text is visible by using the timeout attribute and by specifying the length of time in milliseconds. Like so:
``` xml
app:timeout="500"
```
``` xml
```
### Updating the view dynamically - Kotlin
To set the text dynamically, you can use
```kotlin
val texts = arrayOf("text1", "text2", "text3")
val fadingTextView = findViewById(R.id.fadingTextView)
fadingTextView.setTexts(texts) // You can use an array resource or a string array as the parameter
//fadingTextView.setTexts(R.array.examples)
```
To set the timeout between text changes you can use:
```kotlin
//For text change once every hour
fadingTextView.setTimeout(60.minutes)
//For text change once every half a minute
fadingTextView.setTimeout(0.5.minutes)
//For text change every 10 seconds
fadingTextView.setTimeout(10.seconds)
//For text change every 500 milliseconds (0.5 seconds)
fadingTextView.setTimeout(500.milliseconds)
```
Or you can shuffle texts that you set
```kotlin
fadingTextView.shuffle()
```
### Updating the view dynamically - JAVA
To set the text dynamically, you can use
```java
String[] texts = {"text1","text2","text3"};
FadingTextView FTV = (FadingTextView) findViewById(R.id.fadingTextView);
FTV.setTexts(texts); //You can use an array resource or a string array as the parameter
```
To set the timeout between text changes you can use:
```java
//For text change once every hour
FTV.setTimeout(60, MINUTES);
//For text change once every half a minute
FTV.setTimeout(0.5, MINUTES);
//For text change every 10 seconds
FTV.setTimeout(10, SECONDS);
//For text change every 500 milliseconds (0.5 seconds)
FTV.setTimeout(500, MILLISECONDS);
```
### Shuffle
You can randomize the order of the strings using the `shuffle` method\
Note: you will need to run the `shuffle` method after each time you update the view\
Example:
```
FTV.setTexts(texts);
FTV.shuffle();
```
## Full Documentation
[Click me](https://rosenpin.github.io/fading-text-view/) for the full documentation
## License
```
Copyright (c) Tomer Rosenfeld 2016-2017
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.
```