TDialog: DialogFragment封装,高效实现各种弹窗效果

2023-10-30 10:59

本文主要是介绍TDialog: DialogFragment封装,高效实现各种弹窗效果,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

前言

文章代码示例已放到Github上了,有需要的朋友可以去看下TDialog,欢迎star和fork,项目会一直维护,有疑问可以提Issues或留言.

文章目录

  • TDialog框架的由来
  • 框架使用解析
  • 框架原理解析

正文开始前先来一波效果图

 

16109386183fd39c?imageslim

 

一.TDialog的由来

所有框架的由来都是为了更方便,更高效的解决问题,TDialog也一样,是为了在项目中更高效的实现项目的弹窗效果

TDialog是继承自DialogFragment进行封装的,大部分开发者在实现弹窗效果的时候,会首选系统提供的AlertDialog; 但是使用系统的Dialog在某些情况下会出现问题,最常见的场景是当手机屏幕旋转时Dialog弹窗会消失,并抛出一个系统,这个异常不会导致异常崩溃,因为Google开发者知道这个问题,并进行了处理. Dialog使用起来其实更简单,但是Google却是推荐尽量使用DialogFragment.

1.DialogFragment的优点

  • DialogFragment 本身是 Fragment 的子类,有着和 Fragment 基本一样的生命周期,使用 DialogFragment 来管理对话框,当旋转屏幕和按下后退键的时候可以更好的管理其生命周期
  • 在手机配置变化导致 Activity 需要重新创建时,例如旋转屏幕,基于 DialogFragment 的对话框将会由 FragmentManager 自动重建,然而基于 Dialog 实现的对话框却没有这样的能力 ####使用 1.添加依赖 a. 在工程build.gradle文件repositories中添加
  repositories {...jcenter() 
}

b.在model下build.gradle文件添加

compile 'com.timmy.tdialog:tdialog:1.3.1'

2.Activity或者Fragment中使用

        new TDialog.Builder(getSupportFragmentManager()).setLayoutRes(R.layout.dialog_click)    //设置弹窗展示的xml布局
//                .setDialogView(view)  //设置弹窗布局,直接传入View.setWidth(600)  //设置弹窗宽度(px).setHeight(800)  //设置弹窗高度(px).setScreenWidthAspect(this, 0.8f)   //设置弹窗宽度(参数aspect为屏幕宽度比例 0 - 1f).setScreenHeightAspect(this, 0.3f)  //设置弹窗高度(参数aspect为屏幕宽度比例 0 - 1f).setGravity(Gravity.CENTER)     //设置弹窗展示位置.setTag("DialogTest")   //设置Tag.setDimAmount(0.6f)     //设置弹窗背景透明度(0-1f).setCancelableOutside(true)     //弹窗在界面外是否可以点击取消.setCancelable(true)    //弹窗是否可以取消.setOnDismissListener(new DialogInterface.OnDismissListener() { //弹窗隐藏时回调方法@Overridepublic void onDismiss(DialogInterface dialog) {Toast.makeText(DiffentDialogActivity.this, "弹窗消失回调", Toast.LENGTH_SHORT).show();}}).setOnBindViewListener(new OnBindViewListener() {   //通过BindViewHolder拿到控件对象,进行修改@Overridepublic void bindView(BindViewHolder bindViewHolder) {bindViewHolder.setText(R.id.tv_content, "abcdef");bindViewHolder.setText(R.id.tv_title, "我是Title");}}).addOnClickListener(R.id.btn_left, R.id.btn_right, R.id.tv_title)   //添加进行点击控件的id.setOnViewClickListener(new OnViewClickListener() {     //View控件点击事件回调@Overridepublic void onViewClick(BindViewHolder viewHolder, View view, TDialog tDialog) {switch (view.getId()) {case R.id.btn_left:Toast.makeText(DiffentDialogActivity.this, "left clicked", Toast.LENGTH_SHORT).show();break;case R.id.btn_right:Toast.makeText(DiffentDialogActivity.this, "right clicked", Toast.LENGTH_SHORT).show();tDialog.dismiss();break;case R.id.tv_title:Toast.makeText(DiffentDialogActivity.this, "title clicked", Toast.LENGTH_SHORT).show();break;}}}).create()   //创建TDialog.show();    //展示
使用方法解析

