整合营销服务商

电脑端+手机端+微信端=数据同步管理

免费咨询热线:

TextView实现Android图文混排显示HTML内容

ndroid 中的 TextView 组件常用于显示文本内容,其实它也可以显示 HTML 的内容。简单来讲,这就需要先把 HTML 的内容以字符串的形式获取后,经过 android.text.Html.fromHtml()转化成 Spanned 的格式,然后将其传递到 TextView 的 setText()方法中,这样就可以在 TextView 中显示 HTML 页面的内容了。需要注意的是,并不是所有的 HTML 标签在 TextView 中都是支持的,且官方文档并没有明确的说明支持 HTML 标签列表,通过查看 Android 源代码,可以得到简单的支持列表。

{<br>,< p>,< div align=>,< strong>, <b>, <em>, <cite>, <dfn>, <i>, <big>, <small>, <font size=>,  <font color=>, <blockquote>, <tt>, <a href=>, <u>, <sup>, <sub>, <h1>,<h2>,<h3>,<h4>,<h5>,<h6>, <img src=>, <strike>}
1

下面的示例来介绍如何在 TextView 中显示一段 HTML 内容,要显示的这段 HTML 内容即包含超链接内容,也包含有图片。
在 TextView 中显示 HTML 内容

显示的过程中最主要的过程就是调用 Android.text.Html 类提供的 fromHtml()方法,将一段 HTML 内容转化为 Spanned 对象。

Android.text.Html 类提供的 fromHtml()方法使用如下清单 4
fromHtml()方法定义

public static Spanned fromHtml(String source, ImageGetter imageGetter,
    TagHandler tagHandler) {
        ……
HtmlToSpannedConverter converter =
new HtmlToSpannedConverter(source, imageGetter, tagHandler,  parser);
return converter.convert();
}
1234567

source,就是包含 HTML 内容的字符串。而 Html.ImageGetter 和 Html.TagHandler 是两个接口,提供给开发者继承使用。
imageGetter, 如果要显示图片是需要被继承的,重写 getDrawable(String source)方法,用于获取 HTML 里面的图片来显示在 TextView 中。
tagHandler,其作用是把 HTML 带标记的文本内容字符串转化成可以显示效果的的 Spanned 字符串 。由于并非所有的 HTML 标签都可以转化,所以在使用时,用户需要自己添加一些必要的标签和处理方法时才会继承使用的。

在本例中使用 fromHtml()方法之前,要准备好该方法要用的三个参数内容,首先将 HTML 字符串内容准备好,在项目中需要创建两个类 MImageGetter 和 MTagHandler 分别继承于 ImageGetter 和 TagHandler,分别用户图片的获取,和特殊标签的支持。
MImageGetter

继承于 ImageGetter,重写 getDrawable (String source) 方法中从 assets 路径下取出的图片流(这里当然也可以通过网络操作来完成图片流的获取),最后获得可供显示的图片对象,例如 Drawable 对像。由于 Android 设备的异构性,为了有更好的显示效果,通常需要获取屏幕大小,然后调用 drawable.setBounds () 还可以重新设置图片的大小, 最后返回合适大小的图片 Drawable 对象。 由此 Spanned 中的 ImageSpan 就获得了图像被显示在 TextView 中对应位置了。

TypedValue typedValue = new TypedValue();
typedValue.density = TypedValue.DENSITY_DEFAULT;
drawable = Drawable.createFromResourceStream(null, typedValue, is, "src");
DisplayMetrics dm = c.getResources().getDisplayMetrics();  
int dwidth = dm.widthPixels-10;//padding left + padding right
float dheight = (float)drawable.getIntrinsicHeight()*(float)dwidth/(float)drawable.getIntrinsicWidth();
int dh = (int)(dheight+0.5);
int wid = dwidth;
int hei = dh;
drawable.setBounds(0, 0, wid, hei);DisplayMetrics dm = c.getResources().getDisplayMetrics();
12345678910

