Android Html.fromHtml和buildSpannedString用途和实现方式
1. Html.fromHtml
:
- 功能: 将 HTML 字符串转换为
Spanned
对象,以便在 TextView 等控件中显示带格式的文本。HTML 标签可以指定文本的样式,比如粗体、斜体、下划线等。 - 用法: 主要用来解析 HTML 字符串并将其渲染成文本,支持常见的 HTML 标签(如
<b>
,<i>
,<u>
,<br>
,<p>
等)。 - 实现:
Html.fromHtml
解析 HTML 字符串并将 HTML 标签转换为Spannable
对象中的各种样式(例如,粗体、斜体等)。 - 局限性:
- 对于复杂的 HTML 标签支持有限。
- 根据 API 版本,不同的版本可能会有不同的表现。
- 不适合复杂的动态文本拼接(例如,涉及多个样式的动态文本构建)。
2. buildSpannedString
:
- 功能: 用于以编程方式创建带格式的
SpannedString
,通过链式调用构建多个Span
。可以使用各种Span
对象(如StyleSpan
,ForegroundColorSpan
,UnderlineSpan
)来控制文本的样式。 - 用法: 使用 Kotlin 的 DSL 语法,动态、灵活地构建带格式的文本,特别适合复杂的文本格式化场景。
- 实现: 使用 Kotlin 高阶函数,通过
buildSpannedString
来动态创建SpannedString
,可以将多个样式应用到特定的文本片段上。 - 优势:
- 灵活性强,可以轻松实现复杂文本的拼接和格式化。
- 不依赖 HTML 标签,完全通过
Spanned
API 控制样式。 - 更适合在代码中动态构建格式化的文本。
举例
设置 "Android" 的颜色为 #3371F1 并去除下划线
val spannedText = buildSpannedString {
append("Modern tools and resources to help you build experiences that people love, faster and easier, across every ")
// 设置 "Android" 颜色和点击事件
inSpans(object : ClickableSpan() {
override fun onClick(widget: View) {
// 处理点击事件
Toast.makeText(widget.context, "Android clicked", Toast.LENGTH_SHORT).show()
}
override fun updateDrawState(ds: TextPaint) {
super.updateDrawState(ds)
ds.isUnderlineText = false // 去掉下划线
ds.color = Color.parseColor("#3371F1") // 设置颜色
}
}) {
append("Android")
}
append(" device.")
}
// 设置 TextView 的文本为可点击的 SpannedString
textView.text = spannedText
textView.movementMethod = LinkMovementMethod.getInstance() // 启用点击事件
// HTML 字符串,设置 "Android" 的颜色为 #3371F1 并去除下划线
val htmlText = "Modern tools and resources to help you build experiences that people love, faster and easier, across every <a href='android://click'>Android</a> device."
//val text = "Modern tools and resources to help you build experiences that people love, faster and easier, across every <font color='#3371F1'><a href='android://click'>Android</a></font> device."
// 使用 Html.fromHtml 解析 HTML
val spanned = Html.fromHtml(htmlText, Html.FROM_HTML_MODE_LEGACY)
// 设置解析后的文本到 TextView
textView.text = spanned
// 设置 ClickableSpan 和去除下划线
textView.movementMethod = LinkMovementMethod.getInstance()
// 处理点击事件,使用自定义的 URLSpan
val spannable = textView.text as Spannable
val urlSpans = spannable.getSpans(0, spannable.length, URLSpan::class.java)
for (urlSpan in urlSpans) {
val start = spannable.getSpanStart(urlSpan)
val end = spannable.getSpanEnd(urlSpan)
spannable.removeSpan(urlSpan) // 移除默认的 URLSpan
// 添加自定义 ClickableSpan
spannable.setSpan(object : ClickableSpan() {
override fun onClick(widget: View) {
// 处理点击事件
Toast.makeText(widget.context, "Android clicked", Toast.LENGTH_SHORT).show()
}
override fun updateDrawState(ds: TextPaint) {
super.updateDrawState(ds)
ds.isUnderlineText = false // 去除下划线
ds.color = Color.parseColor("#3371F1") // 设置颜色为 #3371F1
}
}, start, end, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
}