安卓文本样式-Spannable的使用

    xiaoxiao2021-03-25  132

    http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2015/0120/2335.html

     

    编辑推荐:稀土掘金,这是一个针对技术开发者的一个应用,你可以在掘金上获取最新最优质的技术干货,不仅仅是Android知识、前端、后端以至于产品和设计都有涉猎,想成为全栈工程师的朋友不要错过!

    本文转载自 lixin84915的博客 Android文本样式  原文分为上下两部分,本文将上下整理成了一篇文章。

    在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中的<li>标签的圆点效果。该类有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); 效果:

    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文本样式

     

     

    转载请注明原文地址: https://ju.6miu.com/read-13882.html

    最新回复(0)