近几天大家反映的问题，都会得到改善，请及时使用最新版本。当前最新版本2.6.7。
- 优雅封装，简化调用
- 处理系统bug等，如Android 7.1系统关于Toast的BadTokenException
- 解决已知的UI性能缺陷，提高用户体验，如Toast重复弹跳等,关闭通知权限后Toast不显示
- 对不同系统版本及厂商设备进行适配
- 合理的复用策略，节约内存开销的同时及时解除引用以便被垃圾回收器回收
- 根据实际开发中的常见需求，进行功能扩展
四大模块的详细功能可查看下面各模块的介绍
回到模块导航
如果你对实现感兴趣，请参考我的CSDN博客：
- 2.x 版本 https://blog.csdn.net/jungle_pig/article/details/83959662
- 1.x 版本 https://blog.csdn.net/jungle_pig/article/details/78568493
已授权郭霖微信公众号 同步发表： - 2.x 版本 https://mp.weixin.qq.com/s/7qQdPLLfhZA_i7HjucfgWA
- 1.x 版本 https://mp.weixin.qq.com/s/l62PtbmrIOkVKfJ2r0JwEw
回到模块导航
为使SmartShow库更加健壮，如果您在使用过程中发现任何问题，请联系我，我会立即跟进修复和维护。感谢您的支持！
作者：朱志强
微信：w361281607
邮箱：coder_zzq@163.com
微信交流群：
- 在Project的gradle文件中
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
- 在Module的gradle文件中
第一种方式，引入所有模块
implementation ('com.github.the-pig-of-jungle.smart-show:all:2.6.7'){
exclude group: 'com.android.support'
}
//添加与你项目匹配的design依赖库的相应版本
implementation 'com.android.support:design:x.y.z'
第二种方式，自由引入各个模块
//smart toast
implementation 'com.github.the-pig-of-jungle.smart-show:toast:2.6.7'
// smart dialog
implementation 'com.github.the-pig-of-jungle.smart-show:dialog:2.6.7'
// smart topbar
implementation('com.github.the-pig-of-jungle.smart-show:topbar:2.6.7') {
exclude group: 'com.android.support'
}
//添加与你项目匹配的design依赖库的相应版本
implementation 'com.android.support:design:x.y.z'
// smart snackbar
implementation('com.github.the-pig-of-jungle.smart-show:snackbar:2.6.7') {
exclude group: 'com.android.support'
}
//添加与你项目匹配的design依赖库的相应版本
implementation 'com.android.support:design:x.y.z'
- 在Application的onCreate方法中初始化
SmartShow.init(this);
- 使用application context，而不是activity，避免因activity生命周期问题引起的各种问题
- 复用Toast实例，当Toast正在显示时，多次触发内容和位置均未改变的Toast，不会重复弹出；下一个Toast不会等到上一个Toast的Duration耗尽才弹出
- 解决传统复用模式的功能缺陷，如正在显示一个内容为"A"的Toast，此时再弹出内容为"B"的Toast时，文本虽改变，但没有弹出效果；如果复用的Toast正在显示，改变其Gravity以改变显示位置会无效，直到消失后再次显示才生效
- 可修改Toast默认布局的风格，如背景颜色，文字大小和颜色等
- 可为Toast设置自定义布局
- 完美解决Android 7.1的系统bug——Toast BadTokenException
- 完美解决应用关闭通知权限后Toast不显示问题
- 可配置离开当前页面（退出当前activity或进入新的activity），立即消失正在显示的Toast
- 结合主流app消息提示的效果，提供info、success、error、warning、complete、forbid、wait、fail 8 种类型的Toast
调用show方法显示Toast，duration和常用的显示位置体现在方法名上，而不是传参，调用非常简易
默认样式：
设置背景色：
//在默认位置显示
SmartToast.show("我是朱志强");
SmartToast.showLong("我是朱志强");
//在屏幕顶部显示，水平居中，距离顶部距离与在默认位置显示时，距离底部的距离一致
SmartToast.showAtTop("我是朱志强");
SmartToast.showLongAtTop("我是朱志强");
//在屏幕**显示
SmartToast.showInCenter("我是朱志强");
SmartToast.showLongInCenter("我是朱志强");
//在左上角，x，y偏移量为10dp的位置显示
SmartToast.showAtLocation("我是朱志强",Gravity.LEFT | Gravity.TOP,10,10);
SmartToast.showLongAtLocation("我是朱志强",Gravity.LEFT | Gravity.TOP,10,10);
type toast 均居中显示
默认样式：
设置主题色：
//普通
SmartToast.info("已在后台下载");
SmartToast.infoLong("已在后台下载");
//成功
SmartToast.success("重置成功");
SmartToast.successLong("重置成功");
//错误
SmartToast.error("保存失败");
SmartToast.errorLong("保存失败");
//警告
SmartToast.warning("电量过低，请充电");
SmartToast.warningLong("电量过低，请充电");
//完成
SmartToast.complete("下载完成");
SmartToast.completeLong("下载完成");
//失败
SmartToast.fail("保存失败");
SmartToast.failLong("保存失败");
//禁止
SmartToast.forbid("当前账户不允许汇款操作");
SmartToast.forbidLong("当前账户不允许汇款操作");
//等候
SmartToast.waiting("已在后台下载，请耐心等待");
SmartToast.waitingLong("已在后台下载，请耐心等待");
定制化SmartToast，调用setting方法获取IToastSetting对象进行全局配置
在application的onCreate方法里执行配置代码
//获取IToastSetting对象
SmartToast.setting()
若自定义布局，可调用View方法传入，在布局中必须定义id为android:id="@id/custom_toast_msg"的TextView显示消息文本
//自定义布局，直接传入View
IToastSetting view(View view);
//自定义布局，传入布局资源
IToastSetting view(@LayoutRes int layout);
//设置布局背景颜色
IToastSetting backgroundColor(@ColorInt int color);
IToastSetting backgroundColorRes(@ColorRes int colorRes);
// 设置消息文本颜色
IToastSetting textColor(@ColorInt int color);
IToastSetting textColorRes(@ColorRes int color);
//设置消息文本大小
IToastSetting textSizeSp(float sp);
//消息文本是否为粗体
IToastSetting textBold(boolean bold);
//对布局进一步处理，callback中会传入布局的根View和显示消息的TextView，
//callback中的处理和以上配置方法的处理有冲突时，将覆盖掉以上的配置
IToastSetting processView(IProcessToastCallback callback);
例子：
SmartToast.setting()
.backgroundColorRes(R.color.colorPrimary)
.textSizeSp(18)
.textBold(true)
.processView(new IProcessToastCallback() {
//root 为布局根View，msgView为显示消息的TextView
@Override
public void processView(View rootView, TextView msgView) {
//...
}
});
配置 Type Toast 的主题色
IToastSetting typeInfoToastThemeColor(@ColorInt int color);
IToastSetting typeInfoToastThemeColorRes(@ColorRes int colorRes);
例子：
SmartToast.setting()
.typeInfoToastThemeColorRes(R.color.colorPrimary);
配置离开当前activity时，是否立即隐藏正在显示的Toast（不管是普通Toast还是 Type Toast），默认false
IToastSetting dismissOnLeave(boolean b);
例子：
SmartToast.setting()
.dismissOnLeave(true);
//是否有Toast在显示
SmartToast.isShowing();
//隐藏当前显示的Toast
SmartToast.dismiss();
- 复用Snackbar实例，当Snackbar正在显示，多次触发时，若msg和actionTex均未改变，则不会重复弹出，否则会有弹出效果
- 可修改布局风格，如背景颜色，文字大小和颜色等
- 可配置离开当前Activity时，立即消失正在显示的Snackbar。如，在Activity A 上显示了一个Indefinite Snackbar，并且用户没有点击响应，启动activity B，然后再返回A，原来的Snackbar已自动消失
传入当前界面的Activity,获取Snackbar，三种duration体现在方法名上，而不是传参，尽可能简化调用
//short snackbar
SmartSnackbar.get(this).show("我是朱志强");
//long snackbar
SmartSnackbar.get(this).showLong("我是朱志强");
//indefinite snackbar,只传入消息文本时，会显示默认的动作文本"确定"，点击动作文本，执行默认行为——Snackbar消失
SmartSnackbar.get(this).showIndefinite("我是朱志强");
//short snackbar
SmartSnackbar.get(this).show("为SmartShow Star 一下可以么","好的");
//long snackbar
SmartSnackbar.get(this).showLong("为SmartShow Star 一下可以么","好的");
//indefinite snackbar
SmartSnackbar.get(this).showIndefinite("为SmartShow Star 一下可以么","好的");
SmartSnackbar.get(this).show("我是朱志强", "打赏", new View.OnClickListener() {
@Override
public void onClick(View v) {
//...
}
});
SmartSnackbar.get(this).showLong("我是朱志强", "打赏", new View.OnClickListener() {
@Override
public void onClick(View v) {
//...
}
});
SmartSnackbar.get(this).showIndefinite("我是朱志强", "打赏", new View.OnClickListener() {
@Override
public void onClick(View v) {
//...
});
- 以上示例获取SmartSnackbar使用的是SmartSnackbar.get(this)，this为当前界面activity，还可使用SmartSnackbar.get(CoordinatorLayout view)。
- 根据谷歌源码，我们知道创建Snackbar时需传入一个当前activity的某个View。实际上，Snackar会以该View为基点，沿着整个View Tree上溯，直到找到CoordinatorLayout容器或android.R.id.content 容器，哪个先找到，就将视图嵌入其中。以CoordinatorLayout为内嵌容器时，Snackbar会有一些特殊的行为，如可以用手指手动滑动移除，显示时会导致FloatingActionButton升高等。 为了提高效率，直接将android.R.id.content或者CoordinatorLayout传入会更好。
- SmartSnackbar对入口做了限制，如果你的页面想以某个具体CoordinatorLayout作为容器，则调用get(CoordinatorLayout view)。否则调用get(Activity activity)，内部会自动将该Activity的 android.R.id.content作为容器。
定制化SmartSnackbar，可调用setting方法获取ISnackbarSetting对象进行全局配置
在application的onCreate方法里执行配置代码
//获取ISnackbarSetting对象
SmartSnackbar.setting()
配置布局风格
//设置背景颜色
ISnackbarSetting backgroundColor(int color);
ISnackbarSetting backgroundColorRes(int colorRes);
//设置消息文本颜色
ISnackbarSetting msgTextColor(@ColorInt int color);
ISnackbarSetting msgTextColorRes(@ColorRes int colorRes);
//设置消息文本大小
ISnackbarSetting msgTextSizeSp(float textSizeSp);
//设置动作文本颜色
ISnackbarSetting actionColor(@ColorInt int color);
ISnackbarSetting actionColorRes(@ColorRes int colorRes);
//设置动作文本大小
ISnackbarSetting actionSizeSp(float textSizeSp);
//对布局进一步处理，callback中会传入布局的根View和显示消息文本的TextView以及动作文本的Button，
//callback中的处理和以上配置方法的处理有冲突时，将覆盖掉以上的配置
ISnackbarSetting processView(IProcessBarCallback callback);
//设置调用Indefinite Snackbar时，如果只传入消息文本，默认显示的动作文本字符串，如果不设置，即显示为"确定"
ISnackbarSetting defaultActionTextForIndefinite(String actionText);
//设置离开当前activity时，是否立即消失掉正在显示的Snackbar，默认false。如，在Activity A上显示了一个
//Indefinite Snackbar，启动Activity B，然后按返回键回到A，原先的Snackbar依然存在，设置为true后，
//在进入B之前就会消失
ISnackbarSetting dismissOnLeave(boolean b);
例子：
SmartSnackbar.setting()
.backgroundColorRes(R.color.colorPrimary)
.msgTextColorRes(R.color.white)
.actionColorRes(R.color.colorAccent)
.dismissOnLeave(true);
//隐藏当前显示的Snackbar
SmartSnackbar.dismiss();
//是否有Snackbar在显示
SmartSnackbar.isShowing();
将Activity实现ISnackbarShowCallback接口，然后重写方法即可。在SmartSnackbar显示时，会检测当前activity是否实现该接口，是则进行回调。
public class SnackbarActivity extends BaseActivity implements ISnackbarShowCallback {
@Override
protected int contentLayout() {
return R.layout.activity_smart_show;
}
@Override
public void onShown(Snackbar sb) {
}
@Override
public void onDismissed(Snackbar sb, int event) {
}
}
回到模块导航
默认样式：设置背景色：
- SmartTopbar在功能以及使用上很像一个顶部的Snackbar
- 当Topbar正在显示，多次触发时，若msg和actionTex均未改变，则不会重复弹出，否则有弹出效果
- 可修改布局风格，如背景颜色，文字大小和颜色等
- 可配置离开当前Activity时，立即消失正在显示的Topbar。如，在Activity A 上显示了一个Indefinite Topbar，并且用户没有 点击响应，启动activity B，然后再返回A，原来的Topbar已自动消失
- 可通过手势右滑隐藏Topbar
传入当前界面的Activity,获取Topbar，三种duration体现在方法名上，而不是传参，尽可能简化调用
//short topbar
SmartTopbar.get(this).show("我是朱志强");
//long topbar
SmartTopbar.get(this).showLong("我是朱志强");
//indefinite topbar,只传入消息文本时，会显示默认的动作文本"确定"，点击动作文本，执行默认行为——Topbar消失
SmartTopbar.get(this).showIndefinite("我是朱志强");
//short topbar
SmartTopbar.get(this).show("为SmartShow Star 一下可以么","好的");
//long topbar
SmartTopbar.get(this).showLong("为SmartShow Star 一下可以么","好的");
//indefinite topbar
SmartTopbar.get(this).showIndefinite("为SmartShow Star 一下可以么","好的");
SmartTopbar.get(this).show("我是朱志强", "打赏", new View.OnClickListener() {
@Override
public void onClick(View v) {
//...
}
});
SmartTopbar.get(this).showLong("我是朱志强", "打赏", new View.OnClickListener() {
@Override
public void onClick(View v) {
//...
}
});
SmartTopbar.get(this).showIndefinite("我是朱志强", "打赏", new View.OnClickListener() {
@Override
public void onClick(View v) {
//...
});
定制化SmartTopbar，可调用setting方法获取ITopbarSetting对象进行全局配置
在application的onCreate方法里执行配置代码
//获取ITopbarSetting对象
SmartTopbar.setting()
配置布局风格
//设置背景颜色
ITopbarSetting backgroundColor(int color);
ITopbarSetting backgroundColorRes(int colorRes);
//设置消息文本颜色
ITopbarSetting msgTextColor(@ColorInt int color);
ITopbarSetting msgTextColorRes(@ColorRes int colorRes);
//设置消息文本大小
ITopbarSetting msgTextSizeSp(float textSizeSp);
//设置动作文本颜色
ITopbarSetting actionColor(@ColorInt int color);
ITopbarSetting actionColorRes(@ColorRes int colorRes);
//设置动作文本大小
ITopbarSetting actionSizeSp(float textSizeSp);
//对布局进一步处理，callback中会传入布局的根View和显示消息文本的TextView以及动作文本的Button，
//callback中的处理和以上配置方法的处理有冲突时，将覆盖掉以上的配置
ITopbarSetting processView(IProcessBarCallback callback);
//设置调用Indefinite Topbar时，如果只传入消息文本，默认显示的动作文本字符串，如果不设置，即显示为"确定"
ITopbarSetting defaultActionTextForIndefinite(String actionText);
//设置离开当前activity时，是否立即消失掉正在显示的Topbar，默认false。如，在Activity A上显示了一个
//Indefinite Topbar，启动Activity B，然后按返回键回到A，原先的Topkbar依然存在，设置为true后，
//在进入B之前就会消失
ITopbarSetting dismissOnLeave(boolean b);
例子：
SmartTopbar.setting()
.backgroundColorRes(R.color.colorPrimary)
.msgTextColorRes(R.color.white)
.actionColorRes(R.color.colorAccent)
.dismissOnLeave(true);
//隐藏当前显示的Topbar
SmartTopbar.dismiss();
//是否有Topbar在显示
SmartTopbar.isShowing();
将Activity实现ITopbarShowCallback接口，然后重写方法即可。在SmartTopbar显示时，会检测当activity是否实现该接口，是则进行回调。
public class SnackbarActivity extends BaseActivity implements ITopbarShowCallback {
@Override
protected int contentLayout() {
return R.layout.activity_smart_show;
}
@Override
public void onShown(Topbar tb) {
}
@Override
public void onDismissed(Topbar tb, int event) {
}
}
- 判断activity的生命周期，避免因activity生命周期引起的NullPointException、BadTokenException等
- 提供主流APP中使用的message、loading等对话框
第一步，继承DialogCreator，实现你的Dialog创建逻辑。
public class ExampleDialogCreator extends DialogCreator {
/**
* 抽象方法，必须实现
*
* @param activity
* @return
*/
@Override
public Dialog createDialog(Activity activity) {
//创建Dialog，在这里可以保证activity不为null，并且没有destroyed或isFinishing
Dialog dialog = null;
...
return dialog;
}
/**
* 非抽象方法，默认实现为空，可选择性覆写，用于Dialog每次显示前的一些重置工作，例如EditText清空等
*
* @param dialog
*/
@Override
public void resetDialogPerShow(Dialog dialog) {
}
}
第二步，创建SmartDialog，传入DialogCreator。实际上SmartDialog并没有继承Dialog，只是个Dialog的包装器，管理Dialog。reuse(boolean b)方法表示是否复用Dialog，如果不复用，每次显示都调用DialogCreator创建新的Dialog。
private SmartDialog mExampleDialog;
public void onShowDialogClick(View view) {
if (mExampleDialog == null) {
mExampleDialog = SmartDialog.newInstance(new ExampleDialogCreator())
.reuse(true);
}
mExampleDialog.show(this);
}
预定义的DialogCreator可调用方法设置按钮文本和颜色、按钮点击事件、标题等等。通过DialogCreatorFactory获取相关实例。
下面是一些公共方法
public interface INormalDialogCreator<B> {
//Dialog显示时，窗口以外区域是否变暗
B darkAroundWhenShow(boolean dim);
//设置窗口背景
B windowBackground(@DrawableRes int bgRes);
//按back键是否可以取消
B cancelable(boolean b);
//触碰Dialog窗口外的区域是否取消
B cancelableOnTouchOutside(boolean b);
//cancel 监听器
B cancelListener(DialogInterface.OnCancelListener cancelListener);
//show监听器
B showListener(DialogInterface.OnShowListener showListener);
//dimiss监听器
B dismissListener(DialogInterface.OnDismissListener dismissListener);
private SmartDialog mLoadingDialog;
public void onLoadingLargeClick(View view) {
if (mLargeLoadingDialog == null) {
mLargeLoadingDialog = SmartDialog.newInstance(
DialogCreatorFactory
.loading()
.large()
.message("加载中")
)
.reuse(true);
}
mLargeLoadingDialog.show(this);
}
ILoadingDialogCreator的全部方法
//不带提示文本
ILoadingDialogCreator withNoMsgTip();
//设置提示文本
ILoadingDialogCreator message(CharSequence msg);
//设置Loading框的大小为large
ILoadingDialogCreator large();
//设置Loading框的大小为middle
ILoadingDialogCreator middle();
//设置Loading框的大小为small,此时提示文本隐藏了，只显示loading动画
ILoadingDialogCreator small();
public SmartDialog mResetSuccTip;
public void onNotificationClick(View view) {
if (mResetSuccTip == null) {
mResetSuccTip = SmartDialog.newInstance(
DialogCreatorFactory
.notification()
.message("重置成功")
)
.reuse(true);
}
mResetSuccTip.show(this);
}
INotificationDialogCreator的全部方法
//设置标题
INotificationDialogCreator title(CharSequence title);
//设置标题风格
INotificationDialogCreator titleStyle(@ColorInt int color, float textSizeSp, boolean bold);
//设置确定按钮的文本
INotificationDialogCreator confirmBtn(CharSequence label);
//设置确定按钮的文本以及设置监听器，不显示设置监听器或者设置为null则效果为Dialog消失
INotificationDialogCreator confirmBtn(CharSequence label, DialogBtnClickListener clickListener);
//设置确定按钮的风格
INotificationDialogCreator confirmBtnTextStyle(@ColorInt int color, float textSizeSp, boolean bold)
//设置消息文本
INotificationDialogCreator message(CharSequence msg);
//设置消息文本风格
INotificationDialogCreator messageStyle(@ColorInt int color, float textSizeSp, boolean bold)
//禁用确定按钮，倒计时若干秒后启用
INotificationDialogCreator secondsDelayConfirm(int seconds);
private SmartDialog mCancelConcernDialog;
public void onEnsureClick(View view) {
if (mCancelConcernDialog == null) {
mCancelConcernDialog = SmartDialog.newInstance(
DialogCreatorFactory
.ensure()
.confirmBtn("确定")
.cancelBtn("取消")
.message("确定不再关注此人？")
)
.reuse(true);
}
mCancelConcernDialog.show(this);
}
除了具有INotificationDialogCreator的全部方法外，IEnsureDialogCreator如外的方法
//设置取消按钮的文本
IEnsureDialogCreator cancelBtn(CharSequence label);
//设置取消按钮的文本及监听器，监听器为null或者不设置，效果为Dialog消失
IEnsureDialogCreator cancelBtn(CharSequence label, DialogBtnClickListener clickListener);
//设置取消按钮的文本风格
IEnsureDialogCreator cancelBtnTextStyle(@ColorInt int color, float textSizeSp, boolean bold);
private SmartDialog mInputSuggestionDialog;
public void onInputClick(View view) {
if (mInputSuggestionDialog == null) {
mInputSuggestionDialog = SmartDialog.newInstance(
DialogCreatorFactory
.input()
// 传入 IInputTextDialogCreator.INPUT_NO_LIMIT 表示不限制字数
.inputAtMost(30)
.hint("输入建议")
// 默认填充的文本
.textOfDefaultFill("我提个建议")
//每次显示前，输入框是否清空，如果有预设文本，则恢复为预设文本
.clearInputPerShow(true)
.confirmBtn("提交", new DialogBtnClickListener() {
@Override
public void onBtnClick(Dialog dialog, int which, Object data) {
if (data.toString().length() > 30) {
SmartToast.showInCenter("最多只能输入30个字符");
return;
} else {
dialog.dismiss();
SmartToast.showInCenter(data.toString());
}
}
})
.inputCountMarkColor(Utils.getColorFromRes(R.color.colorPrimary))
)
.reuse(true);
}
mInputSuggestionDialog.show(this);
}