/SpanK

Spans for Kotlin made easier

Primary LanguageKotlinApache License 2.0Apache-2.0

Download

SpanK

Spans for Kotlin made easier, plain and simple.

Without spans, look at it, looks so sad :( With spans, everything is better You can create your own in app ToS with this

How to use

There are 3 steps to start using this library:

  1. you need to call the styleString method
    • which will return the styled string that you can set on your TextView.
  2. decide which locator(s) fits your needs
    • (optional) you can pass down a flag to override the default spanFlag for all styles on this locator
  3. pass down styles to each locator
    • If using link or clickable you need to set movement method on your view your_text_view.movementMethod = LinkMovementMethod()

Step 1 - Get the ball rolling

spannedContent = styleString(R.string.your_string_resource) {}

or, if you don't have a String resource just pass the string

spannedContent = styleString("Your string") {}

Step 2 - Locate pieces you want to style

spannedContent = styleString(R.string.your_string_resource) {
    all {
        // Anything inside here applies to the whole content
    }
    
    firstAppearanceOf(R.string.what_ever_text_you_want_to_style) {
        // Anything inside here applies to the first time the string appears inside the content
    }
}

Step 3 - Style styling now

spannedContent = styleString(R.string.your_string_resource) {
    all {
        bold()
        italic()
    }
    
    firstAppearanceOf(R.string.what_ever_text_you_want_to_style) {
        absoluteSizeDP(24)
        clickable {
            // Do something when this is clicked
        }
    }
}

EzFlags (ONLY relevant if using with EditTextView)

  • EXCLUSIVE_EXCLUSIVE - (Default) anything added at the beginning or end of the section will NOT be modified by the styles on that section
  • INCLUSIVE_INCLUSIVE - anything added at the beginning or end of the section will be modified by the styles on that section
  • INCLUSIVE_EXCLUSIVE - anything added at the beginning will be modified by the styles on that section
  • EXCLUSIVE_INCLUSIVE- anything added at the end of the section will be modified by the styles on that section
spannedContent = styleString(R.string.your_string_resource) {
    all {
        bold()
        italic()
    }
    
    firstAppearanceOf(R.string.what_ever_text_you_want_to_style, spanFlag = EzFlags.INCLUSIVE_EXCLUSIVE) {
        absoluteSizeDP(24)
        clickable {
            // Do something when this is clicked
        }
    }
}