TDialog的实现原理和系统Dialog原理差不多,主要使用Builder设计模式实现 1.创建弹窗,传入xml布局文件或者传入View控件,且自己设置背景色,因为默认是透明背景色

new TDialog.Builder(getSupportFragmentManager()).setLayoutRes(R.layout.dialog_click).setDialogView(view).create().show();

2.设置弹窗的宽高(如果不设置宽或者高,默认使用包裹内容的高度)

   new TDialog.Builder(getSupportFragmentManager()).setLayoutRes(R.layout.dialog_click).setWidth(600)  //设置弹窗固定宽度(单位:px).setHeight(800)//设置弹窗固定高度.setScreenWidthAspect(Activity.this,0.5f) //动态设置弹窗宽度为屏幕宽度百分比(取值0-1f).setScreenHeightAspect(Activity.this,0.6f)//设置弹窗高度为屏幕高度百分比(取值0-1f).create().show();

3.设置弹窗展示的位置

.setGravity(Gravity.CENTER)
其他位置有:Gravity.Bottom / Gravity.LEFT等等和设置控件位置一样

4.设置弹窗背景色透明度(取值0-1f,0为全透明)

.setDimAmount(0.6f)

5.设置弹窗外部是否可以点击取消(默认可点击取消),和设置弹窗是否可以取消(默认可取消),弹窗隐藏时回调方法

.setCancelableOutside(true)
.setCancelable(true)//是否可以取消
.setOnDismissListener(new DialogInterface.OnDismissListener() { //弹窗隐藏时回调方法@Overridepublic void onDismiss(DialogInterface dialog) {Toast.makeText(DiffentDialogActivity.this, "弹窗隐藏回调", Toast.LENGTH_SHORT).show();}
})

6.当弹窗需要动态改变控件子view内容时,这里借鉴了RecyclerView.Adapter的设计思想,内部封装好一个BindViewHolder

.setOnBindViewListener(new OnBindViewListener() {@Overridepublic void bindView(BindViewHolder bindViewHolder) {bindViewHolder.setText(R.id.tv_content, "abcdef");bindViewHolder.setText(R.id.tv_title,"我是Title");        }
})

7.监听弹窗子控件的点击事件,内部也是通过BindViewHolder实现 addOnClickListener(ids[])只需要将点击事件控件的id传入,并设置回调接口setOnViewClickListener()

.addOnClickListener(R.id.btn_right, R.id.tv_title)
.setOnViewClickListener(new OnViewClickListener() {@Overridepublic void onViewClick(BindViewHolder viewHolder,View view1, TDialog tDialog) {switch (view1.getId()) {case R.id.btn_right:Toast.makeText(DialogEncapActivity.this, "btn_right", Toast.LENGTH_SHORT).show();tDialog.dismiss();break;case R.id.tv_title:Toast.makeText(DialogEncapActivity.this, "tv_title", Toast.LENGTH_SHORT).show();break;}}
})

8.列表弹窗-使用TListDialog,TListDialog继承自TDialog,可以使用父类所有的方法,并且扩展列表数据展示丰富setAdapter()和item点击事件回调方法setOnAdapterItemClickListener()

new TListDialog.Builder(getSupportFragmentManager()).setHeight(600).setScreenWidthAspect(this, 0.8f).setGravity(Gravity.CENTER).setAdapter(new TBaseAdapter<String>(R.layout.item_simple_text, Arrays.asList(data)) {@Overrideprotected void onBind(BindViewHolder holder, int position, String s) {holder.setText(R.id.tv, s);}}).setOnAdapterItemClickListener(new TBaseAdapter.OnAdapterItemClickListener<String>() {@Overridepublic void onItemClick(BindViewHolder holder, int position, String s, TDialog tDialog) {Toast.makeText(DiffentDialogActivity.this, "click:" + s, Toast.LENGTH_SHORT).show();tDialog.dismiss();}}).create().show();

列表弹窗

