(二) 安卓通用代码库 之 TipDialog
通用核心代码库-code: 适合入门不久的同学学习借鉴编程思想,也可以直接拿来使用。
它包含了我从业几年以来积累的、最常用的封装类和基础框架等等,几乎每个项目都可以引入它,实现快速开发。
code的github地址:https://github.com/chenyugui/code
好了,开始介绍今天的主角: TipDialog
使用场景介绍
相信很多人开发项目时,都有遇到过这样一个场景: 点击删除某个商品或某张图片时,会先弹个对话框提示“是否确认删除?”,点确定时才会真的删除。
这场景是绝大部分项目都要用到的,当然,除了删除东西,还有很多其他地方需要用到提示框,所以我也把它封装进核心代码库里面了,下面我们看下封装完后,使用是多么方便。
代码使用
像下面代码一样使用showTipDialog方法即可
public class MainActivity extends BaseActivity implements View.OnClickListener {
@Override
protected Object setLayout() {
return R.layout.activity_main;
}
@Override
protected void onBindView(@Nullable Bundle savedInstanceState) {
findView(R.id.btnDelete).setOnClickListener(this);
}
@Override
public void onClick(View v) {
int id = v.getId();
if (id == R.id.btnDelete) {
showTipDialog("请确认是否删除?", new TipDialog.TipClickCallBack() {
@Override
public void onConfirm() {
// 确认,执行真正的删除逻辑
}
@Override
public void onCancel() {
// 不删除
}
});
}
}
}
默认两个按钮是“取消”和“确定”,如果想要定制修改两个按钮的文字,可以调用它另外一个重载方法,这样子:
showTipDialog("请确认是否删除?", false, "取消", "删除", new TipDialog.TipClickCallBack() {
@Override
public void onConfirm() {
// 确认,执行真正的删除逻辑
}
@Override
public void onCancel() {
// 不删除
}
});
实现细节
showTipDialog方法是写在BaseActivity里面的,我们进去BaseActivity看下showTipDialog方法具体的代码,其实就是几个重载方法,最终是用了一个TipDialogCreator类来创建和显示TipDialog。
@Override
public void showTipDialog(String tipMsg, final boolean isFinishWhenCancel) {
showTipDialog(tipMsg, isFinishWhenCancel, false, null, null, null);
}
@Override
public void showTipDialog(String tipMsg, TipDialog.TipClickCallBack tipClickCallBack) {
showTipDialog(tipMsg, false, false,
null, null, tipClickCallBack);
}
@Override
public void showTipDialog(String tipMsg, boolean canceledOnTouchOutside, TipDialog.TipClickCallBack tipClickCallBack) {
showTipDialog(tipMsg, false, canceledOnTouchOutside,
null, null, tipClickCallBack);
}
@Override
public void showTipDialog(String tipMsg, boolean canceledOnTouchOutside, String cancelString,
String confirmString, TipDialog.TipClickCallBack tipClickCallBack) {
showTipDialog(tipMsg, false, canceledOnTouchOutside,
cancelString, confirmString, tipClickCallBack);
}
@Override
public void showTipDialog(String tipMsg, final boolean isFinishWhenCancel,
boolean canceledOnTouchOutside, String cancelString,
String confirmString, TipDialog.TipClickCallBack tipClickCallBack) {
tipDialogCreator.showTipDialog(tipMsg, isFinishWhenCancel, canceledOnTouchOutside,
cancelString, confirmString, tipClickCallBack);
}
再进去TipDialogCreator看看它的代码,很简单的就是创建一个TipDialog并且给它设置各种文字和回调,TipDialog就是一个普通的自定义的Dialog:
public void showTipDialog(String tipMsg, final boolean isFinishWhenCancel, boolean canceledOnTouchOutside,
String cancelString, String confirmString, TipDialog.TipClickCallBack tipClickCallBack) {
TipDialog tipDialog = new TipDialog(context);
tipDialog.setTipClickCallBack(tipClickCallBack);
tipDialog.setCanceledOnTouchOutside(canceledOnTouchOutside);
tipDialog.setOnCancelListener(new DialogInterface.OnCancelListener() {
@Override
public void onCancel(DialogInterface dialog) {
if (isFinishWhenCancel && cancelAble != null) {
cancelAble.toCancel();
}
}
});
tipDialog.setTipText(tipMsg);
tipDialog.setButtonText(cancelString, confirmString);
try {
tipDialog.show();
} catch (Exception e) {
e.printStackTrace();
}
}
设计原则和技巧
-
我们遵循单一原则,用TipDialogCreator来负责创建和显示TipDialog,这样子处理以后,提高了代码的可复用性,不单单是BaseActivity需要创建TipDialog,还有BaseFragment、BaseDialog等等都需要,就可以直接复用了。
-
如果你觉得这个TipDialog的布局太丑了或者不符合你们APP的风格,想要换掉UI,怎么办
-
当然,最快的方法是直接改布局文件。但是我不建议这么做,咱们这个核心代码库是遵循“通用”特性来设计的,这种跟特定项目需求而定的东西,不要直接改核心代码库里的代码,那怎么办呢?
-
我们提供了一种可以从外部设置方法,我们看下TipDialog设置布局的时候,会先从AppGlobal读取有没有外部设置,有的话就用外部设置的布局文件。我们回到AppGlobal配置的地方,设置自定义的布局文件进去即可。
-
关于AppGlobal的介绍,不清楚的同学可以看上一篇视频。
-
↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
PS: 分享不易,觉得有用的同学,点个赞鼓励一下呗。可以关注公众号「Grade桂」,持续分享技术信息和职场经验