com.xuexiang.xui.utils

Class ViewUtils

java.lang.Object

com.xuexiang.xui.utils.ViewUtils

public final class ViewUtils
extends java.lang.Object

控件工具类

Since:

2019/1/3 上午10:05

Author:

xuexiang

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ViewUtils.Direction 方向

Method Summary

Modifier and Type	Method and Description
static android.graphics.Rect	calculateViewScreenLocation(android.view.View view) 计算控件在屏幕上的坐标
static void	checkAppCompatTheme(android.content.Context context)
static void	clearAllViewLongClick(android.view.View view) 清除所有控件的长按事件
static void	clearValueAnimator(android.animation.Animator animator) 清除数值动画
static void	clearViewLongClick(android.view.View rootView, int... ids) 清除控件的长按事件
static void	expendTouchArea(android.view.View view, int expendSize) 扩展点击区域的范围
static android.view.animation.AlphaAnimation	fadeIn(android.view.View view, int duration, android.view.animation.Animation.AnimationListener listener) 对 View 做透明度变化的进场动画。
static android.view.animation.AlphaAnimation	fadeIn(android.view.View view, int duration, android.view.animation.Animation.AnimationListener listener, boolean isNeedAnimation) 对 View 做透明度变化的进场动画。
static android.view.animation.AlphaAnimation	fadeOut(android.view.View view, int duration, android.view.animation.Animation.AnimationListener listener) 对 View 做透明度变化的退场动画
static android.view.animation.AlphaAnimation	fadeOut(android.view.View view, int duration, android.view.animation.Animation.AnimationListener listener, boolean isNeedAnimation) 对 View 做透明度变化的退场动画
static android.view.View	findViewFromViewStub(android.view.View parentView, int viewStubId, int inflatedViewId) 把 ViewStub inflate 之后在其中根据 id 找 View
static android.view.View	findViewFromViewStub(android.view.View parentView, int viewStubId, int inflatedViewId, int inflateLayoutResId) inflate ViewStub 并返回对应的 View。
static int	generateViewId()
static android.view.View	getActivityRoot(android.app.Activity activity) 获取activity的根view
static void	getDescendantRect(android.view.ViewGroup parent, android.view.View descendant, android.graphics.Rect out) Retrieve the transformed bounding rect of an arbitrary descendant view.
static boolean	getIsLastLineSpacingExtraError() 判断是否需要对 LineSpacingExtra 进行额外的兼容处理 安卓 5.0 以下版本中，LineSpacingExtra 在最后一行也会产生作用，因此会多出一个 LineSpacingExtra 的空白，可以通过该方法判断后进行兼容处理 if (ViewUtils.getISLastLineSpacingExtraError()) { textView.bottomMargin = -3dp; } else { textView.bottomMargin = 0; }
static boolean	isListViewAlreadyAtBottom(android.widget.ListView listView) 判断 ListView 是否已经滚动到底部。
static void	playBackgroundBlinkAnimation(android.view.View v, int bgColor) 对 View 的做背景闪动的动画
static void	playViewBackgroundAnimation(android.view.View v, int bgColor, int[] alphaArray, int stepDuration)
static android.animation.Animator	playViewBackgroundAnimation(android.view.View v, int bgColor, int[] alphaArray, int stepDuration, java.lang.Runnable endAction) 对 View 做背景色变化的动作
static void	playViewBackgroundAnimation(android.view.View v, int startColor, int endColor, long duration)
static void	playViewBackgroundAnimation(android.view.View v, int startColor, int endColor, long duration, int repeatCount, int setAnimTagId, java.lang.Runnable endAction) 对 View 做背景色变化的动作
static void	requestApplyInsets(android.view.Window window) 触发window的insets的广播，使得view的fitSystemWindows得以生效
static void	safeSetImageViewSelected(android.widget.ImageView imageView, boolean selected)
static void	setBackground(android.view.View view, android.graphics.drawable.Drawable drawable)
static void	setBackgroundColorKeepPadding(android.view.View view, int color)
static void	setBackgroundKeepingPadding(android.view.View view, android.graphics.drawable.Drawable drawable)
static void	setBackgroundKeepingPadding(android.view.View view, int backgroundResId)
static void	setChecked(android.widget.CompoundButton view, boolean isCheck) 设置控件的选中状态
static void	setCheckedSilent(android.widget.CompoundButton view, boolean isCheck, android.widget.CompoundButton.OnCheckedChangeListener checkedChangeListener) 设置控件的选中状态【静默】
static void	setEnabled(android.view.View view, boolean enabled) 设置控件是否可用
static void	setImageDrawable(android.widget.ImageView view, android.graphics.drawable.Drawable drawable) 设置控件的图片资源
static void	setImageLevel(android.widget.ImageView view, int level) 设置图片的等级
static void	setImageResource(android.widget.ImageView view, int imageId) 设置控件的图片资源
static void	setImageTint(android.widget.ImageView view, android.content.res.ColorStateList tint) 给图片着色
static void	setImageUri(android.widget.ImageView view, java.lang.Object uri) 设置控件的图片资源
static android.graphics.ColorFilter	setImageViewTintColor(android.widget.ImageView imageView, int tintColor)
static void	setOnCheckedChangeListener(android.widget.CompoundButton view, android.widget.CompoundButton.OnCheckedChangeListener checkedChangeListener) 设置控件的选中监听
static void	setPadding(android.view.View view, int padding) 设置控件的padding
static void	setPaddingBottom(android.view.View view, int value) 对 View 设置 paddingBottom
static void	setPaddingEnd(android.view.View view, int value) 对 View 设置 paddingEnd
static void	setPaddingLeft(android.view.View view, int value) 对 View 设置 paddingLeft
static void	setPaddingRight(android.view.View view, int value) 对 View 设置 paddingRight
static void	setPaddingStart(android.view.View view, int value) 对 View 设置 paddingStart
static void	setPaddingTop(android.view.View view, int value) 对 View 设置 paddingTop
static void	setText(android.widget.TextView view, int textId) 设置控件的文字
static void	setText(android.widget.TextView view, java.lang.String text) 设置控件的文字
static void	setToolbarLayoutTextFont(CollapsingToolbarLayout collapsingToolbarLayout) 设置CollapsingToolbarLayout选项卡的字体
static void	setToolbarLayoutTextFont(CollapsingToolbarLayout collapsingToolbarLayout, android.graphics.Typeface typeface) 设置CollapsingToolbarLayout选项卡的字体
static void	setViewsFont(android.graphics.Typeface typeface, android.view.View... views) 设置控件的字体
static void	setViewsFont(android.view.View... views) 设置控件的字体
static void	setViewTextFont(android.view.View view, android.graphics.Typeface typeface) 设置控件的字体
static void	setVisibility(android.view.View view, boolean isShow) 设置控件的可见度
static void	setVisibility(android.view.View view, int visibility) 设置控件的可见度
static android.view.animation.TranslateAnimation	slideIn(android.view.View view, int duration, android.view.animation.Animation.AnimationListener listener, boolean isNeedAnimation, ViewUtils.Direction direction) 对 View 做上下位移的进场动画
static android.view.animation.TranslateAnimation	slideIn(android.view.View view, int duration, android.view.animation.Animation.AnimationListener listener, ViewUtils.Direction direction) 对 View 做上下位移的进场动画
static android.view.animation.TranslateAnimation	slideOut(android.view.View view, int duration, android.view.animation.Animation.AnimationListener listener, boolean isNeedAnimation, ViewUtils.Direction direction) 对 View 做上下位移的退场动画
static android.view.animation.TranslateAnimation	slideOut(android.view.View view, int duration, android.view.animation.Animation.AnimationListener listener, ViewUtils.Direction direction) 对 View 做上下位移的退场动画
static void	textColorId(android.widget.TextView view, int colorId) 设置控件的文字颜色

