Android中SpannableString使用(二)---ImageSpan实现一个简单的图文展示效果

2018-11-30,发现又是周五啦,心情美美哒。想着再过几个小时就要下班过周末了,感觉自己立马兴奋无比了,再想想明天和小伙伴约了篮球,又要暴虐他们,一下就要膨胀了。但是一直秉持着做人要低调的我,还是要冷静一下,毕竟还没下班么。所以先来写一个文章吧。

上篇Android中SpannableString使用(一)---如何在一个TextView中显示不同样式的文字中,简单的介绍了SpannableString在Android开发中的一些简单使用,还有一些Span的简单使用。

这一篇我就来介绍一个

Android中使用ImageSpan实现简单的图文展示方案

最近项目中有一个这个的页面需求:


需求效果图

其实这个要注意的也就是如何实现小图标在文字的最后面显示出来。

第一反应想到的方法就是给TextView加上drawableRight,于是就撸了一波代码

    <TextView
        android:id="@+id/tv1"
        android:layout_weight="1"
        android:gravity="center_vertical"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="@dimen/sp_14"
        android:textColor="@color/text_333333"
        android:text="花和尚 送 小二哥 一个鼓掌"
        android:drawableRight="@mipmap/aaaa"
        android:drawablePadding="@dimen/dp_5"/>

    <TextView
        android:id="@+id/tv2"
        android:layout_weight="1"
        android:gravity="center_vertical"
        android:textSize="@dimen/sp_14"
        android:textColor="@color/text_333333"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="花和尚 送 小二哥 一个鼓掌花和尚 送 小二哥 一个鼓掌花和尚 送 小二哥 一个鼓掌花和尚 送 小二哥 一个鼓掌花和尚 送 小二哥 一个鼓掌花和尚 送 小二哥 一个鼓掌"
        android:drawableRight="@mipmap/aaaa"
        android:drawablePadding="@dimen/dp_5"/>
drawableRight方式效果

很显然用这种方式实现的时候,当文字只有一行的时候,可以达到想要的效果,可是换行之后就不可以了。所以继续想想其他的方法呗。

接下来就说说使用ImageSpan的方式实现

直接先上代码

String s = "花和尚 送 小二哥 一个鼓掌花和尚 送 小二哥 一个鼓掌花和尚 送 小二哥  ";
//创建SpannableString对象
SpannableString string = new SpannableString(s);
//创建ImageSpan对象
ImageSpan imageSpan = new ImageSpan(mContext, R.mipmap.aaaa, DynamicDrawableSpan.ALIGN_BASELINE);
//给SpannableString对象设置ImageSpan
string.setSpan(imageSpan, s.length() - 1, s.length(), Spannable.SPAN_INCLUSIVE_INCLUSIVE);
tv3.setText(string);

简单的几句代码就可以实现图标一直确保在最后一个文字后面


使用ImageSpan的效果

看完这张图,很明显我在图上标注了两条线。仔细观察,我画的线都是放在小图标的下边缘,然而却在文字的不同高度上。这说明小图标和文字的对齐方式不同,这是为什么呢?我们就来看看ImageSpan的源码吧。

public ImageSpan(Context context, @DrawableRes int resourceId, int verticalAlignment)

ImageSpan的构造方法有好几种,因为实例代码中使用的这种,就说说这个吧。

三个参数

1,Context context:上下文
2,@DrawableRes int resourceId:DrawableResId
3,int verticalAlignment:对齐方式(系统中提供了两种)

   /**
    * A constant indicating that the bottom of this span should be aligned
    * with the bottom of the surrounding text, i.e., at the same level as the
    * lowest descender in the text.
    */
   public static final int ALIGN_BOTTOM = 0;
   
   /**
    * A constant indicating that the bottom of this span should be aligned
    * with the baseline of the surrounding text.
    */
   public static final int ALIGN_BASELINE = 1;
  • DynamicDrawableSpan.ALIGN_BASELINE:以基线对齐
  • DynamicDrawableSpan.ALIGN_BOTTOM:以底部对齐

这个就是上面图中的两条线位置不同的原因。
写在这里有突然想到一个问题,我们在实际开发中布局的时候,很多时候用到的是垂直居中。而ImageSpan中只提供了ALIGN_BASELINE和ALIGN_BOTTOM,我们怎么实现垂直居中的效果呢。接下来继续逼逼。

首先看看ImageSpan的源码

