安卓核心代码库

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

2020-12-26  本文已影响0人  G桂

通用核心代码库-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桂」,持续分享技术信息和职场经验

上一篇下一篇

猜你喜欢

热点阅读