一个基于Kotlin DSL的Android富文本构建库，支持通过链式调用快速构建包含样式、交互和图片的复杂文本内容。
以下是使用本库构建的富文本示例效果（实际效果以运行时为准）：
- 丰富的样式支持：字体颜色、背景色、粗体、斜体、下划线、删除线、自定义字体、字体大小、相对大小、文字阴影、上标/下标
以下是DslSpanBuilder接口支持的核心方法：
| 方法名 | 参数说明 | 功能描述 |
|---|---|---|
textColor(@ColorInt color) |
color: 颜色值（支持0xFFE91E63格式或"#00FF00".toColorInt()转换） |
设置字体前景色 |
backgroundColor(@ColorInt color) |
color: 颜色值 |
设置字体背景色 |
textSize(size: Int) |
size: 字体大小（单位：sp） |
设置字体大小 |
click(block: (View) -> Unit) |
block: 点击事件回调（接收点击的View参数） |
设置可点击文本的点击事件 |
bold() |
无 | 应用粗体样式 |
italic() |
无 | 应用斜体样式 |
underline() |
无 | 添加下划线 |
strikethrough() |
无 | 添加删除线 |
fontFamily(typeface: Typeface) |
typeface: 自定义字体（通过ResourcesCompat.getFont加载） |
应用自定义字体（需提前将字体文件放入res/font目录） |
relativeSize(ratio: Float) |
ratio: 相对默认大小的比例（如1.5表示1.5倍） |
设置相对字体大小 |
shadow(radius: Float, dx: Float, dy: Float, @ColorInt color) |
radius: 阴影半径, dx: 水平偏移, dy: 垂直偏移, color: 阴影颜色 |
设置文字阴影效果 |
verticalAlignment(alignment: VerticalAlignment) |
alignment: 对齐方式（Normal/Superscript/Subscript） |
设置文字上标/下标 |
clickHighlightColor(@ColorInt color) |
color: 点击高亮颜色值 |
设置点击事件背景高亮颜色 |
- 交互能力：支持文本区域点击事件（点击后触发Toast或自定义逻辑）
- 图片插入：支持通过资源ID或Bitmap插入图片到文本中
- DSL链式调用：通过简洁的Kotlin DSL语法构建富文本，代码可读性强
- 灵活扩展：支持自定义Span类型扩展（如新增上标/下标样式）
在项目的build.gradle.kts中添加依赖：
implementation("io.github.wkbin:spanny:1.0.0")在Activity或Fragment中通过DSL构建富文本：
findViewById<TextView>(R.id.tv_demo).buildDslSpannableString {
addText("16sp大小") { textSize(16) }
addText("\n24sp加粗") { textSize(24).bold() }
addText("\n绿色斜体") { textColor("#00FF00".toColorInt()).italic() }
addText("\n红色带下划线") { textColor(0xFFE91E63.toInt()).underline() }
addText("\n删除线") { strikethrough() }
// 自定义字体示例（需提前将字体文件放入res/font目录）
val customTypeface = ResourcesCompat.getFont(this@MainActivity, R.font.sansita_extra_bold_italic)
addText("\n20sp红色背景自定义字体") { fontFamily(customTypeface!!).textSize(20).backgroundColor(0xFFE91E63.toInt()) }
// 可点击文本
addText("
可点击文本") { click { showToast("点击事件触发") }.clickHighlightColor(0xFFFFEB3B.toInt()) }
// 阴影效果
addText("
带阴影的文字") { shadow(2f, 1f, 1f, 0xFF607D8B.toInt()) }
// 上标示例
addText("
H2O") { verticalAlignment(DslSpanBuilder.VerticalAlignment.Superscript) }
// 插入图片
addImage(this@MainActivity, R.mipmap.ic_launcher)
}| 类名 | 功能描述 |
|---|---|
DslSpanBuilder |
定义样式操作接口（textColor、bold等方法） |
DslSpanBuilderImpl |
样式操作的具体实现类 |
DslSpannableStringBuilder |
富文本构建主接口（addText、addImage方法） |
DslSpannableStringBuildImpl |
富文本构建的具体实现类 |
如需新增自定义Span类型（如添加阴影效果），支持两种方式：
- 在
DslSpanBuilder接口中添加新方法（如shadow(radius: Float, dx: Float, dy: Float, color: Int)） - 在
DslSpanBuilderImpl中实现该方法，将ShadowSpan添加到Span集合 - 在业务代码中通过DSL调用新方法
- 创建自定义Span类（如
DynamicColorSpan）并实现所需逻辑 - 在业务代码中通过
customSpan(span)方法直接传入自定义Span实例
示例：
// 自定义Span类
class DynamicColorSpan(private val colors: List<Int>) : CharacterStyle() {
override fun updateDrawState(tp: TextPaint) {
tp.color = colors.random() // 示例：随机切换颜色
}
}
// 使用customSpan调用
addText("\n动态颜色文本") { customSpan(DynamicColorSpan(listOf(0xFFFF0000.toInt(), 0xFF00FF00.toInt()))) }欢迎提交Issue反馈问题或提交PR参与开发：
- Fork本仓库
- 创建特性分支（
git checkout -b feature/xxx） - 提交代码（
git commit -am 'Add xxx feature'） - 推送分支（
git push origin feature/xxx） - 提交Pull Request