Awesome
自定义对话框
目录介绍
- 01.该库介绍
- 02.效果展示
- 03.如何使用
- 04.注意要点
- 05.优化问题
- 06.版本更新
- 07.弹窗bug
- 08.参考案例
01.该库介绍
- 本库融合了弹窗类型有:Dialog,DialogFragment,Toast,PopupWindow,SnackBar。功能十分齐全,适合应用于实际开发中。
- 一行代码调用检测手机通知权限,建议加上,大部分手机通知权限是开启的。如果关闭了,则吐司是无法显示的,但是仍有部分手机,比如某型号小米手机,锤子手机等就权限需要手动开启。
- 针对吐司工具类,轻量级,使用builder模式,链式调用设置属性,可以设置吐司背景,文字内容,或者自定义布局吐司。解决避免点击多次导致吐司多次问题。
- 针对Dialog弹窗,仿IOS底部弹窗Dialog,可以设置弹窗主题,菜单项单击事件,取消事件监听,可以设置菜单项名称,十分方便。
- 针对实际开发中,比如请求接口需要加载loading,可以直接使用该库中的ViewLoading,一行代码show或者一行代码dismiss。
- 封装了SnackBar工具类,链式调用,可以快捷设置内容和action,十分方便开发者使用。
02.如何使用
- 首先在项目build.gradlew中添加**
//这个是依赖弹窗所有的 implementation 'com.github.yangchong211.YCDialog:DialogLib:3.6.8' //如果你想使用某个lib,可以选择下面这种依赖 implementation 'com.github.yangchong211.YCDialog:PopupWindow:3.6.8' implementation 'com.github.yangchong211.YCDialog:ToastUtils:3.6.8' implementation 'com.github.yangchong211.YCDialog:SnackBar:3.6.8' implementation 'com.github.yangchong211.YCDialog:DialogFragment:3.6.8' implementation 'com.github.yangchong211.YCDialog:BaseDialog:3.6.8'
2.1 仿IOS底部弹窗Dialog
- 支持设置弹窗主题,支持设置取消事件listener,支持设置名称和标题。有多个构造方法可以创建对象……
private void showCustomDialog() { final List<String> names = new ArrayList<>(); names.add("拍照"); names.add("相册"); names.add("其他"); showDialog(new CustomSelectDialog.SelectDialogListener() { @Override public void onItemClick(AdapterView<?> parent, View view, int position, long id) { } }, names); } private CustomSelectDialog showDialog(CustomSelectDialog.SelectDialogListener listener, List<String> names) { CustomSelectDialog dialog = new CustomSelectDialog(this, R.style.transparentFrameWindowStyle, listener, names); dialog.setItemColor(R.color.colorAccent,R.color.colorPrimary); //判断activity是否finish if (!this.isFinishing()) { dialog.show(); } return dialog; }
2.2 自定义Toast工具类
- 采用builder构造者模式,链式编程,一行代码调用即可设置吐司Toast。注意:为了避免静态toast对象内存泄漏,固可以使用应用级别的上下文context。
- 支持设置吐司的背景颜色,支持设置自定义吐司,同时支持设置吐司的多种属性等等,具体的用法如下所示:
//可以自由设置吐司的背景颜色,默认是纯黑色 ToastUtils.setToastBackColor(this.getResources().getColor(R.color.color_7f000000)); //直接设置最简单吐司,只有吐司内容 ToastUtils.showRoundRectToast("自定义吐司"); //设置吐司标题和内容 ToastUtils.showRoundRectToast("吐司一下","潇湘剑雨杨充是个逗比"); //第三种直接设置自定义布局的吐司 ToastUtils.showRoundRectToast(R.layout.view_layout_toast_delete); //或者直接采用bulider模式创建 ToastUtils.Builder builder = new ToastUtils.Builder(this.getApplication()); builder .setDuration(Toast.LENGTH_SHORT) .setFill(false) .setGravity(Gravity.CENTER) .setOffset(0) .setDesc("内容内容") .setTitle("标题") .setTextColor(Color.WHITE) .setBackgroundColor(this.getResources().getColor(R.color.blackText)) .build() .show();
2.3 自定义简易型PopupWindow
- 只需要继承BasePopDialog即可,实现其中的两个抽象方法
//第一步,自定义pop,继承BasePopDialog类,重新抽象方法 public class CustomPop extends BasePopDialog { public CustomPop(Context context) { super(context); } @Override public int getViewResId() { return R.layout.view_pop_custom; } @Override public void initData(View contentView) { TextView tv_pop = (TextView) contentView.findViewById(R.id.tv_pop); tv_pop.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { ToastUtils.showRoundRectToast("滚犊子吧"); } }); } } //第二步,创建pop并且展示 CustomPop customPop = new CustomPop(this); customPop.setDelayedMsDismiss(2500); customPop.setBgAlpha(0.5f); customPop.showAsDropDown(tv6, 0, -tv6.getMeasuredHeight() - tv6.getHeight());
2.4 自定义PopupWindow,builder模式
- 如下所示,更加详细的用法的方法说明可以直接看项目demo的代码
View contentView = LayoutInflater.from(this).inflate(R.layout.pop_layout,null); //创建并显示popWindow popWindow = new CustomPopupWindow.PopupWindowBuilder(this) //.setView(R.layout.pop_layout) .setView(contentView) .setFocusable(true) //弹出popWindow时,背景是否变暗 .enableBackgroundDark(true) //控制亮度 .setBgDarkAlpha(0.7f) .setOutsideTouchable(true) .setAnimationStyle(R.style.popWindowStyle) .setOnDissmissListener(new PopupWindow.OnDismissListener() { @Override public void onDismiss() { //对话框销毁时 } }) .create() .showAsDropDown(tv6,0,10);
2.5 自定义底部弹窗Dialog,builder模式【使用menu】
- 代码如下所示
new CustomBottomDialog(MainActivity.this) .title("这个是标题") .setCancel(true,"取消选择") .orientation(CustomBottomDialog.VERTICAL) .inflateMenu(R.menu.menu_share, new OnItemClickListener() { @Override public void click(CustomItem item) { } }) .show();
2.6 自定义布局弹窗dialogFragment[填充普通布局]
- 同1.2.7 具体可以先安装一下demo,看一下效果,使用方法如下所示:
final BottomDialogFragment dialog = new BottomDialogFragment(); dialog.setFragmentManager(getSupportFragmentManager()); dialog.setViewListener(new BottomDialogFragment.ViewListener() { @Override public void bindView(View v) { TextView tv_cancel = (TextView) v.findViewById(R.id.tv_cancel); tv_cancel.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { dialog.dismissDialogFragment(); } }); } }); dialog.setLayoutRes(R.layout.dialog_bottom_layout); dialog.setDimAmount(0.5f); dialog.setTag("BottomDialog"); dialog.setCancelOutside(true); //这个高度可以自己设置,十分灵活 dialog.setHeight(getScreenHeight() / 2); dialog.show();
2.7 自定义布局弹窗dialogFragment[填充list布局]
- 这个是之前沙丘大学底部弹窗而定制的,可以设置自定义布局view或者layout,可以设置tag,设置是否可以cancel弹窗,并且最主要可以设置弹窗的高度。
- 比较常见,比如下载音乐,下载视频等等,弹窗页面可以滚动,ok,就可以使用这个,代码也不是很复杂,具体使用场景可以参考我的另外一个demo:https://github.com/yangchong211/YCVideoPlayer
final List<DialogBean> list = new ArrayList<>(); for(int a=0 ; a<20 ; a++){ DialogBean dialogBean = new DialogBean("ooo","杨充","title"); list.add(dialogBean); } BottomDialogFragment.create(getSupportFragmentManager()) .setViewListener(new BottomDialogFragment.ViewListener() { @Override public void bindView(View v) { RecyclerView recyclerView = (RecyclerView) v.findViewById(R.id.recyclerView); ImageView ivCancel = (ImageView) v.findViewById(R.id.iv_cancel); ImageView ivDownload = (ImageView) v.findViewById(R.id.iv_download); recyclerView.setLayoutManager(new LinearLayoutManager(MainActivity.this)); DialogListAdapter mAdapter = new DialogListAdapter(MainActivity.this, list); recyclerView.setAdapter(mAdapter); final RecycleViewItemLine line = new RecycleViewItemLine( MainActivity.this, LinearLayout.HORIZONTAL, 2, MainActivity.this.getResources().getColor(R.color.grayLine)); recyclerView.addItemDecoration(line); mAdapter.setOnItemClickListener(new DialogListAdapter.OnItemClickListener() { @Override public void onItemClick(int position) { } }); View.OnClickListener listener = new View.OnClickListener() { @Override public void onClick(View v) { switch (v.getId()) { case R.id.iv_cancel: break; case R.id.iv_download: ToastUtils.showToast("下载"); break; default: break; } } }; ivCancel.setOnClickListener(listener); ivDownload.setOnClickListener(listener); } }) .setLayoutRes(R.layout.dialog_bottom_layout_list) .setDimAmount(0.5f) .setTag("BottomDialog") .setCancelOutside(true) .setHeight(getScreenHeight() / 2) .show();
2.8 自定义常见弹窗,builder模式
- 非常常见的弹窗,由于原生自带的弹窗不太美观,因此就需要自己定制弹窗呢。可以设置弹窗标题,内容,以及下面取消,确定等按钮内容和颜色
- 注意,如果某个属性设置为空或者不设置,那么就会隐藏该布局。这个也是根据公司产品具体的业务场景,逐渐演变过来的,具体效果可以直接看项目demo
CustomDialogFragment .create(getSupportFragmentManager()) .setTitle("这个是是标题") .setContent("这个是弹窗的内容") .setOtherContent("其他") .setDimAmount(0.2f) .setTag("dialog") .setCancelOutside(true) .setCancelListener(new View.OnClickListener() { @Override public void onClick(View v) { CustomDialogFragment.dismissDialogFragment(); ToastUtils.showRoundRectToast("取消了"); } }) .setOkListener(new View.OnClickListener() { @Override public void onClick(View v) { CustomDialogFragment.dismissDialogFragment(); ToastUtils.showRoundRectToast("确定了"); } }) .setOtherListener(new View.OnClickListener() { @Override public void onClick(View v) { CustomDialogFragment.dismissDialogFragment(); ToastUtils.showRoundRectToast("其他内容"); } }) .show();
2.9 自定义loading加载窗
- 一行代码调用即可,个人感觉不需要太复杂的代码,就能实现这个功能,满足具体业务需求,也是不亦乐乎:
//开始loading ViewLoading.show(this); ViewLoading.show(this,"加载中"); //结束loading ViewLoading.dismiss(this);
2.10 自定义SnackBar工具类
- 可以一行代码调用,也可以自己使用链式编程调用。支持设置显示时长属性;可以设置背景色;可以设置文字大小,颜色;可以设置action内容,文字大小,颜色,还有点击事件;可以设置icon;代码如下所示,更多内容可以直接运行demo哦!
//1.只设置text SnackBarUtils.showSnackBar(this,"滚犊子"); //2.设置text,action,和点击事件 SnackBarUtils.showSnackBar(this, "滚犊子", "ACTION", new View.OnClickListener() { @Override public void onClick(View v) { ToastUtils.showRoundRectToast("滚犊子啦?"); } }); //3.设置text,action,和点击事件,和icon SnackBarUtils.showSnackBar(this, "滚犊子", "ACTION",R.drawable.icon_cancel, new View.OnClickListener() { @Override public void onClick(View v) { ToastUtils.showRoundRectToast("滚犊子啦?"); } }); //4.链式调用 SnackBarUtils.builder() .setBackgroundColor(this.getResources().getColor(R.color.color_7f000000)) .setTextSize(14) .setTextColor(this.getResources().getColor(R.color.white)) .setTextTypefaceStyle(Typeface.BOLD) .setText("滚犊子") .setMaxLines(4) .centerText() .setActionText("收到") .setActionTextColor(this.getResources().getColor(R.color.color_f25057)) .setActionTextSize(16) .setActionTextTypefaceStyle(Typeface.BOLD) .setActionClickListener(new View.OnClickListener() { @Override public void onClick(View v) { ToastUtils.showRoundRectToast("滚犊子啦?"); } }) .setIcon(R.drawable.icon_cancel) .setActivity(MainActivity.this) .setDuration(SnackBarUtils.DurationType.LENGTH_INDEFINITE) .build() .show();
04.注意要点
05.效果展示
05.优化问题
关于弹窗系列博客
- 02.Toast源码深度分析
- 最简单的创建,简单改造避免重复创建,show()方法源码分析,scheduleTimeoutLocked吐司如何自动销毁的,TN类中的消息机制是如何执行的,普通应用的Toast显示数量是有限制的,用代码解释为何Activity销毁后Toast仍会显示,Toast偶尔报错Unable to add window是如何产生的,Toast运行在子线程问题,Toast如何添加系统窗口的权限等等
- 03.DialogFragment源码分析
- 最简单的使用方法,onCreate(@Nullable Bundle savedInstanceState)源码分析,重点分析弹窗展示和销毁源码,使用中show()方法遇到的IllegalStateException分析
- 04.Dialog源码分析
- AlertDialog源码分析,通过AlertDialog.Builder对象设置属性,Dialog生命周期,Dialog中show方法展示弹窗分析,Dialog的dismiss销毁弹窗,Dialog弹窗问题分析等等
- 05.PopupWindow源码分析
- 显示PopupWindow,注意问题宽和高属性,showAsDropDown()源码,dismiss()源码分析,PopupWindow和Dialog有什么区别?为何弹窗点击一下就dismiss呢?
- 06.Snackbar源码分析
- 最简单的创建,Snackbar的make方法源码分析,Snackbar的show显示与点击消失源码分析,显示和隐藏中动画源码分析,Snackbar的设计思路,为什么Snackbar总是显示在最下面
- 07.弹窗常见问题
- DialogFragment使用中show()方法遇到的IllegalStateException,什么常见产生的?Toast偶尔报错Unable to add window,Toast运行在子线程导致崩溃如何解决?
- 08.Builder模式
- 你会发现,在这个弹窗封装库中,很多地方用到了builder模式,那么可以先了解下Builder模式使用场景,简单案例,Builder模式实际案例Demo展示,看看AlertDialog.Builder源代码如何实现,为什么AlertDialog要使用builder模式呢?builder模式优缺点分析。
06.版本更新
- v1.0 更新2016年6月2日
- v1.4 更新2017年8月9日
- v3.3 更新2018年1月12日
- v3.4 更新2018年1月18日
- v3.5 更新2018年1月31日
- v3.5.1 更新与2018年6月2日
- v3.5.3 更新于2018年9月10日
- v3.6.5 更新于2018年9月15日
- v3.6.6 更新于2019年5月7日
07.弹窗bug
- 1.DialogFragment使用中show()方法遇到的IllegalStateException
- 2.Toast偶尔报错Unable to add window,is your activity running
- 3.Toast运行在子线程导致崩溃,子线程如何吐司
- 4.Dialog Unable to add window --token null is not for an application
- 5.为什么Dialog不能用Application的Context,一旦用了则会导致崩溃
其他介绍
01.关于博客汇总链接
02.关于我的博客
- github:https://github.com/yangchong211
- 知乎:https://www.zhihu.com/people/yczbj/activities
- 简书:http://www.jianshu.com/u/b7b2c6ed9284
- csdn:http://my.csdn.net/m0_37700275
- 喜马拉雅听书:http://www.ximalaya.com/zhubo/71989305/
- 开源中国:https://my.oschina.net/zbj1618/blog
- 泡在网上的日子:http://www.jcodecraeer.com/member/content_list.php?channelid=1
- 邮箱:yangchong211@163.com
- 阿里云博客:https://yq.aliyun.com/users/article?spm=5176.100- 239.headeruserinfo.3.dT4bcV
- segmentfault头条:https://segmentfault.com/u/xiangjianyu/articles
- 掘金:https://juejin.im/user/5939433efe88c2006afa0c6e