com.xuexiang.xui.utils

Class SpanUtils

java.lang.Object

com.xuexiang.xui.utils.SpanUtils

public final class SpanUtils
extends java.lang.Object

SpannableString相关工具类

Since:

2019/1/14 下午10:03

Author:

xuexiang

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SpanUtils.Align

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALIGN_BASELINE
static int	ALIGN_BOTTOM
static int	ALIGN_CENTER
static int	ALIGN_TOP

Constructor Summary

Constructors

Constructor and Description
SpanUtils()

Method Summary

Modifier and Type	Method and Description
SpanUtils	append(java.lang.CharSequence text) 追加样式字符串
SpanUtils	appendImage(android.graphics.Bitmap bitmap) 追加图片
SpanUtils	appendImage(android.graphics.Bitmap bitmap, int align) 追加图片
SpanUtils	appendImage(android.graphics.drawable.Drawable drawable) 追加图片
SpanUtils	appendImage(android.graphics.drawable.Drawable drawable, int align) 追加图片
SpanUtils	appendImage(int resourceId) 追加图片
SpanUtils	appendImage(int resourceId, int align) 追加图片
SpanUtils	appendImage(android.net.Uri uri) 追加图片
SpanUtils	appendImage(android.net.Uri uri, int align) 追加图片
SpanUtils	appendLine() 追加一行
SpanUtils	appendLine(java.lang.CharSequence text) 追加一行样式字符串
SpanUtils	appendSpace(int size) 追加空白
SpanUtils	appendSpace(int size, int color) 追加空白
android.text.SpannableStringBuilder	create() 创建样式字符串
SpanUtils	setAlign(android.text.Layout.Alignment alignment) 设置对齐
SpanUtils	setBackgroundColor(int color) 设置背景色
SpanUtils	setBlur(float radius, android.graphics.BlurMaskFilter.Blur style) 设置模糊
SpanUtils	setBold() 设置粗体
SpanUtils	setBoldItalic() 设置粗斜体
SpanUtils	setBullet(int gapWidth) 设置列表标记
SpanUtils	setBullet(int color, int radius, int gapWidth) 设置列表标记
SpanUtils	setClickSpan(android.text.style.ClickableSpan clickSpan) 设置点击事件
SpanUtils	setFlag(int flag) 设置标识
SpanUtils	setFontFamily(java.lang.String fontFamily) 设置字体系列
SpanUtils	setFontProportion(float proportion) 设置字体比例
SpanUtils	setFontSize(int size) 设置字体尺寸
SpanUtils	setFontSize(int size, boolean isDp) 设置字体尺寸
SpanUtils	setFontXProportion(float proportion) 设置字体横向比例
SpanUtils	setForegroundColor(int color) 设置前景色
SpanUtils	setIconMargin(android.graphics.Bitmap bitmap) 设置图标
SpanUtils	setIconMargin(android.graphics.Bitmap bitmap, int gapWidth, int align) 设置图标
SpanUtils	setIconMargin(android.graphics.drawable.Drawable drawable) 设置图标
SpanUtils	setIconMargin(android.graphics.drawable.Drawable drawable, int gapWidth, int align) 设置图标
SpanUtils	setIconMargin(int resourceId) 设置图标
SpanUtils	setIconMargin(int resourceId, int gapWidth, int align) 设置图标
SpanUtils	setIconMargin(android.net.Uri uri) 设置图标
SpanUtils	setIconMargin(android.net.Uri uri, int gapWidth, int align) 设置图标
SpanUtils	setItalic() 设置斜体
SpanUtils	setLeadingMargin(int first, int rest) 设置缩进
SpanUtils	setLineHeight(int lineHeight) 设置行高
SpanUtils	setLineHeight(int lineHeight, int align) 设置行高
SpanUtils	setQuoteColor(int color) 设置引用线的颜色
SpanUtils	setQuoteColor(int color, int stripeWidth, int gapWidth) 设置引用线的颜色
SpanUtils	setShader(android.graphics.Shader shader) 设置着色器
SpanUtils	setShadow(float radius, float dx, float dy, int shadowColor) 设置阴影
SpanUtils	setSpans(java.lang.Object... spans) 设置样式
SpanUtils	setStrikethrough() 设置删除线
SpanUtils	setSubscript() 设置下标
SpanUtils	setSuperscript() 设置上标
SpanUtils	setTypeface(android.graphics.Typeface typeface) 设置字体
SpanUtils	setUnderline() 设置下划线
SpanUtils	setUrl(java.lang.String url) 设置超链接

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ALIGN_BOTTOM

