Spannable

GlideImageSpan is a ReplacementSpan that uses the Glide library to load and display images (including GIFs) directly within a TextView. It allows for advanced styling such as vertical alignment, custom sizing, margins, padding, and even overlaying text on top of the image.

Prerequisites You must include the Glide dependency in your project to use this class.

Key Features

• Vertical Alignment: Choose between Align.CENTER (default), Align.BASELINE, or Align.BOTTOM.
• Sizing: Set custom widths and heights. Use -1 to match the text width/height or 0 for the image's original size.
• Text Overlay: You can display text on top of the image by enabling setTextVisibility and configuring textGravity and textOffset.
• GIF Support: Supports playing GIFs with configurable loop counts.
• Glide Integration: Pass custom RequestOptions to control placeholders, error drawables, and transformations (e.g., centerCrop).

// Example usage (Conceptual)
val span = GlideImageSpan(textView, "https://example.com/image.jpg")
    .setAlign(GlideImageSpan.Align.CENTER)
    .setDrawableSize(200, 200)
    .setMarginHorizontal(10)
    .setTextVisibility(true)
    .setTextGravity(Gravity.CENTER)

textView.text = "Some text " + span + " more text"

// To use custom Glide options
val options = RequestOptions().placeholder(R.drawable.placeholder).centerCrop()
span.setRequestOption(options)

HighlightSpan is a custom ClickableSpan used to apply font color, typeface (style), and click events to specific text segments.

Important Requirement: To make the onClick event functional, you must set either ClickableMovementMethod (from this library) or the standard Android LinkMovementMethod on the TextView containing the spannable text. This is an Android framework limitation.

Constructors

1. Color Int: Use an integer color (e.g., from Color.RED or Color.parseColor()).

   • HighlightSpan(color: Int?, typeface: Typeface?, onClick: ((View) -> Unit)?)

2. Color String: Use a hex color string (e.g., "#FF0000").

   • HighlightSpan(color: String, typeface: Typeface?, onClick: ((View) -> Unit)?)

3. Color Resource: Use a color resource ID from your Android resources.

   • HighlightSpan(context: Context, @ColorRes colorRes: Int, typeface: Typeface?, onClick: ((View) -> Unit)?)

// Example 1: Using a color string and a click listener
val span = HighlightSpan("#FF0000", typeface = Typeface.DEFAULT_BOLD) {
    // Handle click event
}

// Example 2: Using a color resource
val spanRes = HighlightSpan(context, R.color.primary_color) {
    // Handle click event
}

// CRITICAL: You must apply a movement method to the TextView for onClick to work
textView.movementMethod = ClickableMovementMethod()

CenterImageSpan is an improved version of the standard Android ImageSpan. It provides advanced features for displaying images within text, including:

• Vertical Alignment: Control how the image aligns with the text baseline.
• Proportional Scaling: Set specific widths or heights while maintaining the image's aspect ratio.
• Spacing Control: Configure both external margins and internal padding for the image.
• Text Overlay: Display text on top of the image with customizable gravity, offset, and size.

Note: For complex loading requirements (like Gaussian blur or diamond shapes), use GlideImageSpan instead.

Constructors

• CenterImageSpan(drawable: Drawable)
• CenterImageSpan(drawable: Drawable, source: String)
• CenterImageSpan(context: Context, uri: Uri)
• CenterImageSpan(context: Context, resourceId: Int)
• CenterImageSpan(context: Context, bitmap: Bitmap)

// Example usage
val drawable = ContextCompat.getDrawable(context, R.drawable.my_image)!!
val span = CenterImageSpan(drawable)
    .setAlign(CenterImageSpan.Align.CENTER)
    .setDrawableSize(100)
    .setMarginHorizontal(10)
    .setTextVisibility(true)
    .setTextGravity(Gravity.CENTER)

val spannable = SpannableString("Text with image").apply {
    setSpan(span, 6, 11, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
}

Use these methods to control how the image itself is rendered within the text flow: