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属性
设置是否当文本为URL链接/email/电话号码/map时,文本显示为可点击的链接。可选值(none/web/email/phone/map/all)
如果设置,将自动执行输入值的拼写纠正。此处无效果,在显示输入法并输入的时候起作用。
指定getText()方式取得的文本类别。选项:
设置英文字母大写类型。此处无效果,需要弹出输入法才能看得到,参见EditView此属性说明。
设定光标为显示/隐藏,默认显示。
设置允许输入哪些字符。如“1234567890.+-*/% ()”
在text的下方输出一个drawable,如图片。如果指定一个颜色的话会把text的背景设为该颜色,并且同时和background使用时覆盖后者。
在text的左边输出一个drawable,如图片。
设置text与drawable(图片)的间隔,与drawableLeft、 drawableRight、drawableTop、drawableBottom一起使用,可设置为负数,单独使用没有效果。
在text的右边输出一个drawable。
在text的正上方输出一个drawable。
设置是否可编辑。
设置文本的额外的输入数据。
设置当文字过长时,该控件该如何显示。有如下值设置:
设置保存文本的内容以及光标的位置。
设置文本位置,如设置成“center”,文本将居中显示。
为空时显示的文字提示信息,可通过textColorHint设置提示信息的颜色。此属性在 EditView中使用,但是这里也可以用。
附加功能,设置右下角IME动作与编辑框相关的动作,如actionDone右下角将显示一个“完成”,而不设置默认是一个回车符号。这个在EditView中有详细说明,此处无用。
设置IME动作ID。
设置IME动作标签。
设置文本是否包含顶部和底部额外空白,默认为true。
为文本指定输入法,需要完全限定名(完整的包名)。例如:
com.google.android.inputmethod.pinyin,但是这里报错找不到。
设置文本的类型,用于帮助输入法显示合适的键盘类型。在EditView中再详细说明,这里无效果。
设置链接是否点击连接,即使设置了autoLink。
在ellipsize指定marquee的情况下,设置重复滚动的次数,当设置为marquee_forever时表示无限次。
设置TextView的宽度为N个字符的宽度。这里测试为一个汉字字符宽度
设置TextView的宽度为最长为N个字符的宽度。与ems同时使用时覆盖ems选项。
设置TextView的宽度为最短为N个字符的宽度。与ems同时使用时覆盖ems选项。
限制显示的文本长度,超出部分不显示。
设置文本的行数,设置两行就显示两行,即使第二行没有数据。
设置文本的最大显示行数,与width或者layout_width结合使用,超出部分自动换行,超出行数将不显示。
设置文本的最小行数,与lines类似。
设置行间距。
设置行间距的倍数。如“1.2”
如果被设置,该TextView有一个数字输入法。此处无用,设置后唯一效果是TextView有点击效果,此属性在EdtiView将详细说明。
以小点”.”显示文本
设置为电话号码的输入方式。
设置输入法选项,此处无用,在EditText将进一步讨论。
设置文本超出TextView的宽度的情况下,是否出现横拉条。
如果文本是可选择的,让他获取焦点而不是将光标移动为文本的开始位置或者末尾位置。 TextView中设置后无效果。
指定文本阴影的颜色,需要与shadowRadius一起使用。
设置阴影横向坐标开始位置。
设置阴影纵向坐标开始位置。
设置阴影的半径。设置为0.1就变成字体的颜色了,一般设置为3.0的效果比较好。
设置单行显示。如果和layout_width一起使用,当文本不能全部显示时,后面用“…”来表示。如
将只显示“t…”。如果不设置singleLine或者设置为false,文本将自动换行
设置显示文本.
设置文字外。如 “?android:attr/textAppearanceLargeInverse”这里引用的是系统自带的一个外观,?表示系统是否有这种外观,否 则使用默认的外观。可textAppearanceButton/textAppearanceInverse/textAppearanceLarge/textAppearanceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverse
设置文本颜色
被选中文字的底色,默认为蓝色
设置提示信息文字的颜色,默认为灰色。与hint一起使用。
文字链接的颜色.
设置文字之间间隔,默认为1.0f。
设置文字大小,推荐度量单位”sp”,如”15sp”
设置字形[bold(粗体) 0, italic(斜体) 1, bolditalic(又粗又斜) 2] 可以设置一个或多个,用“|”隔开
设置文本字体,必须是以下常量值之一:normal 0, sans 1, serif 2, monospace(等宽字体) 3]
设置文本区域的高度,支持度量单位:px(像素)/dp/sp/in/mm(毫米)
设置文本区域的最大高度
设置文本区域的最小高度
设置文本区域的宽度,支持度量单位:px(像素)/dp/sp/in/mm(毫米),与layout_width 的区别看这里。
设置文本区域的最大宽度
设置文本区域的最小宽度
(本文由沙海孤尘原创,欢迎关注,带你一起长知识!)
*请认真填写需求信息,我们会在24小时内与您取得联系。