# SnackbarUtils

**Repository Path**: leijia0809_admin/SnackbarUtils

## Basic Information

- **Project Name**: SnackbarUtils
- **Description**: Snackbar工具类
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-03-27
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SnackbarUtils
## Snackbar工具类
### 简介:
  Snackbar在项目中的使用场景越来越多,可全面的替代Toast,比Toast有更好的体验.该工具类可以方便的对Snackbar的样式,显示时间,位置等属性进行设置,方法比较丰富,调用简单,应该可以满足Snackbar绝大部分的使用场景!  
  [简书:SnackbarUtils:一行代码搞定Snackbar](http://www.jianshu.com/p/f4ba05d7bbda)
### 截屏:
  ![](https://github.com/HuanHaiLiuXin/SnackbarUtils/blob/master/%E5%BD%95%E5%B1%8F/%E6%89%80%E6%9C%89%E5%8A%9F%E8%83%BD%E5%BD%95%E5%B1%8F.gif)
### 功能点及对应的方法: 
  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