Methods inherited from class java.lang.Object

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

Method Detail

checkAppCompatTheme

public static void checkAppCompatTheme(android.content.Context context)

getActivityRoot

public static android.view.View getActivityRoot(android.app.Activity activity)

获取activity的根view

requestApplyInsets

public static void requestApplyInsets(android.view.Window window)

触发window的insets的广播，使得view的fitSystemWindows得以生效

setBackground

public static void setBackground(android.view.View view,
                                 android.graphics.drawable.Drawable drawable)

setBackgroundKeepingPadding

public static void setBackgroundKeepingPadding(android.view.View view,
                                               android.graphics.drawable.Drawable drawable)

setBackgroundKeepingPadding

public static void setBackgroundKeepingPadding(android.view.View view,
                                               int backgroundResId)

setBackgroundColorKeepPadding

public static void setBackgroundColorKeepPadding(android.view.View view,
                                                 int color)

playBackgroundBlinkAnimation

public static void playBackgroundBlinkAnimation(android.view.View v,
                                                int bgColor)

对 View 的做背景闪动的动画

playViewBackgroundAnimation

public static android.animation.Animator playViewBackgroundAnimation(android.view.View v,
                                                                     int bgColor,
                                                                     int[] alphaArray,
                                                                     int stepDuration,
                                                                     java.lang.Runnable endAction)