MTagHandler

继承于 TagHandler,重写了 handleTag()方法,为的是支持部分标签,这四个标签是在 formHtml()方法中本身是不支持。如果开发者认为安卓 TagHandler 提供的默认标签解析已经够用,直接在 fromHtml()方法中第三个参数的地方填写 null 既可。
重写 handleTag()方法

public void handleTag(final boolean opening, final String tag, Editable output, final XMLReader xmlReader) {
if (tag.equals("ul") || tag.equals("ol") || tag.equals("dd")) {
    if (opening) {
    mListParents.add(tag);
    } else mListParents.remove(tag);
} else if (tag.equals("li") && !opening) {
     handleListTag(output);
}
}
private void handleListTag(Editable output) {
……
 }
123456789101112

最后,在完成了 MImageGetter、MTagHandler 以后,就可以通过 formHtml()方法将 HTML 内容转化为可供显示的 SpannableString,将 SpannableString 通过 setText 方法放入 TextView 中,就可以显示图文并茂的内容了。

progressBar.setVisibility(View.GONE);
text.setText(Html.fromHtml(htmlCont, new MImageGetter(text,MainActivity.this), new MTagHandler()));
text.setVisibility(View.VISIBLE);
123

MImageGetter、MTagHandler 如下:

extView不仅可以用于显示丰富的文本信息,还可以用来显示图文并茂的混排页面。

1.TextView常用属性

TextView的常用属性有以下一些:

Java方法说明XML配置
setText()设置文本内容android:text
setTextSize()设置文本字体大小android:textSize
setTextColor()设置文本颜色android:textColor
setBackgroundColor()设置背景颜色android:background

此外,还可以在xml中设置一些TextView的属性,PPT中有提供相关的属性介绍

XML设置属性说明
android:autoLink设置是否显示为可点击的链接。可选值(none/web/email/phone/map/all)
android:drawableBottom在text的下方输出一个drawable(图片)
android:drawableLeft在text的左边输出一个drawable(图片)
android:drawableRight在text的右边输出一个drawable(图片)
android:drawableTop在text的正上方输出一个drawable(图片)
android:drawablePadding设置text与drawable(图片)的间隔,与drawableLeft、drawableRight、drawableTop、

drawableBottom一起使用,可设置为负数,单独使用没有效果
android:ellipsize设置当文字过长时,该控件该如何显示。可设置如下属性值:"start"省略号显示在开头;

"end”省略号显示在结尾;"middle"省略号显示在中间; "marquee" 以跑马灯的方式显示(动画横向移动)
android:gravity设置文本位置,设置成"center",文本将居中显示
android:linksClickable设置点击时是否链接,即使设置了autoLink
android:marqueeRepeatLimit在ellipsize设定为marquee时,设置重复滚动的次数,设置为marquee_forever时表示无限次。
android:lines设置文本的行数,设置两行就显示两行,即使第二行没有数据
android:shadowRadius设置阴影的半径。设置为0.1就变成字体的颜色了,一般设置为3.0的效果比较好
android:shadowColor指定文本阴影的颜色,需要与shadowRadius一起使用
android:singleLine设置单行显示
android:textColorLink设置文字链接的颜色
android:textScaleX设置文字之间间隔,默认为1.0f
android:textStyle设置字形 bold(粗体) 0, italic(斜体) 1, bolditalic(又粗又斜) 2, 可以设置一个或多个,用“|”隔开
android:typeface设置文本字体,必须是以下常量值之一:normal 0, sans 1, serif 2, monospace(等宽字体) 3

1.TextView中设置多种字体大小

像这样的两种字体大小放到一个TextView中,我们应该如何处理呢?需要用到 android.text 命名空间下的一些与 spannable相关的类和接口。

代码如下:

