【UI篇】BEditText-圆角/多边阴影/描边/渐变色/一键清空/输入法弹出控制/......

一、功能介绍

为了能够更直观的让大家知道BEditText都能做什么，下面我列了一个功能列表，做一下简单描述；如下：

功能	描述
圆角	可以统一设置圆角角度，也可以四个角单独设置
描边	可以设置描边大小、颜色，可以隐藏任意边
阴影	可以设置阴影大小、颜色、偏移、距离、单边多边显示等
渐变色	可以设置文本渐变色、背景渐变色
辅助功能	支持一键清空 支持内容可见性切换&自定义图标 支持设置四周图标&自定义宽高 支持输入法控制
另类样式	支付密码输入样式、验证码输入样式等

下面详细说说各个功能的使用方法：

◆ 圆角

圆角演示.gif

XML设置	代码设置	描述
app:bsv_roundRadius="10dp"	setRoundradius(int radius)	设置四个角圆角值，优先级最高
app:bsv_topLeftRadius="10dp"	setTopLeftRoundRadius(int radius)	左上角圆角值
app:bsv_topRightRadius="10dp"	setTopRightRoundRadius(int radius)	右上角圆角值
app:bsv_bottomLeftRadius="10dp"	setBottomLeftRoundRadius(int radius)	左下角圆角值
app:bsv_bottomRightRadius="10dp"	setBottomRightRoundRadius(int radius)	左下角圆角值

如果设置了roundRadius的值默认会重置四个角度的值，以roundRadius为准

◆ 描边

描边演示.gif

XML设置	代码设置	描述
app:bsv_borderSize="3dp"	setBorderSize(float size)	设置描边尺寸
app:bsv_borderColor="#ff8585"	setBorderColor(int color)	设置描边颜色
app:bsv_borderHideEdges="left|top"	hideBorderEdges(int... edges)	设置需要隐藏的边,值为： left、top、right、bottom； 可以同时设置多个用|分隔 即可（代码设置的话， hideBorderEdges方法为 不定参，传多个参数即可; BorderBuilder.LEFT、 BorderBuilder.TOP、 BorderBuilder.RIGHT、 BorderBuilder.BOTTOM）

想要显示描边borderShow必须为true

◆ 阴影

阴影演示.gif

XML设置	代码设置	描述
app:bsv_shadowShow="true"	setShadowShow(boolean show)	设置是否展示阴影
app:bsv_shadowSize="3dp"	setShadowSize(float size)	设置阴影尺寸，优先级最高
app:bsv_shadowXSize="3dp"	setShadowXSize(float size)	可以单独设置横向阴影尺寸
app:bsv_shadowYSize="3dp"	setShadowYSize(float size)	可以单独设置纵向阴影尺寸
app:bsv_shadowDx="1dp"	setShadowDx(float dx)	设置横向的偏移值，默认0 视图在中心，左右阴影尺寸 相同
app:bsv_shadowDy="1dp"	setShadowDy(float dy)	设置纵向的偏移值，默认0 视图在中心，上下阴影尺寸 相同
app:bsv_shadowColor="#ff8585"	setShadowColor(int color)	设置阴影颜色
app:bsv_shadowAlpha="0.8"	setShadowAlpha(float alpha)	设置阴影透明度
app:bsv_shadowHideEdges="left|top"	hideShadowEdges(int... edges)	设置需要隐藏的边,值为： left、top、right、bottom； 可以同时设置多个用|分隔 即可（代码设置的话， hideShadowEdges方法为 不定参，传多个参数即可; ShadowBuilder.LEFT、 ShadowBuilder.TOP、 ShadowBuilder.RIGHT、 ShadowBuilder.BOTTOM）

想要显示描边shadowShow必须为true，如果设置了shadowSize的值默认会重置shadowXSize，shadowYSize的值，以shadowSize为准，四边阴影尺寸相同，想要横向纵向尺寸不同，只设置shadowXSize，shadowYSize即可。

◆ 渐变色

渐变色演示.gif