对 View 做背景色变化的动作

Parameters:

v - 做背景色变化的View

bgColor - 背景色

alphaArray - 背景色变化的alpha数组，如 int[]{255,0} 表示从纯色变化到透明

stepDuration - 每一步变化的时长

endAction - 动画结束后的回调

playViewBackgroundAnimation

public static void playViewBackgroundAnimation(android.view.View v,
                                               int bgColor,
                                               int[] alphaArray,
                                               int stepDuration)

playViewBackgroundAnimation

public static void playViewBackgroundAnimation(android.view.View v,
                                               int startColor,
                                               int endColor,
                                               long duration,
                                               int repeatCount,
                                               int setAnimTagId,
                                               java.lang.Runnable endAction)

对 View 做背景色变化的动作

Parameters:

v - 做背景色变化的View

startColor - 动画开始时 View 的背景色

endColor - 动画结束时 View 的背景色

duration - 动画总时长

repeatCount - 动画重复次数

setAnimTagId - 将动画设置tag给view,若为0则不设置

endAction - 动画结束后的回调

playViewBackgroundAnimation

public static void playViewBackgroundAnimation(android.view.View v,
                                               int startColor,
                                               int endColor,
                                               long duration)

generateViewId

public static int generateViewId()

fadeIn

public static android.view.animation.AlphaAnimation fadeIn(android.view.View view,
                                                           int duration,
                                                           android.view.animation.Animation.AnimationListener listener)

对 View 做透明度变化的进场动画。

相关方法 fadeOut(View, int, Animation.AnimationListener, boolean)

Parameters:

view - 做动画的 View

duration - 动画时长(毫秒)

listener - 动画回调

fadeIn

public static android.view.animation.AlphaAnimation fadeIn(android.view.View view,
                                                           int duration,
                                                           android.view.animation.Animation.AnimationListener listener,
                                                           boolean isNeedAnimation)

对 View 做透明度变化的进场动画。

相关方法 fadeOut(View, int, Animation.AnimationListener, boolean)

Parameters:

view - 做动画的 View

duration - 动画时长(毫秒)

listener - 动画回调

isNeedAnimation - 是否需要动画

fadeOut

public static android.view.animation.AlphaAnimation fadeOut(android.view.View view,
                                                            int duration,
                                                            android.view.animation.Animation.AnimationListener listener)

对 View 做透明度变化的退场动画

相关方法 fadeIn(View, int, Animation.AnimationListener, boolean)

Parameters:

view - 做动画的 View

duration - 动画时长(毫秒)

listener - 动画回调

fadeOut

public static android.view.animation.AlphaAnimation fadeOut(android.view.View view,
                                                            int duration,
                                                            android.view.animation.Animation.AnimationListener listener,
                                                            boolean isNeedAnimation)

对 View 做透明度变化的退场动画

相关方法 fadeIn(View, int, Animation.AnimationListener, boolean)

Parameters:

view - 做动画的 View

duration - 动画时长(毫秒)

listener - 动画回调

isNeedAnimation - 是否需要动画

clearValueAnimator

public static void clearValueAnimator(android.animation.Animator animator)

清除数值动画

Parameters:

animator -

calculateViewScreenLocation

public static android.graphics.Rect calculateViewScreenLocation(android.view.View view)

计算控件在屏幕上的坐标

Parameters:

view -

Returns:

slideIn

public static android.view.animation.TranslateAnimation slideIn(android.view.View view,
                                                                int duration,
                                                                android.view.animation.Animation.AnimationListener listener,
                                                                ViewUtils.Direction direction)

对 View 做上下位移的进场动画

相关方法 slideOut(View, int, Animation.AnimationListener, boolean, Direction)

Parameters:

view - 做动画的 View

duration - 动画时长(毫秒)

listener - 动画回调

direction - 进场动画的方向

Returns:

动画对应的 Animator 对象, 注意无动画时返回 null

slideIn

public static android.view.animation.TranslateAnimation slideIn(android.view.View view,
                                                                int duration,
                                                                android.view.animation.Animation.AnimationListener listener,
                                                                boolean isNeedAnimation,
                                                                ViewUtils.Direction direction)

对 View 做上下位移的进场动画

相关方法 slideOut(View, int, Animation.AnimationListener, boolean, Direction)

Parameters:

view - 做动画的 View

duration - 动画时长(毫秒)

listener - 动画回调

