diff --git a/README.md b/README.md index 64c00899d8ff0fbac656f7f27714e2331a45f2a8..c877a42fb2501ec3568672f77a993801bd7b507e 100644 --- a/README.md +++ b/README.md @@ -1 +1,155 @@ -# PowerfulViewLibrary \ No newline at end of file +# PowerfulViewLibrary +###PowerfulEditText具有的功能### + +####1.自带清除文本功能 #### +  PowerfulEditText自带清除文本功能,只需在布局文件该View属性中添加funcType,指定为canClear,就可以自带清除文本功能,使用如下: + + + + + + + + +运行后,效果如下: + +![](http://img-1252302110.costj.myqcloud.com/1.gif) + +  上图所示的删除图标是默认的,当然也可以指定右侧删除按钮的图标,只需添加多drawableRight属性,这里建议使用一个selector,分别为普通状态和按压状态设置一张图片,这样当按压图标的时候,会有一种按压的状态,selector的编写如下: + + + + + + + + + +####2.自带密码输入框切换明文密文格式的功能 #### + +  PowerfulEditText自带密码输入框切换明文密文格式的功能,目前大多数App密码输入栏一般支持密码明文、密文的显示,如果需要用到该功能,可以将funcType中指定为canWatchPwd,就可以轻松使用这种功能,使用如下: + + + +运行后,效果如下: + +![](http://img-1252302110.costj.myqcloud.com/%E8%8B%A5%E6%B0%B4GIF%E6%88%AA%E5%9B%BE_2017%E5%B9%B43%E6%9C%888%E6%97%A517%E7%82%B99%E5%88%8636%E7%A7%92.gif) + +  上图所示的右侧图标是默认的,同样也可以指定开启查看密码的图标和关闭查看密码的图标,只需要在属性eyeOpen中指定开启查看密码引用的图片,在eyeClosed中指定关闭查看密码引用的图片即可,如下,更换开启查看密码的图标,如项目默认的图标ic_launcher + + + +运行后,效果如下: + +![](http://img-1252302110.costj.myqcloud.com/%E8%8B%A5%E6%B0%B4GIF%E6%88%AA%E5%9B%BE_2017%E5%B9%B43%E6%9C%888%E6%97%A517%E7%82%B912%E5%88%8652%E7%A7%92.gif) + +这样开启查看密码的图标就更换了,如果还需要更换关闭密码查看的图标,可以指定eyeClose,引用对应的图标。 + +####3.设置drawableLeft和drawableRight图片大小的功能 #### +  原生的EditText并不能在属性中指定drawableLeft或drawableRight图片的大小,所以一般开发的过程中,一些程序员会采用简单粗暴的方法,直接引用一张宽高都很小的图片。但是在不同屏幕分辨率下,兼容性就不是很好,比如在一些屏幕分辨率较高的手机上运行,图标会显得模糊。PowerfulEditText可以指定drawableLeft和drawableRight图片的宽高大小,可以指定为多少个dp,这样在开发的时候,可以在各个分辨率图片文件夹中放入不同尺寸的图标,通过设定图片的宽高属性来限制显示的大小,下面演示一下: + + + + +![](http://img-1252302110.costj.myqcloud.com/4.jpg) + +  如图,指定了drawableLeft的图片为ic_laucher,图片看起来比较大,这时如果我们想要将其调小,则可以添加leftDrawableWidth、leftDrawableHeight指定左侧图片的宽高。 + + + + +上面代码,指定了leftDrawableWidth和leftDrawableHeight的大小都为30dp,运行的效果如下: + +![](http://img-1252302110.costj.myqcloud.com/5.jpg) + +可以看到左侧的图标变小了,同样也可以设置右侧图片的宽高,对应的属性是rightDrawableWidth、rightDrawableHeight。 + + +####右侧图标点击事件#### +PowerfulEditText同样支持右侧图片的点击事件,如果funcType指定为canClear,则默认点击是清除文本。如果需要进行一些额外的操作,则可以设置回调,比如搜索输入框,右侧是一个搜索的按钮,需要为其设置点击事件的回调。 + +布局文件: + + + +Activity + + PowerfulEditText petUsername = (PowerfulEditText) findViewById(R.id.pet); + petUsername.setOnRightClickListener(new PowerfulEditText.OnRightClickListener() { + @Override + public void onClick(EditText editText) { + String content = editText.getText().toString().trim(); + if (!TextUtils.isEmpty(content)){ + Toast.makeText(MainActivity.this, "执行搜索逻辑", Toast.LENGTH_SHORT).show(); + } + } + }); + +运行效果如下: + +![](http://img-1252302110.costj.myqcloud.com/2017%E5%B9%B43%E6%9C%889%E6%97%A511%E7%82%B950%E5%88%8638%E7%A7%92.gif) + + +  上面布局文件中,和普通的EditText属性一样,funcType一共有三个属性,分别是normal(默认)、canClear(带清除功能)、canWatchPwd(带查看密码功能)。如果不指定funcType,则默认是normal,普通方式。 + +  Activity中,为PowerfulEditText设置右侧图片的点击事件,调用setOnRightClickListener设置点击后的回调,这里点击后如果有文本内容,则执行搜索逻辑。 + +####导入方式#### +在项目根目录下的build.gradle中的allprojects{}中,添加jitpack仓库地址,如下: + + allprojects { + repositories { + jcenter() + maven { url 'https://jitpack.io' }//添加jitpack仓库地址 + } + } + +打开app的module中的build.gradle,在dependencies{}中,添加依赖,如下: + + dependencies { + ...... + compile 'com.github.chaychan:PowerfulViewLibrary:1.0' + } + +  这样就可以使用PowerfulViewLibrary下的控件了,目前只对EditText的一些功能进行了封装,往后会把一些常用的View进行封装,方便项目的开发,我会保持对PowerfulViewLibrary的更新和维护的,也希望大家可以向我提出一些建议。 \ No newline at end of file