public static final int ALIGN_BOTTOM

See Also:

Constant Field Values

ALIGN_BASELINE

public static final int ALIGN_BASELINE

See Also:

Constant Field Values

ALIGN_CENTER

public static final int ALIGN_CENTER

See Also:

Constant Field Values

ALIGN_TOP

public static final int ALIGN_TOP

See Also:

Constant Field Values

Constructor Detail

SpanUtils

public SpanUtils()

Method Detail

setFlag

public SpanUtils setFlag(int flag)

设置标识

Parameters:

flag -

• Spanned.SPAN_INCLUSIVE_EXCLUSIVE
• Spanned.SPAN_INCLUSIVE_INCLUSIVE
• Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
• Spanned.SPAN_EXCLUSIVE_INCLUSIVE

Returns:

SpanUtils

setForegroundColor

public SpanUtils setForegroundColor(int color)

设置前景色

Parameters:

color - 前景色

Returns:

SpanUtils

setBackgroundColor

public SpanUtils setBackgroundColor(int color)

设置背景色

Parameters:

color - 背景色

Returns:

SpanUtils

setLineHeight

public SpanUtils setLineHeight(int lineHeight)

设置行高

当行高大于字体高度时，字体在行中的位置默认居中

Parameters:

lineHeight - 行高

Returns:

SpanUtils

setLineHeight

public SpanUtils setLineHeight(int lineHeight,
                               int align)

设置行高

当行高大于字体高度时，字体在行中的位置由align决定

Parameters:

lineHeight - 行高

align - 对齐

• ALIGN_TOP顶部对齐
• ALIGN_CENTER居中对齐
• ALIGN_BOTTOM底部对齐

Returns:

SpanUtils

setQuoteColor

public SpanUtils setQuoteColor(int color)

设置引用线的颜色

Parameters:

color - 引用线的颜色

Returns:

SpanUtils

setQuoteColor

public SpanUtils setQuoteColor(int color,
                               int stripeWidth,
                               int gapWidth)

设置引用线的颜色

Parameters:

color - 引用线的颜色

stripeWidth - 引用线线宽

gapWidth - 引用线和文字间距

Returns:

SpanUtils

setLeadingMargin

public SpanUtils setLeadingMargin(int first,
                                  int rest)

设置缩进

Parameters:

first - 首行缩进

rest - 剩余行缩进

Returns:

SpanUtils

setBullet

public SpanUtils setBullet(int gapWidth)

设置列表标记

Parameters:

gapWidth - 列表标记和文字间距离

Returns:

SpanUtils

setBullet

public SpanUtils setBullet(int color,
                           int radius,
                           int gapWidth)

设置列表标记

Parameters:

color - 列表标记的颜色

radius - 列表标记颜色

gapWidth - 列表标记和文字间距离

Returns:

SpanUtils

setIconMargin

public SpanUtils setIconMargin(android.graphics.Bitmap bitmap)

设置图标

默认0边距，居中对齐

Parameters:

bitmap - 图标bitmap

Returns:

SpanUtils

setIconMargin

public SpanUtils setIconMargin(android.graphics.Bitmap bitmap,
                               int gapWidth,
                               int align)

设置图标

Parameters:

bitmap - 图标bitmap

gapWidth - 图标和文字间距离

align - 对齐

• ALIGN_TOP顶部对齐
• ALIGN_CENTER居中对齐
• ALIGN_BOTTOM底部对齐

Returns:

SpanUtils

setIconMargin

public SpanUtils setIconMargin(android.graphics.drawable.Drawable drawable)

设置图标

默认0边距，居中对齐

