public class Html
extends Object
java.lang.Object | |
↳ | android.text.Html |
此类将HTML字符串处理为可显示的样式文本。 并非所有的HTML标签都受支持。
Nested classes |
|
---|---|
interface |
Html.ImageGetter 检索HTML <img>标签的图像。 |
interface |
Html.TagHandler 遇到HTML标记时,通知解析器不知道如何解释。 |
Constants |
|
---|---|
int |
FROM_HTML_MODE_COMPACT
|
int |
FROM_HTML_MODE_LEGACY
|
int |
FROM_HTML_OPTION_USE_CSS_COLORS |
int |
FROM_HTML_SEPARATOR_LINE_BREAK_BLOCKQUOTE 表示<blockquote>元素内的文本默认与其他文本以一个换行符分隔的标志。 |
int |
FROM_HTML_SEPARATOR_LINE_BREAK_DIV 表示在<div>元素内部的文本将被默认与一个换行符分隔的其他文本。 |
int |
FROM_HTML_SEPARATOR_LINE_BREAK_HEADING 标志表示<h1>〜<h6>元素内的文本默认与其他文本以一个换行符分隔。 |
int |
FROM_HTML_SEPARATOR_LINE_BREAK_LIST 指示<ul>元素内的文本将被默认与一个换行符分隔的其他文本。 |
int |
FROM_HTML_SEPARATOR_LINE_BREAK_LIST_ITEM 指示<li>元素内部的文本将被默认与一个换行符分隔的其他文本。 |
int |
FROM_HTML_SEPARATOR_LINE_BREAK_PARAGRAPH 标志表示<p>元素中的文本将与其他文本分开,默认情况下使用一个换行符。 |
int |
TO_HTML_PARAGRAPH_LINES_CONSECUTIVE
|
int |
TO_HTML_PARAGRAPH_LINES_INDIVIDUAL
|
Public methods |
|
---|---|
static String |
escapeHtml(CharSequence text) 返回给定纯文本的HTML转义表示。 |
static Spanned |
fromHtml(String source, int flags) 从提供的HTML字符串中返回可显示的样式文本。 |
static Spanned |
fromHtml(String source, Html.ImageGetter imageGetter, Html.TagHandler tagHandler) 此方法在API级别24中已弃用。请改用 |
static Spanned |
fromHtml(String source, int flags, Html.ImageGetter imageGetter, Html.TagHandler tagHandler) 从提供的HTML字符串中返回可显示的样式文本。 |
static Spanned |
fromHtml(String source) 此方法在API级别24中已弃用。请改用 |
static String |
toHtml(Spanned text, int option) 返回提供的Spanned文本的HTML表示。 |
static String |
toHtml(Spanned text) 此方法在API级别24中已弃用。请改用 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
int FROM_HTML_MODE_COMPACT
fromHtml(String, int, ImageGetter, TagHandler)
标志:在fromHtml(String, int, ImageGetter, TagHandler)
用换行符(单个换行符)分隔块级元素。 这会将Spanned
转换为使用选项TO_HTML_PARAGRAPH_LINES_INDIVIDUAL
完成的HTML字符串转换。
常量值:63(0x0000003f)
int FROM_HTML_MODE_LEGACY
fromHtml(String, int, ImageGetter, TagHandler)
标志:用空行(两个换行符)分隔块级元素。 这是N之前的传统行为。
常量值:0(0x00000000)
int FROM_HTML_OPTION_USE_CSS_COLORS
表示应使用CSS颜色值的标志,而不是 Color
定义的 Color
。
常量值:256(0x00000100)
int FROM_HTML_SEPARATOR_LINE_BREAK_BLOCKQUOTE
表示<blockquote>元素内的文本默认与其他文本以一个换行符分隔的标志。
常量值:32(0x00000020)
int FROM_HTML_SEPARATOR_LINE_BREAK_DIV
表示在<div>元素内部的文本将被默认与一个换行符分隔的其他文本。
常量值:16(0x00000010)
int FROM_HTML_SEPARATOR_LINE_BREAK_HEADING
标志表示<h1>〜<h6>元素内的文本默认与其他文本以一个换行符分隔。
常量值:2(0x00000002)
int FROM_HTML_SEPARATOR_LINE_BREAK_LIST
指示<ul>元素内的文本将被默认与一个换行符分隔的其他文本。
常量值:8(0x00000008)
int FROM_HTML_SEPARATOR_LINE_BREAK_LIST_ITEM
指示<li>元素内部的文本将被默认与一个换行符分隔的其他文本。
常量值:4(0x00000004)
int FROM_HTML_SEPARATOR_LINE_BREAK_PARAGRAPH
标志表示<p>元素中的文本将与其他文本分开,默认情况下使用一个换行符。
常数值:1(0x00000001)
int TO_HTML_PARAGRAPH_LINES_CONSECUTIVE
toHtml(Spanned, int)
选项:在<p>元素内环绕由\ n分隔的连续文本行。 BulletSpan
被忽略。
常量值:0(0x00000000)
int TO_HTML_PARAGRAPH_LINES_INDIVIDUAL
toHtml(Spanned, int)
选项:将由\ n分隔的每行文本包装在<p>或<li>元素中。 这允许附加的ParagraphStyle
在相应的<p>或<li>元素内被编码为CSS样式。
常数值:1(0x00000001)
String escapeHtml (CharSequence text)
返回给定纯文本的HTML转义表示。
Parameters | |
---|---|
text |
CharSequence
|
Returns | |
---|---|
String |
Spanned fromHtml (String source, int flags)
从提供的HTML字符串中返回可显示的样式文本。 HTML中的任何<img>标签都将显示为一个通用的替换图像,然后程序可以通过并替换为真实图像。
这使用TagSoup来处理真正的HTML,包括野外发现的所有破碎。
Parameters | |
---|---|
source |
String
|
flags |
int
|
Returns | |
---|---|
Spanned |
Spanned fromHtml (String source, Html.ImageGetter imageGetter, Html.TagHandler tagHandler)
此方法在API级别24中已弃用。
改为使用fromHtml(String, int, ImageGetter, TagHandler)
。
从提供的HTML字符串中返回可显示样式的文本,其中包含旧标记 FROM_HTML_MODE_LEGACY
。
Parameters | |
---|---|
source |
String
|
imageGetter |
Html.ImageGetter
|
tagHandler |
Html.TagHandler
|
Returns | |
---|---|
Spanned |
Spanned fromHtml (String source, int flags, Html.ImageGetter imageGetter, Html.TagHandler tagHandler)
从提供的HTML字符串中返回可显示的样式文本。 HTML中的任何<img>标签都将使用指定的ImageGetter来请求图像的表示(如果不需要,则使用null)和指定的TagHandler处理未知标记(如果不需要,则指定null) 。
这使用TagSoup来处理真正的HTML,包括野外发现的所有破碎。
Parameters | |
---|---|
source |
String
|
flags |
int
|
imageGetter |
Html.ImageGetter
|
tagHandler |
Html.TagHandler
|
Returns | |
---|---|
Spanned |
Spanned fromHtml (String source)
此方法在API级别24中已弃用。
改为使用fromHtml(String, int)
。
从提供的HTML字符串中返回可显示样式的文本,其中包含旧标记 FROM_HTML_MODE_LEGACY
。
Parameters | |
---|---|
source |
String
|
Returns | |
---|---|
Spanned |
String toHtml (Spanned text, int option)
返回提供的Spanned文本的HTML表示。 尽最大努力添加对应于跨度的HTML标签。 另请注意,输入文本中的HTML元字符(例如“<”和“&”)会被转义。
Parameters | |
---|---|
text |
Spanned : input text to convert |
option |
int : one of TO_HTML_PARAGRAPH_LINES_CONSECUTIVE or TO_HTML_PARAGRAPH_LINES_INDIVIDUAL |
Returns | |
---|---|
String |
string containing input converted to HTML |
String toHtml (Spanned text)
此方法在API级别24中已弃用。
改为使用toHtml(Spanned, int)
。
Parameters | |
---|---|
text |
Spanned
|
Returns | |
---|---|
String |