Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JMPergar/AwesomeText
A tool that facilitates working with Spans on TextViews or any extension of them (EditTexts, Buttons...).
https://github.com/JMPergar/AwesomeText
List: AwesomeText
Last synced: 9 days ago
JSON representation
A tool that facilitates working with Spans on TextViews or any extension of them (EditTexts, Buttons...).
- Host: GitHub
- URL: https://github.com/JMPergar/AwesomeText
- Owner: JMPergar
- Created: 2015-02-11T15:51:35.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2015-11-03T14:34:12.000Z (about 9 years ago)
- Last Synced: 2024-05-21T16:09:47.247Z (6 months ago)
- Language: Java
- Homepage:
- Size: 503 KB
- Stars: 674
- Watchers: 28
- Forks: 74
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AwesomeText
[](https://android-arsenal.com/details/1/1554) [](http://androidweekly.net/issues/issue-141)
[](http://www.apache.org/licenses/LICENSE-2.0) [](http://developer.android.com/index.html)
[ ](https://bintray.com/jmpergar/maven/AwesomeText/_latestVersion)
Working with Spans is ugly and difficult to manage, it's like working with a goblin of Moria. Don't understand the Spans? With AwesomeText you will only have to work with the classic Adapter Pattern. All the ease and potential of a pattern you already know how to use.
Screenshots
-----------
![Demo Screenshot][1]
Download
--------
Download via Gradle:
```groovy
dependencies {
compile 'com.jmpergar:AwesomeText:1.0.0'
}
```
Or via Maven:
```xml
com.jmpergar
AwesomeText
1.0.0
aar
```
Usage
-----
On the same way that you working with ListAdapter, you must implement an interface to delegate the creation of the view, in this case AwesomeTextHandler.ViewSpanRenderer interface. The method getView is the responsible of this.
```java
public class HashtagsSpanRenderer implements AwesomeTextHandler.ViewSpanRenderer {
@Override
public View getView(String text, Context context) {
LayoutInflater inflater = LayoutInflater.from(context);
TextView hashtagView = inflater.inflate(R.layout.hashtag);
hashtagView.setText(text);
return hashtagView;
}
}
```
If you want to manage click events only must to implement AwesomeTextHandler.ViewSpanClickListener.
```java
public class MentionSpanRenderer implements AwesomeTextHandler.ViewSpanRenderer, AwesomeTextHandler.ViewSpanClickListener {
@Override
public View getView(String text, Context context) {
LayoutInflater inflater = LayoutInflater.from(context);
TextView mentionView = inflater.inflate(R.layout.mention);
mentionView.setText(text);
return mentionView;
}
@Override
public void onClick(String text, Context context) {
Toast.makeText(context, "Hello " + text, Toast.LENGTH_SHORT).show();
}
}
```
And finally you configure AwesomeTextHandler to view the changes. Now, when you call AwesomeTextHandler.setText the change will be rendered automatically.
```java
public class MainActivity extends ActionBarActivity {
private static final String HASHTAG_PATTERN = "(#[\\p{L}0-9-_]+)";
private static final String MENTION_PATTERN = "(@[\\p{L}0-9-_]+)";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
TextView textView = (TextView) findViewById(R.id.textview);
EditText editText = (EditText) findViewById(R.id.editText);
AwesomeTextHandler awesomeTextViewHandler = new AwesomeTextHandler();
awesomeTextViewHandler
.addViewSpanRenderer(HASHTAG_PATTERN, new HashtagsSpanRenderer())
.addViewSpanRenderer(MENTION_PATTERN, new MentionSpanRenderer())
.setView(textView);
AwesomeTextHandler awesomeEditTextHandler = new AwesomeTextHandler();
awesomeEditTextHandler
.addViewSpanRenderer(HASHTAG_PATTERN, new HashtagsSpanRenderer())
.addViewSpanRenderer(MENTION_PATTERN, new MentionSpanRenderer())
.setView(editText);
}
}
```
Developed By
------------
* José Manuel Pereira García -
Who's using it
--------------
* [Redbooth][2]
*Does your app use AwesomeText? If you want to be featured on this list drop me a line.*
Contributors
------------
* [José Manuel Pereira García][3]
License
-------
Copyright 2015 José Manuel Pereira García
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.
[1]: https://raw.githubusercontent.com/JMPergar/AwesomeText/master/Screenshot.png
[2]: https://redbooth.com
[3]: https://github.com/JMPergar