Parameters:

drawable - 图标drawable

Returns:

SpanUtils

setIconMargin

public SpanUtils setIconMargin(android.graphics.drawable.Drawable drawable,
                               int gapWidth,
                               int align)

设置图标

Parameters:

drawable - 图标drawable

gapWidth - 图标和文字间距离

align - 对齐

• ALIGN_TOP顶部对齐
• ALIGN_CENTER居中对齐
• ALIGN_BOTTOM底部对齐

Returns:

SpanUtils

setIconMargin

public SpanUtils setIconMargin(android.net.Uri uri)

设置图标

默认0边距，居中对齐

Parameters:

uri - 图标uri

Returns:

SpanUtils

setIconMargin

public SpanUtils setIconMargin(android.net.Uri uri,
                               int gapWidth,
                               int align)

设置图标

Parameters:

uri - 图标uri

gapWidth - 图标和文字间距离

align - 对齐

• ALIGN_TOP顶部对齐
• ALIGN_CENTER居中对齐
• ALIGN_BOTTOM底部对齐

Returns:

SpanUtils

setIconMargin

public SpanUtils setIconMargin(int resourceId)

设置图标

默认0边距，居中对齐

Parameters:

resourceId - 图标resourceId

Returns:

SpanUtils

setIconMargin

public SpanUtils setIconMargin(int resourceId,
                               int gapWidth,
                               int align)

设置图标

Parameters:

resourceId - 图标resourceId

gapWidth - 图标和文字间距离

align - 对齐

• ALIGN_TOP顶部对齐
• ALIGN_CENTER居中对齐
• ALIGN_BOTTOM底部对齐

Returns:

SpanUtils

setFontSize

public SpanUtils setFontSize(int size)

设置字体尺寸

Parameters:

size - 尺寸

Returns:

SpanUtils

setFontSize

public SpanUtils setFontSize(int size,
                             boolean isDp)

设置字体尺寸

Parameters:

size - 尺寸

isDp - 是否使用dip

Returns:

SpanUtils

setFontProportion

public SpanUtils setFontProportion(float proportion)

设置字体比例

Parameters:

proportion - 比例

Returns:

SpanUtils

setFontXProportion

public SpanUtils setFontXProportion(float proportion)

设置字体横向比例

Parameters:

proportion - 比例

Returns:

SpanUtils

setStrikethrough

public SpanUtils setStrikethrough()

设置删除线

Returns:

SpanUtils

setUnderline

public SpanUtils setUnderline()

设置下划线

Returns:

SpanUtils

setSuperscript

public SpanUtils setSuperscript()

设置上标

Returns:

SpanUtils

setSubscript

public SpanUtils setSubscript()

设置下标

Returns:

SpanUtils

setBold

public SpanUtils setBold()

设置粗体

Returns:

SpanUtils

setItalic

public SpanUtils setItalic()

设置斜体

Returns:

SpanUtils

setBoldItalic

public SpanUtils setBoldItalic()

设置粗斜体

Returns:

SpanUtils

setFontFamily

public SpanUtils setFontFamily(java.lang.String fontFamily)

设置字体系列

Parameters:

fontFamily - 字体系列

• monospace
• serif
• sans-serif

Returns:

SpanUtils

setTypeface

public SpanUtils setTypeface(android.graphics.Typeface typeface)

设置字体

Parameters:

typeface - 字体

Returns:

SpanUtils

setAlign

public SpanUtils setAlign(android.text.Layout.Alignment alignment)

设置对齐

Parameters:

alignment - 对其方式

• Layout.Alignment.ALIGN_NORMAL正常
• Layout.Alignment.ALIGN_OPPOSITE相反
• Layout.Alignment.ALIGN_CENTER居中

Returns:

SpanUtils

setClickSpan

public SpanUtils setClickSpan(android.text.style.ClickableSpan clickSpan)

设置点击事件

需添加view.setMovementMethod(LinkMovementMethod.getInstance())

Parameters:

clickSpan - 点击事件

Returns:

SpanUtils

setUrl

public SpanUtils setUrl(java.lang.String url)

