A tool that facilitates working with Spans on TextViews or any extension of them (EditTexts, Buttons...).
Switch branches/tags
Nothing to show
Clone or download
José Manuel Pereira García José Manuel Pereira García
José Manuel Pereira García and José Manuel Pereira García Add support to minSdkVersion 9
Latest commit a12183b May 12, 2015
Permalink
Failed to load latest commit information.
gradle/wrapper
library
sample Add support to minSdkVersion 9 May 11, 2015
.gitignore
README.md
Screenshot.png
build.gradle
gradle.properties
gradlew
gradlew.bat First Commit Feb 13, 2015
settings.gradle

README.md

AwesomeText

Android Arsenal

Hex.pm Platform

Download

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

Download

Download via Gradle:

    dependencies {
        compile 'com.jmpergar:AwesomeText:1.0.0'
    }

Or via Maven:

    <dependency>
        <groupId>com.jmpergar</groupId>
        <artifactId>AwesomeText</artifactId>
        <version>1.0.0</version>
        <type>aar</type>
    </dependency>

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.

    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.

    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.

    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

Follow me on Twitter Add me to Linkedin

Who's using it

Does your app use AwesomeText? If you want to be featured on this list drop me a line.

Contributors

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.