public class ImageSpan extends DynamicDrawableSpan{}

并没有什么特别的东西

再看看其父类DynamicDrawableSpan

    @Override
    public int getSize(Paint paint, CharSequence text,
                         int start, int end,
                         Paint.FontMetricsInt fm) {
        Drawable d = getCachedDrawable();
        Rect rect = d.getBounds();

        if (fm != null) {
            fm.ascent = -rect.bottom; 
            fm.descent = 0; 

            fm.top = fm.ascent;
            fm.bottom = 0;
        }

        return rect.right;
    }

    @Override
    public void draw(Canvas canvas, CharSequence text,
                     int start, int end, float x, 
                     int top, int y, int bottom, Paint paint) {
        Drawable b = getCachedDrawable();
        canvas.save();
        
        int transY = bottom - b.getBounds().bottom;
        if (mVerticalAlignment == ALIGN_BASELINE) {
            transY -= paint.getFontMetricsInt().descent;
        }

        canvas.translate(x, transY);
        b.draw(canvas);
        canvas.restore();
    }

getSize(...)函数:返回一个int的rect.right,也就是图片的宽度。同时在这个函数中也对文字的ascent和descent两个值进行了修改。

        /**
         * The recommended distance above the baseline for singled spaced text.
         */
        public int   ascent;
        /**
         * The recommended distance below the baseline for singled spaced text.
         */
        public int   descent;

(注:ascent,descent等参数的含义在文章的最后面有图文解释)

draw(...)函数:在这个函数里面是根据不同的对齐参数进行图片的绘制。

就从这两个函数入手修改竖直居中的对齐方式

  • 我们得创建一个VerticalImageSpan继承ImageSpan,并重写以上的两个函数。
public class VerticalImageSpan extends ImageSpan {
    
    public VerticalImageSpan(Context context, int resourceId) {
        super(context, resourceId);
    }
    
}
  • 修改draw(...)方法来实现居中
    @Override
    public void draw(Canvas canvas, CharSequence text, int start, int end, float x, int top, int y, int bottom, Paint paint) {
        Drawable b = getDrawable();
        canvas.save();
        int transY = 0;
        //获得将要显示的文本高度 - 图片高度除2 = 居中位置+top(换行情况)
        transY = ((bottom - top) - b.getBounds().bottom) / 2 + top;
        //偏移画布后开始绘制
        canvas.translate(x, transY);
        b.draw(canvas);
        canvas.restore();
    }
  • 还要修改getSize(...)函数,重新设置文字的ascent和descent
    @Override
    public int getSize(Paint paint, CharSequence text, int start, int end,
                       Paint.FontMetricsInt fm) {
        Drawable d = getDrawable();
        Rect rect = d.getBounds();
        if (fm != null) {
            Paint.FontMetricsInt fmPaint = paint.getFontMetricsInt();
            //获得文字、图片高度
            int fontHeight = fmPaint.bottom - fmPaint.top;
            int drHeight = rect.bottom - rect.top;
            
            int top = drHeight / 2 - fontHeight / 4;
            int bottom = drHeight / 2 + fontHeight / 4;

            fm.ascent = -bottom;
            fm.top = -bottom;
            fm.bottom = top;
            fm.descent = top;
        }
        return rect.right;
    }

现在就可以直接使用了。看看三种对齐方式的效果图(为了更加明显我换了一个大一点的图标)
三种不同的对齐方式

好了,到这里基本已经结束了。
效果图中文字还需要改变颜色,这里就不做了。上篇中我已经提到过不同的span可以组合使用实现复杂的展示效果,我们只需要再给SpannableString设置一个ForegroundColorSpan就可以实现改变颜色了。

最后再补充一点Android中TextView编辑时结构

textview的结构
  • 基准点是baseline
  • ascent:是baseline之上至字符最高处的距离
  • descent:是baseline之下至字符最低处的距离
  • leading:是上一行字符的descent到下一行的ascent之间的距离,也就是相邻行间的空白距离
  • top:是指的是最高字符到baseline的值,即ascent的最大值
  • bottom:是指最低字符到baseline的值,即descent的最大值

终于写完了。浪浪浪浪浪起来!!!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,214评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,307评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,543评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,221评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,224评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,007评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,313评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,956评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,441评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,925评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,018评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,685评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,234评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,240评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,464评论 1 261
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,467评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,762评论 2 345

推荐阅读更多精彩内容