当Toast遇上色彩:Android第三方库Crouton学习笔记

Toast大家都不会陌生,就是经常在界面上弹出的带有提示信息的半透明文字框,它短暂出现后就会慢慢变淡消失。与Toast具有相同作用的还有Crouton,这是一个外国人写的第三方库,跟Toast相同,一个界面一次只能出现一个Crouton。但与Toast淡出淡入的动画效果不同,
它一般是从布局的顶部滑入和滑出的,而且与灰不溜秋的Toast相比,它有多种色彩可供选择。Toast是“吐司”的英文,Crouton则是“油煎面包块”的意思,听名字就知道这两个是哥们了。

言归正传,我们现在就来学习一下Crouton的使用。

1、准备工作

要想使用Crouton,只需在用Android Studio创建好工程之后,打开build.gradle文件,添加以下的依赖库:

    compile('de.keyboardsurfer.android.widget:crouton:1.8.5@aar') {
        // exclusion is not necessary, but generally a good idea.
        exclude group: 'com.google.android', module: 'support-v4'
    }

2、创建Crouton的最简方法(在根布局弹出Crouton)

跟它的兄弟一样,Crouton也需要调用makeText方法来输入内容,然后再调用show方法显示到界面上:

           /**1、根布局弹出Crouton**/
                Crouton.makeText(this, //上下文
                        "根布局的Crouton", //Crouton要显示的文字
                        Style.INFO, //Crouton的样式
                        R.id.rl_root) //显示Crouton的布局ID,不写时默认为根布局
                        .show();

上面的每个参数我都写了注释了。其中第三个参数使用了Crouton提供的三种样式中的一种,三种样式如下图所示:
当Toast遇上色彩:Android第三方库Crouton学习笔记_第1张图片
第四个参数可以不写,不写时默认显示在根布局。

运行后的效果如下:
当Toast遇上色彩:Android第三方库Crouton学习笔记_第2张图片

3、在子布局上弹出Crouton

由2可知,通过充分利用makeText方法中的参数4,我们可以在任意子布局上显示Crouton,就像下面这样(灰色区域为一个RelativeLayout):

        Crouton.makeText(this, "子布局的Crouton", Style.ALERT, R.id.rl_child).show();

当Toast遇上色彩:Android第三方库Crouton学习笔记_第3张图片

4、自定义Crouton

上面区区三种样式怎么能满足我们呢?假如我们需要制作一个图文并茂的Crouton的话,大家首先想到可能是自己写一个布局。Crouton确实是支持自定义布局的,我们可以先写一个布局:
custom_crouton.xml

"1.0" encoding="utf-8"?>
"http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    "center"
        android:background="@android:color/holo_blue_dark"
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="50dp">

        "wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center_vertical"
            android:layout_marginLeft="20dp"
            android:src="@mipmap/clock" />

        "5dp"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center_vertical"
            android:text="快起床写代码了!"
            android:textColor="@android:color/white"
            android:textSize="20sp" />
    

大家也许会觉得最外层的RelativeLayout有点多余,但是我试过去掉它之后,LinearLayout的高度值就不起作用了,具体原因我也不明白……

接下来就要用到Crouton类中的另一个静态方法make来构造Crouton,它的用法也很简单,只要把自定义View的对象传入即可:

            View view = View.inflate(context, R.layout.custom_crouton, null);
            Crouton.make(this, view, R.id.rl_root).show();

当Toast遇上色彩:Android第三方库Crouton学习笔记_第4张图片

5、通过Style.Builder修改背景颜色和字体样式

也许有时候我们就只是想给Crouton的背景或者字体换个颜色,为了这么个小需求就写一个布局那也忒麻烦了。难道就没有接口可以直接修改颜色的吗?

Crouton当然不会这么傻,它给我们提供了两个构造器:Style.BuilderConfiguration.Builder。前者用来构造Crouton的外观,如背景、字体等;后者用来构造Crouton的配置:停留时间和进出动画。