XML设置	代码设置	描述
app:bsv_backgroundGradientColor="#FF8585|#FF8B15"	setBackgroundGradientColor(String... colors)	设置背景渐变色，至少两个16进制颜色值； 代码设置方法为不定参，传多个参数16进制颜色值
app:bsv_backgroundGradientType="linear"	setBackgroundGradientType (GradientType type)	设置渐变类型，参数为： linear-线性 radial-圆环 sweep-角度 ------------------------- GradientType.LINEAR、 GradientType.RADIAL、 GradientType.SWEEP
app:bsv_backgroundGradientOrientation="horizontal"	setBackgroundGradientOrientation (GradientOrientation orientation)	设置渐变方向，参数为： horizontal-垂直 vertical-水平 diagonal-对角 ------------------------- GradientOrientation.HORIZONTAL、 GradientOrientation.VERTICAL、 GradientOrientation.DIAGONAL
app:bsv_textGradientColor="#FF8585|#FF8B15"	setBackgroundGradientColor(String... colors)	设置背景渐变色，至少两个16进制颜色值； 代码设置方法为不定参，传多个参数16进制颜色值
app:bsv_textGradientType="linear"	setTextGradientType (GradientType type)	设置渐变类型，参数同背景渐变类型相同
app:bsv_textGradientOrientation="horizontal"	setTextGradientOrientation (GradientOrientation orientation)	设置渐变方向，参数同背景渐变类型相同

☛ 由于渐变色需要在同一个属性下设置多个颜色，所以只能设置16进制颜色值，不能使用color下的颜色资源

背景渐变：

文本渐变：

◆ 辅助功能

一键清空&内容可见.jpg

1、一键清空

自带一键清空功能，当文本框有内容的时候自动显示出来，可以设置展示/隐藏，图标可更换；具体说明如下：

XML设置	代码设置	描述
app:bsv_showClearIcon="true"	showClearIcon(boolean show)	设置是否显示一键清空图标，默认true
app:bsv_clearIcon="@drawable/clear"	setClearIcon(int res)	设置一键清空按钮图标

2、内容可见性切换&自定义图标

支持自定义内容可见按钮功能，默认隐藏，可以设置展示/隐藏，图标可更换；具体说明如下：

XML设置	代码设置	描述
app:bsv_showSecretIcon="false"	showSecretIcon(boolean show)	设置是否显示内容可见控制图标，默认false
app:bsv_secretIconVisible="@drawable/visible" app:bsv_secretIcoInvisible="@drawable/invisible"	setSecretIcon(int visibe, int invisibe)	设置内容隐藏按钮图标

3、添加左右两侧图标&自定义宽高

XML设置	代码设置	描述
app:bsv_leftIcon="@drawable/icon" app:bsv_leftIconWidth="20dp" app:bsv_leftIconHeight="20dp" app:bsv_leftIconPadding="5dp"	addLeftIcon( Drawable drawable, int width, int height, int padding, OnClickListener listener )	添加左侧图标，代码添加支持多个
右侧同上（left-right）	addRightIcon	......

注意：
1、xml设置图标左右两个各自职能设置一个，点击事件通过代码设置setOnLeftIconClickListener，setOnRightIconClickListener来实现。
2、在代码添加两侧图标时可以添加多个，直接附带点击事件。

4、输入法控制

可以设置编辑模式,默认普通模式
【普通模式】
【不可编辑模式】
【可编辑不弹输入法】（有光标，一般用在语音录入）

温馨提示：

addTextChangedListener ———— addNewTextChangedListener
setOnTouchListener ———— setNewOnTouchListener
setOnFocusChangeListener ———— setNewOnFocusChangeListener

这几个监听需要调用新的方法再能生效。

二、使用方法

1、把maven { url 'https://jitpack.io' }这段代码添加到项目的build.gradle存储库末尾

  allprojects {
        repositories {
              ...
              maven { url 'https://www.jitpack.io' }
        }
  }

2、在需要用的主程序或Module下的build.gradle中引用

  dependencies {
        ...
        implementation 'com.github.barystudio:BSuperView:最新版本'
  }

点击下方↓↓↓ 查看最新版本

BSuperView 如果觉得有用欢迎Star、赞、赏 O(∩_∩)O

---

Bary Studio

更多内容都在【Android开发这些年，沉淀下了什么？】专题中

---