Add custom, click, url spans

Author: neworld

CHANGELOG.md

@@ -0,0 +1,5 @@
+### v0.2
+
+- New span support: `click`, `url`, `custom`
+- Function to apply spans on existing text: `span()` 
+- Fixed replace in multiple occurrences text

README.md

@@ -4,7 +4,7 @@ This lib provides simple and fluent API for creating [Android Spannable](https:/
 Features:
 - Simple and fluent API
 - Helpers to create spans
-- Small method footprint (<100 methods, 6kb AAR package)
+- Small method footprint (<100 methods, 16kb AAR package)
 
 This library focuses on building spannable. 
 If you prefer put full text first and then apply spans, take a look at [another awesome library](https://github.com/jaychang0917/SimpleText)
@@ -29,16 +29,48 @@ Spannable spannable = new Spanner()
         .append("superscript\n", superscript())
         .append(" \n", image(getResources().getDrawable(R.drawable.ic_android_16dp)))
         .append("quite\n", quote())
-        .append("The quick brown fox jumps over the lazy dog\n", bold(), foreground(0xFF904f1c), quote())
+        .append("The quick brown fox jumps over the lazy dog\n", bold(), foreground(0xFF904f1c), Spans.quote())
+        .append("Custom\n", custom(new CustomSpan()))
+        .append("Click here\n", click(onClickListener))
+        .append("http://www.android.com\n", url("http://www.android.com"))
         ;
 ```
+Here is more methods to work with text:
+```java
+Spannable spannable = new Spanner("The quick brown fox jumps over the lazy dog")
+        .span("fox", foreground(Color.RED)) // search and span by given text
+        .replace("dog", "cat", strikeThrough()) // any number of spans
+        .insert(5, "foo", bold(), italic()) // any number of spans
+        .append("bar", underline()); // any number of spans
+```
 
+You can use `span` to apply spans on the existing text:
 ```java
 Spannable spannable = new Spanner("The quick brown fox jumps over the lazy dog")
-        .replace("dog", "cat", strikeThrough() /* any number of spans */)
-        .insert(5, "foo", bold(), italic() /* any number of spans */)
-        .append("bar", underline() /* any number of spans */);
+        .span("fox", foreground(Color.RED))
+        .span("dog", foreground(Color.BLUE));
+```
+
+If you need custom span, you have to use builder:
 ```
+//java 7
+Spannable spannable = new Spanner("The quick brown fox jumps over the lazy dog")
+        .span("fox", custom(new SpanBuilder() {
+                 @Override
+                 public Object build() {
+                     return new StyleSpan(Typeface.ITALIC);
+                 }
+             });
+             
+//java 8
+Spannable spannable = new Spanner("The quick brown fox jumps over the lazy dog")
+        .span("fox", custom(() -> new StyleSpan(Typeface.ITALIC));
+        
+//kotlin
+val spannable = Spanner("The quick brown fox jumps over the lazy dog")
+        .span("fox", custom { StyleSpan(Typeface.ITALIC) })
+```
+
 #### How to use
 ```
     allprojects {
@@ -49,7 +81,7 @@ Spannable spannable = new Spanner("The quick brown fox jumps over the lazy dog")
     }
 	
     dependencies {
-        compile 'lt.neworld:spanner:v0.1'
+        compile 'lt.neworld:spanner:v0.2'
     }
 ```
 

lib/src/main/java/lt/neworld/spanner/Spans.java

@@ -9,6 +9,7 @@
 import android.support.annotation.FloatRange;
 import android.text.style.AbsoluteSizeSpan;
 import android.text.style.BackgroundColorSpan;
+import android.text.style.ClickableSpan;
 import android.text.style.ForegroundColorSpan;
 import android.text.style.ImageSpan;
 import android.text.style.QuoteSpan;
@@ -18,7 +19,9 @@
 import android.text.style.SubscriptSpan;
 import android.text.style.SuperscriptSpan;
 import android.text.style.TypefaceSpan;
+import android.text.style.URLSpan;
 import android.text.style.UnderlineSpan;
+import android.view.View;
 
 /**
  * @author Andrius Semionovas
@@ -186,4 +189,31 @@ public Object build() {
             }
         });
     }
+
+    public static Span custom(SpanBuilder builder) {
+        return new Span(builder);
+    }
+
+    public static Span click(final View.OnClickListener onClickListener) {
+        return new Span(new SpanBuilder() {
+            @Override
+            public Object build() {
+                return new ClickableSpan() {
+                    @Override
+                    public void onClick(View view) {
+                        onClickListener.onClick(view);
+                    }
+                };
+            }
+        });
+    }
+
+    public static Span url(final String url) {
+        return new Span(new SpanBuilder() {
+            @Override
+            public Object build() {
+                return new URLSpan(url);
+            }
+        });
+    }
 }

sample/src/main/java/lt/neworld/spanner/sample/SampleJavaActivity.java

@@ -1,28 +1,21 @@
 package lt.neworld.spanner.sample;
 
 import android.graphics.Color;
+import android.graphics.Typeface;
 import android.os.Bundle;
 import android.support.v7.app.AppCompatActivity;
 import android.text.Spannable;
+import android.text.method.LinkMovementMethod;
+import android.text.style.StyleSpan;
+import android.view.View;
 import android.widget.TextView;
+import android.widget.Toast;
 
+import lt.neworld.spanner.SpanBuilder;
 import lt.neworld.spanner.Spanner;
 import lt.neworld.spanner.Spans;
 
-import static lt.neworld.spanner.Spans.background;
-import static lt.neworld.spanner.Spans.bold;
-import static lt.neworld.spanner.Spans.boldItalic;
-import static lt.neworld.spanner.Spans.font;
-import static lt.neworld.spanner.Spans.foreground;
-import static lt.neworld.spanner.Spans.image;
-import static lt.neworld.spanner.Spans.italic;
-import static lt.neworld.spanner.Spans.quote;
-import static lt.neworld.spanner.Spans.scaleSize;
-import static lt.neworld.spanner.Spans.sizeDP;
-import static lt.neworld.spanner.Spans.strikeThrough;
-import static lt.neworld.spanner.Spans.subscript;
-import static lt.neworld.spanner.Spans.superscript;
-import static lt.neworld.spanner.Spans.underline;
+import static lt.neworld.spanner.Spans.*;
 
 public class SampleJavaActivity extends AppCompatActivity {
 
@@ -33,6 +26,15 @@ protected void onCreate(Bundle savedInstanceState) {
 
         TextView textView = findViewById(R.id.text);
 
+        textView.setMovementMethod(new LinkMovementMethod());
+
+        View.OnClickListener onClickListener = new View.OnClickListener() {
+            @Override
+            public void onClick(View view) {
+                Toast.makeText(view.getContext(), "Clicked", Toast.LENGTH_LONG).show();
+            }
+        };
+
         // @formatter:off
         Spannable spannable = new Spanner()
                 .append("Original text\n\n")
@@ -50,13 +52,24 @@ protected void onCreate(Bundle savedInstanceState) {
                 .append("subscript\n", subscript())
                 .append("superscript\n", superscript())
                 .append(" \n", image(getResources().getDrawable(R.drawable.ic_android_16dp)))
-                .append("quite\n", Spans.quote())
+                .append("quite\n", quote())
                 .append("The quick brown fox jumps over the lazy dog\n", bold(), foreground(0xFF904f1c), Spans.quote())
                 .span("fox", foreground(Color.RED))
                 .span("dog", foreground(Color.RED))
+                .append("Custom\n", custom(new CustomSpan()))
+                .append("Click here\n", click(onClickListener))
+                .append("http://www.android.com\n", url("http://www.android.com"))
                 ;
         // @formatter:on
 
         textView.setText(spannable);
     }
 }
+
+class CustomSpan implements SpanBuilder {
+    @Override
+    public Object build() {
+        return new StyleSpan(Typeface.BOLD);
+    }
+}
+