Awesome

SnackbarUtils

Snackbar工具类

简介:

Snackbar在项目中的使用场景越来越多,可全面的替代Toast,比Toast有更好的体验.该工具类可以方便的对Snackbar的样式,显示时间,位置等属性进行设置,方法比较丰富,调用简单,应该可以满足Snackbar绝大部分的使用场景!
简书:SnackbarUtils:一行代码搞定Snackbar

截屏:

功能点及对应的方法:

1:设置Snackbar显示时间长短

            1.1:Snackbar.LENGTH_SHORT       {@link SnackbarUtils#Short(View, String)}
            1.2:Snackbar.LENGTH_LONG        {@link SnackbarUtils#Long(View, String)}
            1.3:Snackbar.LENGTH_INDEFINITE  {@link SnackbarUtils#Indefinite(View, String)}
            1.4:CUSTOM                      {@link SnackbarUtils#Custom(View, String, int)}

2:设置Snackbar背景颜色

            2.1:color_info      {@link SnackbarUtils#info()}
            2.2:color_confirm   {@link SnackbarUtils#confirm()}
            2.3:color_warning   {@link SnackbarUtils#warning()}
            2.4:color_danger    {@link SnackbarUtils#danger()}
            2.5:CUSTOM          {@link SnackbarUtils#backColor(int)}

3:设置TextView(@+id/snackbar_text)的文字颜色

            {@link SnackbarUtils#messageColor(int)}

4:设置Button(@+id/snackbar_action)的文字颜色

            {@link SnackbarUtils#actionColor(int)}

5:设置Snackbar背景的透明度

            {@link SnackbarUtils#alpha(float)}

6:设置Snackbar显示的位置

            {@link SnackbarUtils#gravityFrameLayout(int)}
            {@link SnackbarUtils#gravityCoordinatorLayout(int)}
            6.1:Gravity.TOP;
            6.2:Gravity.BOTTOM;
            6.3:Gravity.CENTER;

7:设置Button(@+id/snackbar_action)文字内容及点击监听

            {@link SnackbarUtils#setAction(int, View.OnClickListener)}
            {@link SnackbarUtils#setAction(CharSequence, View.OnClickListener)}

8:设置Snackbar展示完成及隐藏完成的监听

            {@link SnackbarUtils#setCallback(Snackbar.Callback)}

9:设置TextView(@+id/snackbar_text)左右两侧的图片

            {@link SnackbarUtils#leftAndRightDrawable(Drawable, Drawable)}
            {@link SnackbarUtils#leftAndRightDrawable(Integer, Integer)}

10:设置TextView(@+id/snackbar_text)中文字的对齐方式

            默认效果就是居左对齐
            {@link SnackbarUtils#messageCenter()}   居中对齐
            {@link SnackbarUtils#messageRight()}    居右对齐
            注意:这两个方法要求SDK>=17.{@link View#setTextAlignment(int)}
                本来想直接设置Gravity,经试验发现在 TextView(@+id/snackbar_text)上,design_layout_snackbar_include.xml
                已经设置了android:textAlignment="viewStart",单纯设置Gravity是无效的.
                TEXT_ALIGNMENT_GRAVITY:{@link View#TEXT_ALIGNMENT_GRAVITY}

11:向Snackbar布局中添加View(Google不建议,复杂的布局应该使用DialogFragment进行展示)

            {@link SnackbarUtils#addView(int, int)}
            {@link SnackbarUtils#addView(View, int)}
            注意:使用addView方法的时候要注意新加布局的大小和Snackbar内文字长度，Snackbar过大或过于花哨了可不好看

12:设置Snackbar布局的外边距

            {@link SnackbarUtils#margins(int)}
            {@link SnackbarUtils#margins(int, int, int, int)}
            注意:经试验发现,调用margins后再调用 gravityFrameLayout,则margins无效.
                为保证margins有效,应该先调用 gravityFrameLayout,在 show() 之前调用 margins
                SnackbarUtils.Long(bt9,"设置Margin值").backColor(0XFF330066).gravityFrameLayout(Gravity.TOP).margins(20,40,60,80).show();

13:设置Snackbar布局的圆角半径值

            {@link SnackbarUtils#radius(float)}

14:设置Snackbar布局的圆角半径值及边框颜色及边框宽度

            {@link SnackbarUtils#radius(int, int, int)}

15:设置Snackbar显示在指定View的上方

            {@link SnackbarUtils#above(View, int, int, int)}
            注意:
                1:此方法实际上是 {@link SnackbarUtils#gravityFrameLayout(int)}和{@link SnackbarUtils#margins(int, int, int, int)}的结合.
                    不可与 {@link SnackbarUtils#margins(int, int, int, int)} 混用.
                2:暂时仅仅支持单行Snackbar,因为方法中涉及的{@link SnackbarUtils#calculateSnackBarHeight()}暂时仅支持单行Snackbar高度计算.

16:设置Snackbar显示在指定View的下方

            {@link SnackbarUtils#bellow(View, int, int, int)}
            注意:同15

示例:

    在Activity中:
    int total = 0;
    int[] locations = new int[2];
    getWindow().findViewById(android.R.id.content).getLocationInWindow(locations);
    total = locations[1];
    SnackbarUtils.Custom(bt_multimethods,"10s+左右drawable+背景色+圆角带边框+指定View下方",1000*10)
            .leftAndRightDrawable(R.mipmap.i10,R.mipmap.i11)
            .backColor(0XFF668899)
            .radius(16,1,Color.BLUE)
            .bellow(bt_margins,total,16,16)
            .show();

参考:

写的很好的Snackbar源码分析
http://blog.csdn.net/wuyuxing24/article/details/51220415
借鉴了作者部分写法,自定义显示时间及向Snackbar中添加View
http://www.jianshu.com/p/cd1e80e64311
借鉴了作者部分写法,4种类型的背景色及方法调用的便捷性
http://www.jianshu.com/p/e3c82b98f151
大神'工匠若水'的文章'Android应用坐标系统全面详解',用于计算Snackbar显示的精确位置
http://blog.csdn.net/yanbober/article/details/50419117
通过Blankj的指正,尝试使用弱引用来解决Snackbar引起的内存泄漏
http://www.jianshu.com/p/042d2e8d5748

开发者:

幻海流心
Email: wall0920@163.com
简书: http://www.jianshu.com/users/5702e6847f31/latest_articles
GitHub: https://github.com/HuanHaiLiuXin