Android Social UI

Android Social UI is a library of android widgets that work well for social apps.

SocialTextView

A SocialTextView is a standard android TextView with callbacks to handle the onClicks of #hashtags @mentions, email@domain.com and https://weblinks.com/.

You can use it in any XML file just as you would a normal TextView:

<com.carrotcreative.socialui.widget.SocialTextView
    android:id="@+id/social_text_example"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="This view handles #hashtags, @mentions, and https://weblinks.com/"
    />

Next you'll want to create a SocialActionHandler or a SocialActionCallback. This is the thing that defines how to handle the onClicks of each type.

SocialActionHandler mHandler = new SocialActionHandler() {
    @Override
    public void handleHashtag(String hashtag)
    {
        Toast.makeText(SignUpActivity.this, "Hashtag: " + hashtag, Toast.LENGTH_LONG).show();
    }

    @Override
    public void handleMention(String mention)
    {
        Toast.makeText(SignUpActivity.this, "Mention: " + mention, Toast.LENGTH_LONG).show();
    }

    @Override
    public void handleUrl(String url)
    {
        Toast.makeText(SignUpActivity.this, "URL: " + url, Toast.LENGTH_LONG).show();
    }
});

The last thing you have to do for the SocialTextView is to set it's SocialActionHandler to the one you've just created.

socialTextView = (SocialTextView) findViewById(R.id.social_text_example);
socialTextView.linkify(mHandler);

If you update the text in a SocialTextView, be sure to also call linkify() again to ensure all elements become clickable.

socialTextView.setText("Hello #World");
socialTextView.linkify(mHandler);

You can also use SocialActionCallback, if you need to handle any one of the callbacks.

socialTextView.linkify(new SocialActionCallback()
{
    @Override
    public void onMatch(int type, String value)
    {
        if(type == SocialActionType.EMAIL)
        {
            Toast.makeText(getApplicationContext(), value, Toast.LENGTH_SHORT).show();
        }
    }
});

After this is done, the SocialTextView will display highlighted/underlined hashtags, mentions, and weblinks that are clickable and will be handled by their appropriate method.

License

Android Social UI is licensed under MIT