Android中的各类Span全面系统研究

2013-04-27

注意:效果图请点击原文查看      

在android中,有时候需要对文本进行各种特别的设置,比如颜色、大小、首行缩进,或者是在一段文本中加入图片,甚至是书写一些特殊的公式。如果通过布局文件使用多个控件来实现,一方面会使的使用起来特别的复杂,增加了布局文件维护的难度,另一方面,如果加入了太多的控件,在页面加载时也要耗费更多的资源。如果在HTML中,则可以使用各种标签来实现这些特殊效果,而在android中有类似的机制,只不过不是使用标签来实现,而是使用Spannable对象来实现。

一、关于Spannable的构建:


可以看出,Spannable继承自Spanned接口,而实际上,Spanned继承自CharSequence接口:


在TextView的setText(CharSequence text)方法中,要求的参数正好是一个CharSequence对象,因此,我们可以通过Spannable对象来直接使用setText来完成文本的设置。在使用中通常使用Spannable spn = new SpannableString("字符串");或者通过SpannableStringBuilder对象来进行构建。

二、给Spannable对象设置样式:

在构建除了Spannable对象以后,就可以使用spannable.setSpan(Obj what, int start, int end, int flags)方法来进行样式的设置了,其中参数what是具体样式的实现对象,start则是该样式开始的位置,end对应的是样式结束的位置,参数flags,定义在Spannable中的常量,常用的有:

Spanned.SPAN_EXCLUSIVE_EXCLUSIVE --- 不包含两端start和end所在的端点              (a,b)
Spanned.SPAN_EXCLUSIVE_INCLUSIVE --- 不包含端start,但包含end所在的端点       (a,b]
Spanned.SPAN_INCLUSIVE_EXCLUSIVE --- 包含两端start,但不包含end所在的端点   [a,b)
Spanned.SPAN_INCLUSIVE_INCLUSIVE--- 包含两端start和end所在的端点                     [a,b]

但实际测试这其中似乎并未有差别,而在start和end相同的情况下,则只对start所在字符的当前行起作用。

三、样式分析:

用来构建样式的具体的类都在android.text.style包下,下面逐一进行分析。

1.AbsoluteSizeSpan

顾名思义,AbsoluteSizeSpan是指绝对尺寸,通过指定绝对尺寸来改变文本的字体大小。该类有三个构造函数:
AbsoluteSizeSpan(int size)、AbsoluteSizeSpan(int size, boolean dip)、AbsoluteSizeSpan(Parcel src)。
AbsoluteSizeSpan(int size):参数size, 以size的指定的像素值来设定文本大小。
AbsoluteSizeSpan(int size, boolean dip):参数size,以size的指定像素值来设定文本大小,如果参数dip为true则以size指定的dip为值来设定文本大小。
AbsoluteSizeSpan(Parcel src):参数src,包含有size和dip值的包装类。在该构造中
public AbsoluteSizeSpan(Parcel src) {
mSize = src.readInt();
mDip = src.readInt() != 0;    
}
使用范例:
Parcel p = Parcel.obtain();
p.writeInt(29);//字体大小
p.writeInt(8);//是否是dip单位
p.setDataPosition(0);
AbsoluteSizeSpan ass = new AbsoluteSizeSpan(p);
效果:

2.AlignmentSpan.Standard