Style.Builder提供了很多方法,这里我不可能一个个地示范了,只是写了一个小例子,比如我们要实现一个黑底金字带有阴影的的Crouton(我承认是有点土)时就可以这样写:

                //创建Style构造器对象
                Style.Builder sb = new Style.Builder();
                sb.setBackgroundColor(android.R.color.black) //背景颜色
                        .setTextColor(android.R.color.holo_orange_light)//字体颜色
                        .setTextSize(18) //字体大小
                        .setTextShadowColor(android.R.color.white) //字体阴影颜色
                        .setTextShadowRadius(12) //字体阴影半径
                        .setHeight(120) //Crouton高度
                        .setGravity(Gravity.CENTER) //设置文字居中
                        .setFontName("Ponsi-Regular.otf")//设置字体,直接输入字体名称的字符串
                ;
                Crouton.showText(this, "This is a Crouton", sb.build());

这里需要用到showText方法,它的第三个参数就是Style对象。字体文件要提前放在assets文件夹下,然后直接在setFontName方法中直接输入字体名称字符串就可以了。但要注意的是setGravity方法只能设置文字内容的位置,对图片是不起作用的。

当Toast遇上色彩:Android第三方库Crouton学习笔记_第5张图片

6、自定义背景图片

如果UI给你设计好了Crouton的背景图片或者整个Crouton就是一张图片的话,那么你也可以给Crouton设置图片:

                sb.setBackgroundDrawable(R.drawable.crouton_pic)
                  .setImageScaleType(ImageView.ScaleType.CENTER_CROP);
                Crouton.showText(this,"",sb.build()); //展示图片,文本内容为空字符串即可

当Toast遇上色彩:Android第三方库Crouton学习笔记_第6张图片

7、通过修改Configuration.Builder修改Crouton配置

前面我们已经成功修改了Crouton的样式,现在就来修改一下它的配置吧。它配置包含两个方面:
- 动画效果,包含进入的动画和消失的动画;
- 持续时间,即进入动画执行完毕后Crouton停留在界面直至消失动画开始执行的时间。

首先创建两个动画文件:
crouton_in.xml


<translate xmlns:android="http://schemas.android.com/apk/res/android"
    android:duration="1500"
    android:fromXDelta="-100%p"
    android:toXDelta="0">
translate>

crouton_out.xml


<translate xmlns:android="http://schemas.android.com/apk/res/android"
    android:duration="1500"
    android:fromXDelta="0"
    android:toXDelta="100%p">
translate>

代码的写法跟Style.Builder的类似:

        //创建Configuration构造器对象
        Configuration.Builder cfg = new Configuration.Builder();
        cfg.setInAnimation(R.anim.crouton_in)
                .setOutAnimation(R.anim.crouton_out)
                .setDuration(1500);
        Crouton.showText(this, "修改配置后的Crouton", Style.CONFIRM, R.id.rl_root, cfg.build());

当Toast遇上色彩:Android第三方库Crouton学习笔记_第7张图片

8、同时修改外观和配置

如果我们需要同时改动外观和配置怎么弄呢?这个也很简单,在完成了外观和配置的设置之后,调用Style构造器中的setConfiguration方法传入一个Configuration实例即可:

sb.setConfiguration(cfg.build());

大体效果如下:
当Toast遇上色彩:Android第三方库Crouton学习笔记_第8张图片

9、Crouton的销毁

Crouton的销毁可以调用两个方法(下面是我的理解):
- cancelAllCroutons:销毁队列中的Crouton,如果当前有Crouton在展示,那么它会立即消失,后面的Crouton也不会再显示;
- clearCroutonsForActivity:销毁某个Activity中所有的Crouton。

官方的建议是在Activity销毁,也就是onDestroy方法执行时调用cancelAllCroutons方法,确保Crouton不再占用系统资源。

10、总结

大家应该都知道Crouton的用法了。我们学习了如何让Crouton在根布局和子布局上显示,也学习了如何修改它的外观和配置,相信这些可以满足我们大部分需求了。如果你有更好玩的用法,欢迎给我留言。
源码的GitHub地址:
SlidingToast

参考文章

Crouton的GitHub地址
Crouton介绍文档
Android自定义滑动Toast

你可能感兴趣的:(Android学习,android第三方)