public class TextViewActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_text_view); String text = "您已经连续走了1000步"; int start = text.indexOf("1"); int end = text.length(); //对字体大小进行设置 Spannable textSpan = new SpannableStringBuilder(text); textSpan.setSpan(new AbsoluteSizeSpan(16), 0, start, Spannable.SPAN_INCLUSIVE_INCLUSIVE); textSpan.setSpan(new AbsoluteSizeSpan(26), start, end - 1, Spannable.SPAN_INCLUSIVE_INCLUSIVE); textSpan.setSpan(new AbsoluteSizeSpan(16), end - 1, end, Spannable.SPAN_INCLUSIVE_INCLUSIVE); //获取元素对象 TextView tv = (TextView) findViewById(R.id.txt1); //赋值操作 tv.setText(textSpan); }}

2.TextView中设置超链接

这个比较简单,设置我们上边提到的android:autoLink属性,默认为none

代码中的设置方式:setAutoLinkMask(int)。

参数和上边列表对应,分别为:Linkify.WEB_URLS,Linkify.EMAIL_ADDRESSES,Linkify.PHONE_NUMBERS,Linkify.MAP_ADDRESSES,Linkify.ALL

但是需要注意的是,当我们需要定制超链接的跳转时应该怎么做?答案是还是选择Spannable。代码如下:

效果图

完整代码

package com.hanpang.textviewdemo;import android.content.Intent;import android.graphics.Color;import android.support.v7.app.AppCompatActivity;import android.os.Bundle;import android.text.Spannable;import android.text.SpannableString;import android.text.SpannableStringBuilder;import android.text.Spanned;import android.text.method.LinkMovementMethod;import android.text.style.AbsoluteSizeSpan;import android.text.style.ClickableSpan;import android.text.style.ForegroundColorSpan;import android.text.style.UnderlineSpan;import android.view.View;import android.widget.TextView;import android.widget.Toast;public class TextViewActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_text_view); TextView tv2 = (TextView) findViewById(R.id.txt2); //将TextView的显示文字设置为SpannableString tv2.setText(getClickableSpan()); //设置该句使文本的超连接起作用 tv2.setMovementMethod(LinkMovementMethod.getInstance()); } //设置超链接文字 private SpannableString getClickableSpan() { SpannableString spanStr = new SpannableString("使用该软件,即表示您同意该软件的使用条款和隐私政策"); //设置下划线文字 spanStr.setSpan(new UnderlineSpan(), 16, 20, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); //设置文字的单击事件 spanStr.setSpan(new ClickableSpan() { @Override public void onClick(View widget) { Toast.makeText(TextViewActivity.this,"点击了使用条款的连接",Toast.LENGTH_SHORT).show(); } }, 16, 20, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); //设置文字的前景色 spanStr.setSpan(new ForegroundColorSpan(Color.GREEN), 16, 20, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); //设置下划线文字 spanStr.setSpan(new UnderlineSpan(), 21, 25, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); //设置文字的单击事件 spanStr.setSpan(new ClickableSpan() { @Override public void onClick(View widget) { Toast.makeText(TextViewActivity.this,"点击了隐私政策的连接",Toast.LENGTH_SHORT).show(); } }, 21, 25, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); //设置文字的前景色 spanStr.setSpan(new ForegroundColorSpan(Color.GREEN), 21, 25, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); return spanStr; }}

3.TextView 设置阴影

简单了解一下 Android中设置阴影也比较简单,xml中可以这样设置:

android:shadowColor //指定文本阴影的颜色android:shadowDx //设置阴影横向坐标开始位置android:shadowDy //设置阴影纵向坐标开始位置android:shadowRadius //设置阴影的半径。设置为0.1会变成字体的颜色

代码中通过方法public void setShadowLayer (float radius, float dx, float dy, int color)来设置。

代码如下

 <TextView android:shadowColor="#FF0000" android:shadowDx="10.0" android:shadowDy="5.0" android:shadowRadius="2.5" android:text="我是胖先森" android:layout_width="match_parent" android:layout_height="wrap_content" android:id="@+id/textView3" />