isNeedAnimation - 是否需要动画

direction - 进场动画的方向

Returns:

动画对应的 Animator 对象, 注意无动画时返回 null

slideOut

public static android.view.animation.TranslateAnimation slideOut(android.view.View view,
                                                                 int duration,
                                                                 android.view.animation.Animation.AnimationListener listener,
                                                                 ViewUtils.Direction direction)

对 View 做上下位移的退场动画

相关方法 slideIn(View, int, Animation.AnimationListener, boolean, Direction)

Parameters:

view - 做动画的 View

duration - 动画时长(毫秒)

listener - 动画回调

direction - 进场动画的方向

Returns:

动画对应的 Animator 对象, 注意无动画时返回 null

slideOut

public static android.view.animation.TranslateAnimation slideOut(android.view.View view,
                                                                 int duration,
                                                                 android.view.animation.Animation.AnimationListener listener,
                                                                 boolean isNeedAnimation,
                                                                 ViewUtils.Direction direction)

对 View 做上下位移的退场动画

相关方法 slideIn(View, int, Animation.AnimationListener, boolean, Direction)

Parameters:

view - 做动画的 View

duration - 动画时长(毫秒)

listener - 动画回调

isNeedAnimation - 是否需要动画

direction - 进场动画的方向

Returns:

动画对应的 Animator 对象, 注意无动画时返回 null

setVisibility

public static void setVisibility(android.view.View view,
                                 boolean isShow)

设置控件的可见度

Parameters:

view - 控件

isShow - 是否可见

setVisibility

public static void setVisibility(android.view.View view,
                                 int visibility)

设置控件的可见度

Parameters:

view - 控件

visibility -

setEnabled

public static void setEnabled(android.view.View view,
                              boolean enabled)

设置控件是否可用

Parameters:

view - 控件

enabled - 是否可用

setText

public static void setText(android.widget.TextView view,
                           java.lang.String text)

设置控件的文字

Parameters:

view - 控件

text - 文字

setText

public static void setText(android.widget.TextView view,
                           int textId)

设置控件的文字

Parameters:

view - 控件

textId - 文字资源

textColorId

public static void textColorId(android.widget.TextView view,
                               int colorId)

设置控件的文字颜色

Parameters:

view - 控件

colorId - 文字颜色

setImageResource

public static void setImageResource(android.widget.ImageView view,
                                    int imageId)

设置控件的图片资源

Parameters:

view - 控件

imageId - 图片资源ID

setImageDrawable

public static void setImageDrawable(android.widget.ImageView view,
                                    android.graphics.drawable.Drawable drawable)

设置控件的图片资源

Parameters:

view - 控件

drawable - 图片资源

setImageUri

public static void setImageUri(android.widget.ImageView view,
                               java.lang.Object uri)

设置控件的图片资源

Parameters:

view - 控件

uri - 图片资源

setImageLevel

public static void setImageLevel(android.widget.ImageView view,
                                 int level)

设置图片的等级

Parameters:

view - 控件

level - 图片等级

setImageTint

public static void setImageTint(android.widget.ImageView view,
                                android.content.res.ColorStateList tint)

给图片着色

Parameters:

view - 控件

tint - 着色

setChecked

public static void setChecked(android.widget.CompoundButton view,
                              boolean isCheck)

设置控件的选中状态

Parameters:

view - 控件

isCheck - 是否选中

setOnCheckedChangeListener

public static void setOnCheckedChangeListener(android.widget.CompoundButton view,
                                              android.widget.CompoundButton.OnCheckedChangeListener checkedChangeListener)

设置控件的选中监听

Parameters:

view - 控件

checkedChangeListener - 选中监听

setCheckedSilent

public static void setCheckedSilent(android.widget.CompoundButton view,
                                    boolean isCheck,
                                    android.widget.CompoundButton.OnCheckedChangeListener checkedChangeListener)

设置控件的选中状态【静默】

Parameters:

view - 控件

isCheck - 是否选中

checkedChangeListener - 选中监听

expendTouchArea

public static void expendTouchArea(android.view.View view,
                                   int expendSize)

扩展点击区域的范围

Parameters:

view - 需要扩展的元素，此元素必需要有父级元素

expendSize - 需要扩展的尺寸（以xp为单位的）

setPadding

public static void setPadding(android.view.View view,
                              int padding)

设置控件的padding

Parameters:

view - 控件

padding -

setPaddingLeft

public static void setPaddingLeft(android.view.View view,
                                  int value)

对 View 设置 paddingLeft

Parameters:

view - 需要被设置的 View