AlignmentSpan.Standard,标准文本对齐样式,该类有两个构造函数,AlignmentSpan.Standard(Layout.Alignment align)和AlignmentSpan.Standard(Parcel src)。AlignmentSpan.Standard(Layout.Alignment align):参数align,Layout.Alignment类型的枚举值。包括居中、正常和相反三种情况。
AlignmentSpan.Standard(Parcel src):参数src,包含有标准字符串的Parcel类,其值应为"ALIGN_CENTER"、"ALIGN_NORMAL"或"ALIGN_OPPOSITE"中的之一,对应Layout.Alignment枚举中的三个类型。使用示例:
Parcel p = Parcel.obtain();
p.writeString(\"ALIGN_CENTER\");
p.setDataPosition(0);
AlignmentSpan.Standard standard = new AlignmentSpan.Standard(p);
效果:

3.BackgroundColorSpan

BackgroundColorSpan,背景色样式,显然可以用来设定文本的背景色。该类有两个构造函数,BackgroundColorSpan(int color)和BackgroundColorSpan(Parcel src)。
BackgroundColorSpan(int color):参数color,颜色值。
BackgroundColorSpan(Parcel src):参数src,包含颜色值信息的包装类,使用方法如下:
Parcel p = Parcel.obtain();
p.writeInt(Color.GREEN);
p.setDataPosition(0);
BackgroundColorSpan bcs = new BackgroundColorSpan(p);
效果:

4.BulletSpan

BulletSpan,着重样式,类似于HTML中的

  • 标签的圆点效果。该类有4个构造函数BulletSpan()、BulletSpan(int gapWidth)、BulletSpan(int gapWidth,int color)、BulletSpan(Parcel src)。
    BulletSpan():仅提供一个与文本颜色一致的符号。
    BulletSpan(int gapWidth): 提供一个与文本颜色一致的符号,并指定符号与后面文字之间的空白长度。
    BulletSpan(int gapWidth,int color):提供一个指定颜色的符号,并指定符号与后面文字之间的宽度。
    BulletSpan(Parcel src):参数src,包含宽度、颜色信息的包装类,在以此构造时,构造函数的调用如下:
    mGapWidth = src.readInt();
    mWantColor = src.readInt() != 0;\nmColor = src.readInt();
    如果使用Parcel作为参数时,使用方式为:
    Parcel p = Parcel.obtain();
    p.writeInt(20);//设置gapWidth
    p.writeInt(1);//设置是否使用颜色
    p.writeInt(Color.YELLOW);//设置颜色
    p.setDataPosition(0);
    BulletSpan bs3 = new BulletSpan(p);
    效果:
  • 5.DrawableMarginSpan

    DrawableMarginSpan,图片+Margin样式,该类有两个构造函数:DrawableMarginSpan(Drawable b)、DrawableMarginSpan(Drawable b,int pad)。
    DrawableMarginSpan(Drawable b):参数b,用于显示的图片。
    DrawableMarginSpan(Drawable b,int pad):参数b,用于显示的图片,参数pad,图片和文字的距离。
    效果:

    6.ForegroundColorSpan

    ForegroundColorSpan,字体颜色样式,用于改变字体颜色。该类有两个构造函数:ForegroundColorSpan(int color)、ForegroundColorSpan(Parcel src)。
    ForegroundColorSpan(int color):参数color,字体颜色。
    ForegroundColorSpan(Parcel src):参数src,包含字体颜色信息的包装类,使用如下:
    Parcel p = Parcel.obtain();
    p.writeInt(Color.YELLOW);
    p.setDataPosition(0);
    ForegroundColorSpan fcs = new ForegroundColorSpan(p);
    效果:

    7.IconMarginSpan

    IconMarginSpan,图标+Margin样式,该类与DrawableMarginSpan使用上很相似。本类有两个构造函数:
    IconMarginSpan(Bitmap b):参数b,用于显示图像的bitmap。
    IconMarginSpan(Bitmap b,int pad):参数b,用于显示图像的bitmap,参数pad,Bitmap和文本之间的间距。
    效果:

    8.ImageSpan

    ImageSpan,图片样式,主要用于在文本中插入图片。本类构造函数较多,但主要是针对Bitmap和Drawable的,也可以通过资源Id直接加载图片。如下:
    ImageSpan(Bitmap b):.参数b,用于显示的Bitmap。该方法已过时,改用Use ImageSpan(Context, Bitmap)代替。
    ImageSpan(Bitmap b, int verticalAlignment):参数b,用于显示的Bitmap,参数verticalAlignment,对齐方式,对应ImageSpan中的常量值。该方法已过时,改用ImageSpan(Context, Bitmap, int)代替。
    ImageSpan(Context context, Bitmap b):参数context,传入的上下文,参数b,用于显示的Bitmap。
    ImageSpan(Context context, Bitmap b, int verticalAlignment):参数context,传入的上下文,参数b,用于显示的Bitmap,参数verticalAlignment,对齐方式。
    ImageSpan(Drawable d):参数d,用于显示的Drawable,此Drawable须设置大小。
    ImageSpan(Drawable d, int verticalAlignment):参数d,用于显示的Drawable,参数verticalAlignment,对齐方式。
    ImageSpan(Drawable d, String source):参数d,用于显示的Drawable,参数source,资源字符串。
    ImageSpan(Drawable d, String source, int verticalAlignment):参数d,用于显示的Drawable,参数source,资源字符串,参数verticalAlignment,对齐方式。
    ImageSpan(Context context, Uri uri):参数context,传入的上下文,参数uri,图片的uri。
    ImageSpan(Context context, Uri uri, int verticalAlignment):参数context,传入的上下文,参数uri,图片的uri,参数verticalAlignment,对齐方式。
    ImageSpan(Context context, int resourceId):参数context,传入的上下文,参数resourceId,图片的资源id。
    ImageSpan(Context context, int resourceId, int verticalAlignment)参数context,传入的上下文,参数resourceId,图片的资源id,参数verticalAlignment,对齐方式。
    效果:


    9.LeadingMarginSpan

    LeadingMarginSpan.Standard,文本缩进的样式。有3个构造函数,分别为:
    Standard(int arg0):参数arg0,缩进的像素。
    Standard(int arg0, int arg1):参数arg0,首行缩进的像素,arg1,剩余行缩进的像素。
    Standard(Parcel p): 参数p,包含缩进信息的包装类。在构造时,
    public Standard(Parcel src) {
        mFirst = src.readInt();\n"+
        mRest = src.readInt();\n"+
    }
    使用方式:
    Parcel p = Parcel.obtain();
    p.writeInt(20);
    p.writeInt(30);
    p.setDataPosition(0);
    Standard lms = new Standard(p);
    效果:
      文字环绕图片效果


    Android文本样式——下


    继续就android的文本样式进行分析:

    10.MaskFilterSpan

    MaskFilterSpan,滤镜样式,只有一个构造函数:
    MaskFilterSpan(MaskFilter filter):参数filter,滤镜样式。
    说明:
    在android系统里,MaskFilter提供了两个子类,BlurMaskFilter和EmbossMaskFilter,分别用来制作模糊效果和浮雕效果。
    效果:

    11.QuoteSpan

    QuoteSpan,引用样式,在文本左侧添加一条表示引用的竖线,该类有3个构造函数:
    QuoteSpan():无参构造,默认颜色为蓝色。
    QuoteSpan(int color):参数color,颜色值。
    QuoteSpan(Parcel src):包含颜色值信息的包装类。使用:
    Parcel p = Parcel.obtain();
    p.writeInt(Color.BLACK);
    p.setDataPosition(0);
    QuoteSpan qs = new QuoteSpan(p);
    效果:

    12.RasterizerSpan

    RasterizerSpan,字面义为光栅化,实际效果不明显,待完善。一个构造函数:
    RasterizerSpan(Rasterizer r):Rasterizer只有一个系统定义了的子类LayerRasterizer

    13.RelativeSizeSpan

    RelativeSizeSpan,相对大小,指相对于文本设定的大小的相对比例,如果没有设定则采用系统默认值。该类有两个构造函数:
    RelativeSizeSpan(float proportion):参数proportion,比例值。如果文字设定大小为A,则显示出来的大小为A×proportion。
    RelativeSizeSpan(Parcel src):参数src,包含了比例值信息的包装类。使用:
    Parcel p = Parcel.obtain();
    p.writeFloat(2.5f);
    p.setDataPosition(0);
    RelativeSizeSpan rss = new RelativeSizeSpan(p);
    效果:

    14.ScaleXSpan

    ScaleXSpan,横向缩放样式,将字体按比例进行横向缩放。构造函数:
    ScaleXSpan(float proportion):参数proportion,缩放比例。如果字体设置的大小为A,则实际显示为A×proportion。
    ScaleXSpan(Parcel src):参数src,包含了缩放比例信息的包装类。使用:
    Parcel p = Parcel.obtain();
    p.writeFloat(2.5f);
    p.setDataPosition(0);
    ScaleXSpan rss = new ScaleXSpan(p);
    效果:

    15.StrikethroughSpan

    StrikethroughSpan,删除线样式。该类有两个构造函数:
    StrikethroughSpan()和SrickkethroughSapn(Parcel src)。但有参数的构造函数并未对src参数做处理,
    public StrikethroughSpan(Parcel src) {
    }
    因此这两个构造函数完全是同样的效果。

    16.StyleSpan

    StyleSpan,主要由正常、粗体、斜体和同时加粗倾斜四种样式,常量值定义在Typeface类中。构造函数:
    StyleSpan(int style):参数style,定义在Typeface中的常量。
    StyleSpan(Parcel src):参数src,包含字体信息的包装类,用法:
    Parcel p = Parcel.obtain();
    p.writeInt(Typeface.BOLD_ITALIC);
    p.setDataPosition(0);
    StyleSpan ss = new StyleSpan(p);
    效果:

    17.SubscriptSpan

    SubscriptSpan,脚注样式,比如化学式的常见写法,当然,还可以对脚注的文字做一定的缩放。构造函数:
    SubscriptSpan():无参构造。
    SubscriptSpan(Parcel src):一参构造,参数src并未起任何作用,源码中为:
    public SuperscriptSpan(Parcel src) {
    }
    效果:

    18.SuperscriptSpan

    SuperscriptSpan,上标样式,比如数学上的次方运算,当然,还可以对上标文字进行缩放。构造函数:
    SuperscriptSpan():无参构造。
    SuperscriptSpan(Parcel src):一参构造,参数src并未起任何作用,源码中为:
    public SuperscriptSpan(Parcel src) {
    }
    效果:

    19.TabStopSpan

    TabStopSpan.Standard,制表位偏移样式,距离每行的leading margin的偏移量,据测试在首行加入制表符时才产生效果。构造函数:
    TabStopSpan.Standard(int where):参数where,偏移量。
    效果:

    20.TextAppearanceSpan

    TextAppearanceSpan,使用style文件来定义文本样式,该类有4个构造函数:
    TextAppearanceSpan(Context context, int appearance):参数context,传入的上下文,参数appearance,引用的样式表,如R.style.my_style。
    TextAppearanceSpan(Context context, int appearance, int colorList):参数context,使用的上下文,参数appearance,引用的样式表,如R.style.my_style,参数colorList,使用方式未知,如果设置为小于0,则参数将不产生效果。
    TextAppearanceSpan(String family, int style, int size,ColorStateList color, ColorStateList linkColor):参数family,字体,仅支持系统自带的三种字体,MONOSPACE、SERIF和SANS,参数style,TypeFace中定义的字体样式,BOLD、ITALIC等,参数size,字体大小,参数color,字体颜色,参数linkColor,使用方式未知。TextAppearanceSpan(Parcel src):参数src,含有样式信息的包装类,样式信息参照5参构造。使用:
    Parcel p = Parcel.obtain();
    p.writeString(\"SERIF\");
    p.writeInt(Typeface.BOLD_ITALIC);
    p.writeInt(10);
    try {
        ColorStateList colorlist = ColorStateList.createFromXml(ctx.getResources(),ctx.getResources().getXml(R.drawable.parcelcolorlist));
        p.writeInt(1);
        colorlist.writeToParcel(p, Parcelable.PARCELABLE_WRITE_RETURN_VALUE);
        p.writeInt(1);
        colorlist.writeToParcel(p, Parcelable.PARCELABLE_WRITE_RETURN_VALUE);
    } catch (Exception e) {
        e.printStackTrace();
    }
    p.setDataPosition(0);
    TextAppearanceSpan tas = new TextAppearanceSpan(p);
    注:在这个设置中style似乎并未起到作用,另外关于这个类的colorList和linkColor参数的使用尚不明了,有待解答。
    效果:

    21.TypefaceSpan

    TypefaceSpan,字体样式,可以设置不同的字体,比如系统自带的SANS_SERIF、MONOSPACE和SERIF。构造函数:
    TypefaceSpan(String family):参数family,字体的值,以字符串表示。
    TypefaceSpan(Parcel src): 参数src,包含字体family信息的包装类,使用如下:
    Parcel p = Parcel.obtain();
    p.writeString(\"SERIF\");
    p.setDataPosition(0);
    TypefaceSpan ts = new TypefaceSpan(p);
     效果:

    22.UnderlineSpan

    UnderlineSpan,下划线样式,给一段文字加上下划线。构造函数:
    UnderlineSpan(): 无参构造。
    UnderlineSpan(Parcel src):一参构造, 与无参构造效果相同,构造中未对src做处理。源码:
    public UnderlineSpan(Parcel src) {
    }
    效果:

    23.URLSpan

    URLSpan,可以打开一个链接。两个构造函数:
    URLSpan(String url):参数url,链接地址。
    URLSpan(Parcel src):参数src,包含链接地址信息的包装类,使用如下:
    Parcel p = Parcel.obtain();
    p.writeString("http://www.sina.com.cn");
    p.setDataPosition(0);
    URLSpan us = new URLSpan(p);
    效果:


    四、标注:

    以上效果均在android2.3中测试,以后新增的几个类并未做说明,上面的类中还有几处使用的不甚明了的地方,希望能够尽快的完善。
    以上所有的效果均写在了一个APK里,源码已上传至Android文本样式

    下面的图片是我做的一个思维导图,方便大家梳理清楚思路。

    阅读原文


    当前位置: 传送门 ›› AppAdventure