4.字体加粗或者倾斜

在xml布局文件中使用android:textStyle=”bold”可以将文字设置成粗体。

在代码中设置的方法是:使用TextPaint的仿“粗体”设置setFakeBoldText为true。

tv.getPaint().setFakeBoldText(true);

textstyle可设置的属性有:

5.文字过长显示省略号或者跑马灯效果

android:maxEms="6" //限制显示的字符长度android:singleLine="true" //单行显示android:ellipsize="end"//在结尾用省略号

android:ellipsize设置当文字过长时,该控件该如何显示。有如下值设置:

  • ”start”—–省略号显示在开头;

  • ”end”——省略号显示在结尾;

  • ”middle”—-省略号显示在中间;

  • ”marquee” ——以跑马灯的方式显示(动画横向移动)

android:marqueeRepeatLimit 在ellipsize指定marquee的情况下,设置重复滚动的次数,当设置为marquee_forever时表示无限次。实现需要控件获得焦点。

 <TextView android:marqueeRepeatLimit="marquee_forever" android:ellipsize="marquee" android:singleLine="true" android:focusableInTouchMode="true" android:focusable="true" android:text="我是胖先森我是胖先森我是胖先森我是胖先森我是胖先森" android:layout_width="wrap_content" android:layout_height="wrap_content" android:id="@+id/textView3" />

效果图

6.TextView 设置行间距

1、android:lineSpacingExtra 设置行间距,如”3dp”。

2、android:lineSpacingMultiplier 设置行间距的倍数,如”1.2″。

7.TextView 关于字体

我们可以通过设置android:typeface属性来控制字体,可以设置为normal, sans, serif, monospace四种。具体如下:

代码中可以通过setTypeface(Typeface)方法设置。但有时候我们的App可能需要使用特殊的字体,这时候怎么办呢?可以通过如下代码设置:

Typeface mTypeFace = Typeface.createFromAsset(getAssets(), "kaiti.ttf");textview.setTypeface(mTypeFace);

然后将我们的字体文件放到assets文件夹下。

但是需要注意的是,不要大量使用这种自定义字体,因为自定义字体会消耗更多的性能。

8.TextView支持的Html标签

Textview只支持部分的html标签。具体如下:

<a href="..."> //定义链接内容<b> //定义粗体文字 b 是blod的缩写<big> //定义大字体的文字<blockquote> //引用块标签 <br> //定义换行<cite> //表示引用的URI<dfn> //定义标签 dfn 是defining instance的缩写<div align="..."><em> //强调标签 em 是emphasis的缩写<font size="..." color="..." face="..."><h1><h2><h3><h4><h5><h6><i> //定义斜体文字<img src="..."><p> // 段落标签,里面可以加入文字,列表,表格等<small> //定义小字体的文字<strike> // 定义删除线样式的文字 不符合标准网页设计的理念,不赞成使用. strike是strikethrough的缩写<strong> //重点强调标签<sub> //下标标签 sub 是subscript的缩写<sup> //上标标签 sup 是superscript的缩写<tt> //定义monospaced字体的文字 不赞成使用. 此标签对中文没意义 tt是teletype or monospaced text style的意思<u> //定义带有下划线的文字 u是underlined text style的意思

9.TextView 显示多种颜色的字

Android支持html格式的字符串,通过调用Html.fromHtml(str)方法可以转换html格式的字符串str。示例代码如下:

TextView textth = (TextView) findViewById(R.id.textth);String textStr1 = "<font color="\"#123569\"">如果有一天,</font>";String textStr2 = "<font color="\"#00ff00\"">我悄然离去</font>";textth.setText(Html.fromHtml(textStr1 + textStr2));

10.TextView 字体加粗

字体加粗还可以通过设置html格式字符串来实现