为了方便使用:

  1. 不用传入layoutRes布局文件,TDialog内部设置了一个默认的RecyclerView布局,且RecyclerView的控件id为recycler_view,背景为#ffffff
  2. setAdapter(Adapter),设置recyclerview的adapter,为了封装Adapter的item点击事件,传入的adapter需要为TBaseAdapter的实现类
  3. setOnAdapterItemClickListener(),设置adapter的点击事件
<?xml version="1.0" encoding="utf-8"?>
<android.support.v7.widget.RecyclerViewxmlns:android="http://schemas.android.com/apk/res/android"android:id="@+id/recycler_view"android:layout_width="match_parent"android:layout_height="wrap_content"android:background="#ffffff"android:orientation="vertical" />

TBaseAdapter实现:需要使用者传入item的xml布局,和List数据

public abstract class TBaseAdapter<T> extends RecyclerView.Adapter<BindViewHolder> {private final int layoutRes;private List<T> datas;private OnAdapterItemClickListener adapterItemClickListener;private TDialog dialog;protected abstract void onBind(BindViewHolder holder, int position, T t);public TBaseAdapter(@LayoutRes int layoutRes, List<T> datas) {this.layoutRes = layoutRes;this.datas = datas;}@Overridepublic BindViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {return new BindViewHolder(LayoutInflater.from(parent.getContext()).inflate(layoutRes, parent, false));}@Overridepublic void onBindViewHolder(final BindViewHolder holder, final int position) {onBind(holder, position, datas.get(position));holder.itemView.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {adapterItemClickListener.onItemClick(holder, position, datas.get(position), dialog);}});}@Overridepublic int getItemCount() {return datas.size();}public void setTDialog(TDialog tDialog) {this.dialog = tDialog;}public interface OnAdapterItemClickListener<T> {void onItemClick(BindViewHolder holder, int position, T t, TDialog tDialog);}public void setOnAdapterItemClickListener(OnAdapterItemClickListener listener) {this.adapterItemClickListener = listener;}
}

如果使用者需要使用自己的列表布局时,可以使用setListLayoutRes(layotuRes,LayoutManager)方法设置xml布局和布局管理器LayoutManager,切记xml布局中的RecyclerView的id必须设置为recycler_view(如效果图中的分享弹窗)

//底部分享
public void shareDialog(View view) {new TListDialog.Builder(getSupportFragmentManager()).setListLayoutRes(R.layout.dialog_share_recycler, LinearLayoutManager.HORIZONTAL).setScreenWidthAspect(this, 1.0f).setGravity(Gravity.BOTTOM).setAdapter(new TBaseAdapter<String>(R.layout.item_share, Arrays.asList(sharePlatform)) {@Overrideprotected void onBind(BindViewHolder holder, int position, String s) {holder.setText(R.id.tv, s);}}).setOnAdapterItemClickListener(new TBaseAdapter.OnAdapterItemClickListener<String>() {@Overridepublic void onItemClick(BindViewHolder holder, int position, String item, TDialog tDialog) {Toast.makeText(DiffentDialogActivity.this, item, Toast.LENGTH_SHORT).show();tDialog.dismiss();}}).create().show();
}

自定义列表布局

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"android:background="#242424"><TextViewandroid:id="@+id/textView3"android:layout_width="0dp"android:layout_height="50dp"android:gravity="center"android:text="分享到"android:textColor="@color/white"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent" /><android.support.v7.widget.RecyclerViewandroid:id="@+id/recycler_view"android:layout_width="0dp"android:layout_height="wrap_content"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toBottomOf="@+id/textView3" /></android.support.constraint.ConstraintLayout>
框架原理解析

TDialog的实现原理主要分为三步

  1. 实例化TDialog.Builer对象builder,然后调用各种setXXX()方法设置数据,设置的数据都保存在TController.TParams实例中
  2. create()方法调用后才会实例化TDialog对象,并将TController.TParams中设置的数据传递到TDialog的属性TController对象中
  3. show()方法调用显示弹窗
  4. UML调用时序图

 

1

 

项目github地址:https://github.com/Timmy-zzh/TDialog


