ImageSpan 在 API 29 以下的居中问题

2024-01-01 14:34:32

前言

在 Android 开发中，ImageSpan 是一种可用于在文本中嵌入图像的工具。通常情况下，这些图像将与文本行垂直对齐，但有时需要将图像居中。在 API 29（Android 10）之前，居中 ImageSpan 的实现需要一些额外的努力，因为默认情况下，图像将与文本行垂直对齐。

分析

要理解在 API 29 以下居中 ImageSpan 的问题，首先需要了解 ImageSpan 的工作原理。ImageSpan 实际上是一个对齐文本行高度和宽度来放置图像的DynamicDrawableSpan。在 API 29 以下，ImageSpan 的默认对齐方式是与文本行垂直对齐。这意味着图像的底部将与文本行底部对齐，而图像的其余部分将位于文本行的上面或侧面。

解决方案

要居中 ImageSpan，我们可以在文本行的底部添加一个额外的空行。此空行将为 ImageSpan 提供放置图像的空间，并将其居中在文本行中。以下代码段演示了如何使用空行居中 ImageSpan：

SpannableString spannableString = new SpannableString("文本行 1\n");
spannableString.setSpan(new ImageSpan(context, drawable), 0, spannableString.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
spannableString.setSpan(new RelativeSizeSpan(0.5f), spannableString.length() - 1, spannableString.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);

在上面的代码段中，ImageSpan 应用于整个字符串，而 RelativeSizeSpan 应用于空行的最后一个字符。这将有效地将空行缩小到一个像素，使其几乎不可见，但仍然为 ImageSpan 提供足够的空间进行居中。

API 29+

在 API 29（Android 10）中，居中 ImageSpan 的方法已得到简化。可以使用 ImageSpan.ALIGN_CENTER 常量指定对齐方式，如下所示：

spannableString.setSpan(new ImageSpan(context, drawable), 0, spannableString.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
spannableString.setSpan(new ImageSpan.Builder(context, drawable).setSpanAlignment(ImageSpan.ALIGN_CENTER).build(), 0, spannableString.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);