设置超链接

需添加view.setMovementMethod(LinkMovementMethod.getInstance())

Parameters:

url - 超链接

Returns:

SpanUtils

setBlur

public SpanUtils setBlur(float radius,
                         android.graphics.BlurMaskFilter.Blur style)

设置模糊

尚存bug，其他地方存在相同的字体的话，相同字体出现在之前的话那么就不会模糊，出现在之后的话那会一起模糊

以上bug关闭硬件加速即可

Parameters:

radius - 模糊半径（需大于0）

style - 模糊样式

• BlurMaskFilter.Blur.NORMAL
• BlurMaskFilter.Blur.SOLID
• BlurMaskFilter.Blur.OUTER
• BlurMaskFilter.Blur.INNER

Returns:

SpanUtils

setShader

public SpanUtils setShader(android.graphics.Shader shader)

设置着色器

Parameters:

shader - 着色器

Returns:

SpanUtils

setShadow

public SpanUtils setShadow(float radius,
                           float dx,
                           float dy,
                           int shadowColor)

设置阴影

Parameters:

radius - 阴影半径

dx - x轴偏移量

dy - y轴偏移量

shadowColor - 阴影颜色

Returns:

SpanUtils

setSpans

public SpanUtils setSpans(java.lang.Object... spans)

设置样式

Parameters:

spans - 样式

Returns:

SpanUtils

append

public SpanUtils append(java.lang.CharSequence text)

追加样式字符串

Parameters:

text - 样式字符串文本

Returns:

SpanUtils

appendLine

public SpanUtils appendLine()

追加一行

Returns:

SpanUtils

appendLine

public SpanUtils appendLine(java.lang.CharSequence text)

追加一行样式字符串

Returns:

SpanUtils

appendImage

public SpanUtils appendImage(android.graphics.Bitmap bitmap)

追加图片

Parameters:

bitmap - 图片位图

Returns:

SpanUtils

appendImage

public SpanUtils appendImage(android.graphics.Bitmap bitmap,
                             int align)

追加图片

Parameters:

bitmap - 图片位图

align - 对齐

• ALIGN_TOP顶部对齐
• ALIGN_CENTER居中对齐
• ALIGN_BASELINE基线对齐
• ALIGN_BOTTOM底部对齐

Returns:

SpanUtils

appendImage

public SpanUtils appendImage(android.graphics.drawable.Drawable drawable)

追加图片

Parameters:

drawable - 图片资源

Returns:

SpanUtils

appendImage

public SpanUtils appendImage(android.graphics.drawable.Drawable drawable,
                             int align)

追加图片

Parameters:

drawable - 图片资源

align - 对齐

• ALIGN_TOP顶部对齐
• ALIGN_CENTER居中对齐
• ALIGN_BASELINE基线对齐
• ALIGN_BOTTOM底部对齐

Returns:

SpanUtils

appendImage

public SpanUtils appendImage(android.net.Uri uri)

追加图片

Parameters:

uri - 图片uri

Returns:

SpanUtils

appendImage

public SpanUtils appendImage(android.net.Uri uri,
                             int align)

追加图片

Parameters:

uri - 图片uri

align - 对齐

• ALIGN_TOP顶部对齐
• ALIGN_CENTER居中对齐
• ALIGN_BASELINE基线对齐
• ALIGN_BOTTOM底部对齐

Returns:

SpanUtils

appendImage

public SpanUtils appendImage(int resourceId)

追加图片

Parameters:

resourceId - 图片资源id

Returns:

SpanUtils

appendImage

public SpanUtils appendImage(int resourceId,
                             int align)

追加图片

Parameters:

resourceId - 图片资源id

align - 对齐

Returns:

SpanUtils

appendSpace

public SpanUtils appendSpace(int size)

追加空白

Parameters:

size - 间距

Returns:

SpanUtils

appendSpace

public SpanUtils appendSpace(int size,
                             int color)

追加空白

Parameters:

size - 间距

color - 颜色

Returns:

SpanUtils

create

public android.text.SpannableStringBuilder create()

创建样式字符串

Returns:

样式字符串