作者:Timmy_zzh
链接:https://juejin.im/post/5a4f3d266fb9a01c9e45c3ad
来源:掘金
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

转载于:https://my.oschina.net/JiangTun/blog/1632011

这篇关于TDialog: DialogFragment封装,高效实现各种弹窗效果的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/307463

相关文章

Java实现MD5加密的四种方式

《Java实现MD5加密的四种方式》MD5是一种广泛使用的哈希算法,其输出结果是一个128位的二进制数,通常以32位十六进制数的形式表示,MD5的底层实现涉及多个复杂的步骤和算法,本文给大家介绍了Ja... 目录MD5介绍Java 中实现 MD5 加密方式方法一:使用 MessageDigest方法二:使用

mysql删除无用用户的方法实现

《mysql删除无用用户的方法实现》本文主要介绍了mysql删除无用用户的方法实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧... 1、删除不用的账户(1) 查看当前已存在账户mysql> select user,host,pa

Nginx配置location+rewrite实现隐性域名配置

《Nginx配置location+rewrite实现隐性域名配置》本文主要介绍了Nginx配置location+rewrite实现隐性域名配置,包括基于根目录、条件和反向代理+rewrite配置的隐性... 目录1、配置基于根目录的隐性域名(就是nginx反向代理)2、配置基于条件的隐性域名2.1、基于条件

Linux配置IP地址的三种实现方式

《Linux配置IP地址的三种实现方式》:本文主要介绍Linux配置IP地址的三种实现方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录环境RedHat9第一种安装 直接配置网卡文件第二种方式 nmcli(Networkmanager command-line

Java导入、导出excel用法步骤保姆级教程(附封装好的工具类)

《Java导入、导出excel用法步骤保姆级教程(附封装好的工具类)》:本文主要介绍Java导入、导出excel的相关资料,讲解了使用Java和ApachePOI库将数据导出为Excel文件,包括... 目录前言一、引入Apache POI依赖二、用法&步骤2.1 创建Excel的元素2.3 样式和字体2.

Java实现将Markdown转换为纯文本

《Java实现将Markdown转换为纯文本》这篇文章主要为大家详细介绍了两种在Java中实现Markdown转纯文本的主流方法,文中的示例代码讲解详细,大家可以根据需求选择适合的方案... 目录方法一:使用正则表达式(轻量级方案)方法二:使用 Flexmark-Java 库(专业方案)1. 添加依赖(Ma

使用EasyExcel实现简单的Excel表格解析操作

《使用EasyExcel实现简单的Excel表格解析操作》:本文主要介绍如何使用EasyExcel完成简单的表格解析操作,同时实现了大量数据情况下数据的分次批量入库,并记录每条数据入库的状态,感兴... 目录前言固定模板及表数据格式的解析实现Excel模板内容对应的实体类实现AnalysisEventLis

Mybatis从3.4.0版本到3.5.7版本的迭代方法实现

《Mybatis从3.4.0版本到3.5.7版本的迭代方法实现》本文主要介绍了Mybatis从3.4.0版本到3.5.7版本的迭代方法实现,包括主要的功能增强、不兼容的更改和修复的错误,具有一定的参考... 目录一、3.4.01、主要的功能增强2、selectCursor example3、不兼容的更改二、

如何使用C#串口通讯实现数据的发送和接收

《如何使用C#串口通讯实现数据的发送和接收》本文详细介绍了如何使用C#实现基于串口通讯的数据发送和接收,通过SerialPort类,我们可以轻松实现串口通讯,并结合事件机制实现数据的传递和处理,感兴趣... 目录1. 概述2. 关键技术点2.1 SerialPort类2.2 异步接收数据2.3 数据解析2.

mybatis-plus 实现查询表名动态修改的示例代码

《mybatis-plus实现查询表名动态修改的示例代码》通过MyBatis-Plus实现表名的动态替换,根据配置或入参选择不同的表,本文主要介绍了mybatis-plus实现查询表名动态修改的示... 目录实现数据库初始化依赖包配置读取类设置 myBATis-plus 插件测试通过 mybatis-plu