value - 设置的值

setPaddingStart

public static void setPaddingStart(android.view.View view,
                                   int value)

对 View 设置 paddingStart

Parameters:

view - 需要被设置的 View

value - 设置的值

setPaddingTop

public static void setPaddingTop(android.view.View view,
                                 int value)

对 View 设置 paddingTop

Parameters:

view - 需要被设置的 View

value - 设置的值

setPaddingRight

public static void setPaddingRight(android.view.View view,
                                   int value)

对 View 设置 paddingRight

Parameters:

view - 需要被设置的 View

value - 设置的值

setPaddingEnd

public static void setPaddingEnd(android.view.View view,
                                 int value)

对 View 设置 paddingEnd

Parameters:

view - 需要被设置的 View

value - 设置的值

setPaddingBottom

public static void setPaddingBottom(android.view.View view,
                                    int value)

对 View 设置 paddingBottom

Parameters:

view - 需要被设置的 View

value - 设置的值

getIsLastLineSpacingExtraError

public static boolean getIsLastLineSpacingExtraError()

判断是否需要对 LineSpacingExtra 进行额外的兼容处理 安卓 5.0 以下版本中，LineSpacingExtra 在最后一行也会产生作用，因此会多出一个 LineSpacingExtra 的空白，可以通过该方法判断后进行兼容处理 if (ViewUtils.getISLastLineSpacingExtraError()) { textView.bottomMargin = -3dp; } else { textView.bottomMargin = 0; }

findViewFromViewStub

public static android.view.View findViewFromViewStub(android.view.View parentView,
                                                     int viewStubId,
                                                     int inflatedViewId)

把 ViewStub inflate 之后在其中根据 id 找 View

Parameters:

parentView - 包含 ViewStub 的 View

viewStubId - 要从哪个 ViewStub 来 inflate

inflatedViewId - 最终要找到的 View 的 id

Returns:

id 为 inflatedViewId 的 View

findViewFromViewStub

public static android.view.View findViewFromViewStub(android.view.View parentView,
                                                     int viewStubId,
                                                     int inflatedViewId,
                                                     int inflateLayoutResId)

inflate ViewStub 并返回对应的 View。

safeSetImageViewSelected

public static void safeSetImageViewSelected(android.widget.ImageView imageView,
                                            boolean selected)

setImageViewTintColor

public static android.graphics.ColorFilter setImageViewTintColor(android.widget.ImageView imageView,
                                                                 int tintColor)

isListViewAlreadyAtBottom

public static boolean isListViewAlreadyAtBottom(android.widget.ListView listView)

判断 ListView 是否已经滚动到底部。

Parameters:

listView - 需要被判断的 ListView。

Returns:

ListView 已经滚动到底部则返回 true，否则返回 false。

getDescendantRect

public static void getDescendantRect(android.view.ViewGroup parent,
                                     android.view.View descendant,
                                     android.graphics.Rect out)

Retrieve the transformed bounding rect of an arbitrary descendant view. This does not need to be a direct child.

Parameters:

descendant - descendant view to reference

out - rect to set to the bounds of the descendant view

setViewTextFont

public static void setViewTextFont(android.view.View view,
                                   android.graphics.Typeface typeface)

设置控件的字体

Parameters:

view - 控件

typeface - 字体

setViewsFont

public static void setViewsFont(android.graphics.Typeface typeface,
                                android.view.View... views)

设置控件的字体

Parameters:

typeface - 字体

views - 控件集合

setViewsFont

public static void setViewsFont(android.view.View... views)

设置控件的字体

Parameters:

views - 控件集合

clearViewLongClick

public static void clearViewLongClick(android.view.View rootView,
                                      int... ids)

清除控件的长按事件

Parameters:

rootView - 根布局

ids - 需要清除的控件id集合

clearAllViewLongClick

public static void clearAllViewLongClick(android.view.View view)

清除所有控件的长按事件

Parameters:

view - 根布局

setToolbarLayoutTextFont

public static void setToolbarLayoutTextFont(CollapsingToolbarLayout collapsingToolbarLayout)

设置CollapsingToolbarLayout选项卡的字体

Parameters:

collapsingToolbarLayout - CollapsingToolbarLayout

setToolbarLayoutTextFont

public static void setToolbarLayoutTextFont(CollapsingToolbarLayout collapsingToolbarLayout,
                                            android.graphics.Typeface typeface)

设置CollapsingToolbarLayout选项卡的字体

Parameters:

collapsingToolbarLayout - CollapsingToolbarLayout

typeface - 字体