String textStr1 = "<b>sdfa</b>";textth.setText(Html.fromHtml(textStr1));

11.TextView 插入图片

插入图片还可以用html字符串来实现。不过需要用到ImageGetter类来对图片的src属性进行转换。

代码如下:

package com.hanpang.textviewdemo;public class TextViewActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_text_view); String imgStr = "<b>sdfa</b><br><img src='"+R.drawable.abc+"'>"; Html.ImageGetter imageGetter = new Html.ImageGetter() { @Override public Drawable getDrawable(String source) { int id = Integer.parseInt(source); Drawable draw = getResources().getDrawable(id); draw.setBounds(0, 0, 300, 200); return draw; } }; TextView tv = (TextView) findViewById(R.id.txt1); tv.append(Html.fromHtml(imgStr, imageGetter, null)); }}

12.TextView 添加分割线

<TextView android:layout_width="match_parent" android:layout_height="1dp" android:background="#000000" />

extView属性

  • android:autoLink

设置是否当文本为URL链接/email/电话号码/map时,文本显示为可点击的链接。可选值(none/web/email/phone/map/all)

  • android:autoText

如果设置,将自动执行输入值的拼写纠正。此处无效果,在显示输入法并输入的时候起作用。

  • android:bufferType

指定getText()方式取得的文本类别。选项:

  1. Editable:类似于StringBuilder可追加字符,也就是说getText后可调用append方法设置文本内容。
  2. Spannable:则可在给定的字符区域使用样式,参见这里1、这里2。
  • android:capitalize

设置英文字母大写类型。此处无效果,需要弹出输入法才能看得到,参见EditView此属性说明。

  • android:cursorVisible

设定光标为显示/隐藏,默认显示。

  • android:digits

设置允许输入哪些字符。如“1234567890.+-*/% ()”

  • android:drawableBottom

在text的下方输出一个drawable,如图片。如果指定一个颜色的话会把text的背景设为该颜色,并且同时和background使用时覆盖后者。

  • android:drawableLeft

在text的左边输出一个drawable,如图片。

  • android:drawablePadding

设置text与drawable(图片)的间隔,与drawableLeft、 drawableRight、drawableTop、drawableBottom一起使用,可设置为负数,单独使用没有效果。

  • android:drawableRight

在text的右边输出一个drawable。

  • android:drawableTop

在text的正上方输出一个drawable。

  • android:editable

设置是否可编辑。

  • android:editorExtras

设置文本的额外的输入数据。

  • android:ellipsize

设置当文字过长时,该控件该如何显示。有如下值设置:

  1. start—-省略号显示在开头;
  2. end—省略号显示在结尾;
  3. middle—省略号显示在中间;
  4. marquee—以跑马灯的方式显示(动画横向移动)
  • android:freezesText

设置保存文本的内容以及光标的位置。

  • android:gravity

设置文本位置,如设置成“center”,文本将居中显示。

  • android:hintText

为空时显示的文字提示信息,可通过textColorHint设置提示信息的颜色。此属性在 EditView中使用,但是这里也可以用。

  • android:imeOptions

附加功能,设置右下角IME动作与编辑框相关的动作,如actionDone右下角将显示一个“完成”,而不设置默认是一个回车符号。这个在EditView中有详细说明,此处无用。

  • android:imeActionId

设置IME动作ID。

  • android:imeActionLabel

设置IME动作标签。

  • android:includeFontPadding

设置文本是否包含顶部和底部额外空白,默认为true。

  • android:inputMethod

为文本指定输入法,需要完全限定名(完整的包名)。例如:

com.google.android.inputmethod.pinyin,但是这里报错找不到。

  • android:inputType

设置文本的类型,用于帮助输入法显示合适的键盘类型。在EditView中再详细说明,这里无效果。

  • android:linksClickable

设置链接是否点击连接,即使设置了autoLink。

  • android:marqueeRepeatLimit

