美文网首页安卓核心代码库
(二) 安卓通用代码库 之 TipDialog

(二) 安卓通用代码库 之 TipDialog

作者: G桂 | 来源:发表于2020-12-26 18:56 被阅读0次

    通用核心代码库-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();
        }
    }
    

    设计原则和技巧

    1. 我们遵循单一原则,用TipDialogCreator来负责创建和显示TipDialog,这样子处理以后,提高了代码的可复用性,不单单是BaseActivity需要创建TipDialog,还有BaseFragment、BaseDialog等等都需要,就可以直接复用了。

    2. 如果你觉得这个TipDialog的布局太丑了或者不符合你们APP的风格,想要换掉UI,怎么办

      • 当然,最快的方法是直接改布局文件。但是我不建议这么做,咱们这个核心代码库是遵循“通用”特性来设计的,这种跟特定项目需求而定的东西,不要直接改核心代码库里的代码,那怎么办呢?

      • 我们提供了一种可以从外部设置方法,我们看下TipDialog设置布局的时候,会先从AppGlobal读取有没有外部设置,有的话就用外部设置的布局文件。我们回到AppGlobal配置的地方,设置自定义的布局文件进去即可。

      • 关于AppGlobal的介绍,不清楚的同学可以看上一篇视频。

    ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

    PS: 分享不易,觉得有用的同学,点个赞鼓励一下呗。可以关注公众号「Grade桂」,持续分享技术信息和职场经验

    相关文章

      网友评论

        本文标题:(二) 安卓通用代码库 之 TipDialog

        本文链接:https://www.haomeiwen.com/subject/fpignktx.html