在ellipsize指定marquee的情况下,设置重复滚动的次数,当设置为marquee_forever时表示无限次。

  • android:ems

设置TextView的宽度为N个字符的宽度。这里测试为一个汉字字符宽度

  • android:maxEms

设置TextView的宽度为最长为N个字符的宽度。与ems同时使用时覆盖ems选项。

  • android:minEms

设置TextView的宽度为最短为N个字符的宽度。与ems同时使用时覆盖ems选项。

  • android:maxLength

限制显示的文本长度,超出部分不显示。

  • android:lines

设置文本的行数,设置两行就显示两行,即使第二行没有数据。

  • android:maxLines

设置文本的最大显示行数,与width或者layout_width结合使用,超出部分自动换行,超出行数将不显示。

  • android:minLines

设置文本的最小行数,与lines类似。

  • android:lineSpacingExtra

设置行间距。

  • android:lineSpacingMultiplier

设置行间距的倍数。如“1.2”

  • android:numeric

如果被设置,该TextView有一个数字输入法。此处无用,设置后唯一效果是TextView有点击效果,此属性在EdtiView将详细说明。

  • android:password

以小点”.”显示文本

  • android:phoneNumber

设置为电话号码的输入方式。

  • android:privateImeOptions

设置输入法选项,此处无用,在EditText将进一步讨论。

  • android:scrollHorizontally

设置文本超出TextView的宽度的情况下,是否出现横拉条。

  • android:selectAllOnFocus

如果文本是可选择的,让他获取焦点而不是将光标移动为文本的开始位置或者末尾位置。 TextView中设置后无效果。

  • android:shadowColor

指定文本阴影的颜色,需要与shadowRadius一起使用。

  • android:shadowDx

设置阴影横向坐标开始位置。

  • android:shadowDy

设置阴影纵向坐标开始位置。

  • android:shadowRadius

设置阴影的半径。设置为0.1就变成字体的颜色了,一般设置为3.0的效果比较好。

  • android:singleLine

设置单行显示。如果和layout_width一起使用,当文本不能全部显示时,后面用“…”来表示。如

  1. android:text="test_ singleLine "
  2. android:singleLine="true"
  3. android:layout_width="20dp"

将只显示“t…”。如果不设置singleLine或者设置为false,文本将自动换行

  • android:text

设置显示文本.

  • android:textAppearance

设置文字外。如 “?android:attr/textAppearanceLargeInverse”这里引用的是系统自带的一个外观,?表示系统是否有这种外观,否 则使用默认的外观。可textAppearanceButton/textAppearanceInverse/textAppearanceLarge/textAppearanceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverse

  • android:textColor

设置文本颜色

  • android:textColorHighlight

被选中文字的底色,默认为蓝色

  • android:textColorHint

设置提示信息文字的颜色,默认为灰色。与hint一起使用。

  • android:textColorLink

文字链接的颜色.

  • android:textScaleX

设置文字之间间隔,默认为1.0f。

  • android:textSize

设置文字大小,推荐度量单位”sp”,如”15sp”

  • android:textStyle

设置字形[bold(粗体) 0, italic(斜体) 1, bolditalic(又粗又斜) 2] 可以设置一个或多个,用“|”隔开

  • android:typeface

设置文本字体,必须是以下常量值之一:normal 0, sans 1, serif 2, monospace(等宽字体) 3]

  • android:height

设置文本区域的高度,支持度量单位:px(像素)/dp/sp/in/mm(毫米)

  • android:maxHeight

设置文本区域的最大高度

  • android:minHeight

设置文本区域的最小高度

  • android:width

设置文本区域的宽度,支持度量单位:px(像素)/dp/sp/in/mm(毫米),与layout_width 的区别看这里。

  • android:maxWidth

设置文本区域的最大宽度

  • android:minWidth

设置文本区域的最小宽度

(本文由沙海孤尘原创,欢迎关注,带你一起长知识!)