简单封装一个易拓展的Dialog

news/2024/10/19 9:33:00/

Dialog,每个项目中多多少少都会用到,肯定也会有自己的一套封装逻辑,无论如何封装,都是奔着简单复用的思想,有的是深层次的封装,也就是把相关的UI效果直接封装好,暴露可以修改的属性和方法,让调用者根据实际业务,调用修改即可,当然也有简单的封装,只封装基本的功能,其UI和实际的动作,交给调用者,两种封装方式,各有利弊,前者调用者不用自己创建UI和实现相关动作,只需要简单的调用即可,但是不易于扩展,效果比较局限,想要拓展其他的效果,就不得不自己动手实现;后者扩展性强,因为只提供基本的调用方式,也就是说,你想要什么效果都行,毕竟是所有的UI和动作都是你自己来实现,优点是它,其缺点也是它。

前者的封装司空见惯,大多数的公司也都是采取的这样的封装,毕竟调用者实现起来也是很方便,这里就不详细说了,具体我们谈一下后者的封装,后者的封装虽然调用者需要自己来实现,但是扩展性是很强的。

今天的内容大致如下:

1、效果及代码具体调用。

2、如何封装一个Dialog。

3、开源地址。

4、总结及注意事项。

一、效果及代码具体调用

通过Kotlin的扩展函数,参数以类做为扩展,封装之后,调用非常的便捷,只需要传递你要的视图即可,我们先看下具体的案例,代码如下:

      showVipDialog {addLayout(R.layout.layout_dialog_custom)//传递dialog视图set {//Dialog操作,获取View及绑定数据}}

通过以上的代码,我们就实现了一个Dialog的弹出,addLayout方法传递视图,set扩展函数进行获取View和绑定数据,这样的一个简单的封装,我们就实现了Dialog的扩展操作,针对不同的Dialog样式,传递不同的xml视图即可。

1、快速使用

为了方便大家使用,目前已经上传到了远程maven,大家可以进行依赖使用,或者下载源码依赖也可以。

根项目build.gradle

allprojects {repositories {……maven { url "https://gitee.com/AbnerAndroid/almighty/raw/master" }}
}

在需要的Module下引入依赖

dependencies {……implementation "com.vip:dialog:1.0.0"
}

2、代码案例

源码下载之后,运行项目,就可以看到给大家提供的相关Demo,当然了,由于做到了可扩展,大家想实现什么样的效果都是可以的,毕竟视图都是自己传递的。

由于所有的案例都是调用开头的代码,就不一一列举了,简单的列举几个。

普通的提示框

普通的提示框,可以按照下面的代码逻辑进行调用。

showVipDialog {addLayout(R.layout.layout_dialog_custom)//添加弹出的视图set {//逻辑处理,获取view,绑定数据setDialogCancelable(false)//点击空白不消失val btnConfirm = findView<TextView>(R.id.dialog_button_confirm)//获取ViewbtnConfirm.setOnClickListener {toast("确定")dismiss()}}
}

方法一览

方法名

参数类型

概述

addLayout

int

xml视图

set

无参

逻辑处理

style

无参

dialog设置样式

setDialogCancelable

Boolean

点击空白是否消失,默认true消失,false为不消失

findView

int

控件id,泛型为控件

dismiss

无参

隐藏dialog

getDialogView

无参

获取当前View视图

DataBinding形式的提示框

DataBinding形式和普通的区别在于,不用再获取View视图,由普通的set扩展函数改为bind扩展函数,泛型为Binding,记得把xml视图进行convert to data binding layout。

showVipDialog {addLayout(R.layout.layout_dialog_custom)//添加弹出的视图bind<LayoutDialogCustomBinding> {//逻辑处理,获取view,绑定数据it.dialogButtonConfirm.setOnClickListener {toast("确定")dismiss()}}
}

方法一览

除了普通的方法调用之外,还可以调用下面的方法。

方法名参数概述

bind

无参

和set一样进行逻辑处理,泛型为ViewDataBinding

getDataBinding

无参

获取当前的DataBinding,用于更新视图

setPendingBindings

int

传递的BR,用于xml和Data数据进行绑定

具体的案例大家直接可以看源码,源码中提供了很多常见的效果,都是可以自定义实现的,具体的就不罗列了,本身没有多少难度。

确认框

输入框

底部列表

菊花加载

二、如何封装一个Dialog

这样的一个简单的Dialog如何进行封装呢?在封装之前,我们首先要明确封装思路,1、视图由调用者传递,2、逻辑操作由调用者处理,3、样式也由调用者进行设置,也就是说,我们只封装基本的dialog使用,也就是一个壳,具体的内容,统统交给调用者进行处理,有了这三个思路我们就可以进行着手封装了。

1、封装BaseDialog

封装Base的原因,在于统一管理子类,在于简化子类的代码逻辑,便于提供公共的方法让子类实现或调用,BaseDialog这里继承的是DialogFragment,最大的原因就是,容易通过生命周期回调来管理弹窗,还有对于复杂样式的弹窗,使用DialogFragment会更加方便和高效。

和之前封装Activity一样,做为一个抽象父类,子类要实现的无非就是,视图的传递和逻辑的处理,我们就可以在父类中进行定义抽象方法,Dialog一般有自己定义的样式,我们也可以定义一个初始化样式的方法。

/*** AUTHOR:AbnerMing* INTRODUCE:初始化数据*/abstract fun initData()/*** AUTHOR:AbnerMing* INTRODUCE:初始化样式*/abstract fun initStyle()/*** AUTHOR:AbnerMing* INTRODUCE:传递的视图*/abstract fun getLayoutId(): Int

除了必要实现的方法之外,我们还可以把一些公用的方法,定义到Base里,如获取View的方法,获取控件的方法等,这么做的目的,便于子类自定义实现一些效果以及减少findViewById的调用次数。

 /*** AUTHOR:AbnerMing* INTRODUCE:获取View视图*/fun <V> findView(id: Int): View {var view = mViewSparseArray[id]if (view == null) {view = mView?.findViewById(id)mViewSparseArray.put(id, view)}return view}/*** AUTHOR:AbnerMing* INTRODUCE:获取当前View视图*/fun getDialogView(): View {return mView!!}

以上只是列举了几个实现的方法,完整的代码,大家可以看源码中的BaseDialog类。

2、拓展ViewDataBinding形式Dialog

正常的普通Dialog就可以继承BaseDialog,基本就可以满足需要的,若是要和ViewDataBinding进行结合,那么就需要拓展需求了,具体的拓展也很简单,一是绑定View,二是绑定数据,完整的代码,大家可以看源码中BaseBindingDialog类。

绑定View

通过DataBindingUtil的bind方法,得到ViewDataBinding。

mBinding = DataBindingUtil.bind(getDialogView())

绑定数据

完成xml视图和数据的绑定。

  mBinding.setVariable(variableId, t)mBinding.executePendingBindings()

3、封装工具类,拓展相关功能

为了更加方便的让调用者使用,封装拓展函数是很有必要的,要不然,调用者每次都得要继承上边的两个父类,这样的代码就会增加很多,还会创建很多的类,我们需要单独的创建一个工具类,来实例化我们需要简化的功能逻辑。

提供添加xml视图的方法

很简单的一个普通方法,没什么好说的,把传递的xml,赋值给重写的getLayoutId方法即可。

   /*** AUTHOR:AbnerMing* INTRODUCE:设置layout* @param mLayoutId xml布局*/fun addLayout(mLayoutId: Int): VipDialog {this.mLayoutId = mLayoutIdreturn this}

提供普通使用和DataBinding形式使用方法

普通和DataBinding方法,这里用到了接口回调,接口的实现则在initVMData方法里,两个方法本身功能是一样的,无非就是一个是普通,一个是返回ViewDataBinding。

/*** AUTHOR:AbnerMing* INTRODUCE:初始化数据*/fun <VB : ViewDataBinding> bind(block: (bind: VB) -> Unit): VipDialog {setDataCallBackListener(object : OnDialogDataCallbackListener {override fun dataCallback() {block.invoke(getDataBinding())}})return this}/*** AUTHOR:AbnerMing* INTRODUCE:初始化数据*/fun set(block: () -> Unit): VipDialog {setDataCallBackListener(object : OnDialogDataCallbackListener {override fun dataCallback() {block.invoke()}})return this}

提供设置样式的方法

样式的设置也就是使用了接口回调。

 /*** AUTHOR:AbnerMing* INTRODUCE:设置样式*/fun style(style: () -> Unit): VipDialog {setStyleCallBackListener(object : OnStyleCallBackListener {override fun styleCallback() {style.invoke()}})return this}

提供获取ViewDataBinding的方法

这个方法的提供是便于拿到ViewDataBinding,有效的更新视图数据。

  /*** AUTHOR:AbnerMing* INTRODUCE:获取ViewDataBinding*/fun <VB : ViewDataBinding> getDataBinding(): VB {return mBinding as VB}

我们看下整体的代码,如下:

/***AUTHOR:AbnerMing*DATE:2022/11/22*INTRODUCE:实例化功能*/
class VipDialog : BaseBindingDialog<ViewDataBinding>() {companion object {fun init(): VipDialog {return VipDialog()}}private var mLayoutId = 0override fun initVMData() {mOnDialogDataCallbackListener?.dataCallback()}override fun initStyle() {mOnStyleCallBackListener?.styleCallback()}override fun getLayoutId(): Int {return mLayoutId}/*** AUTHOR:AbnerMing* INTRODUCE:获取ViewDataBinding*/fun <VB : ViewDataBinding> getDataBinding(): VB {return mBinding as VB}/*** AUTHOR:AbnerMing* INTRODUCE:设置layout* @param mLayoutId xml布局*/fun addLayout(mLayoutId: Int): VipDialog {this.mLayoutId = mLayoutIdreturn this}/*** AUTHOR:AbnerMing* INTRODUCE:初始化数据*/fun <VB : ViewDataBinding> bind(block: (bind: VB) -> Unit): VipDialog {setDataCallBackListener(object : OnDialogDataCallbackListener {override fun dataCallback() {block.invoke(getDataBinding())}})return this}/*** AUTHOR:AbnerMing* INTRODUCE:初始化数据*/fun set(block: () -> Unit): VipDialog {setDataCallBackListener(object : OnDialogDataCallbackListener {override fun dataCallback() {block.invoke()}})return this}/*** AUTHOR:AbnerMing* INTRODUCE:设置样式*/fun style(style: () -> Unit): VipDialog {setStyleCallBackListener(object : OnStyleCallBackListener {override fun styleCallback() {style.invoke()}})return this}private var mOnDialogDataCallbackListener: OnDialogDataCallbackListener? = nullprivate fun setDataCallBackListener(mOnDialogDataCallbackListener: OnDialogDataCallbackListener) {this.mOnDialogDataCallbackListener = mOnDialogDataCallbackListener}private var mOnStyleCallBackListener: OnStyleCallBackListener? = nullprivate fun setStyleCallBackListener(mOnStyleCallBackListener: OnStyleCallBackListener) {this.mOnStyleCallBackListener = mOnStyleCallBackListener}}

4、封装拓展函数,简化调用

dialog的弹出可能有很多场景,比如Activity里,比如Fragment里,比如一个工具类中,我们可以根据已知的场景,来定义我们的调用方式,目前,我定义了两种,在Activity或者Fragment里可以直接进行调用,也就是开头的调用方式,当然了,大家也可以自己拓展。

/*** AUTHOR:AbnerMing* INTRODUCE:Activity显示Dialog*/
fun AppCompatActivity.showVipDialog(vipDialog: VipDialog.() -> Unit): VipDialog {val dialog = VipDialog.init()dialog.apply(vipDialog)setActivityDialog(this.supportFragmentManager, dialog)return dialog
}/*** AUTHOR:AbnerMing* INTRODUCE:Fragment显示Dialog*/
fun Fragment.showVipDialog(vipDialog: VipDialog.() -> Unit): VipDialog {val dialog = VipDialog.init()dialog.apply(vipDialog)setActivityDialog(this.childFragmentManager, dialog)return dialog
}

通过以上几步,我们就可以实现开头的简单调用,具体的大家可以查看相关源码。

三、开源地址

项目地址:https://github.com/AbnerMing888/VipDialog

四、总结及注意事项

在开头已经阐述,这种方式易于拓展,但是代码量相对比较多,毕竟所有的UI和逻辑都必须独自来处理,在项目中的解决方式为,如果很多的弹框效果一样,建议再封装一层,抽取公共的工具类。

还有一个需要注意的,本身扩展函数showVipDialog返回的就是调用的类,也就是一个Dialog,大家可以直接获取变量,在其他的地方做更新Dialog或者销毁的操作。

val dialog=showVipDialog {……      
}


http://www.ppmy.cn/news/663.html

相关文章

【吴恩达机器学习笔记】八、应用机器学习的建议

✍个人博客&#xff1a;https://blog.csdn.net/Newin2020?spm1011.2415.3001.5343 &#x1f4e3;专栏定位&#xff1a;为学习吴恩达机器学习视频的同学提供的随堂笔记。 &#x1f4da;专栏简介&#xff1a;在这个专栏&#xff0c;我将整理吴恩达机器学习视频的所有内容的笔记&…

DataFrame API入门操作及代码展示

文章目录DataFrame风格编程DSL风格编程代码示例相关API相关代码示例SQL风格编程代码示例相关API相关代码Fucntions包基于SparkSQL的WordCount代码编写DataFrame风格编程 DataFrame支持两种风格进行编程 DSL风格SQL风格 DSL称之为领域特定语言&#xff0c;其实就是指DataFrame特…

会员营销中,数字会员模式如何打造差异化会员服务

在现在的市场上&#xff0c;针对用户运营这个环节&#xff0c;一般企业采用最多的就是进行会员营销&#xff0c;这是为什么呢&#xff1f;这是因为对于会员&#xff0c;用户是没有过多的抵触的&#xff0c;在以往用户的惯有概念中&#xff0c;会员是普遍存在的&#xff0c;拥有…

TensorFlow之文本分类算法-5

1 前言 2 收集数据 3 探索数据 4 选择模型 5 准备数据 6 模型-构建训练评估 构建输出层 构建n-gram模型 根据前面章节的描述&#xff0c;n-gram模型是独立地处理分词&#xff0c;与原文中的单词顺序不相关。简单的多层神经感知&#xff08;逻辑回归&#xff09;、梯度推…

图神经网络简介

本篇文章是我在2022年阅读完distill上一篇文章"A Gentle Introduction to Graph Neural Networks"后自己的一些心得。 目录 一、不同类型的数据如何以图的形式保存 二、图结构可以处理的问题 三、图机器学习的挑战 四、图神经网络 一、不同类型的数据如何以图的…

第十九章《类的加载与反射》第4节:注解

在8.10小节曾经简单的介绍过注解,但当时只是简单的介绍了3个注解的作用,本小节将详细讲解注解的相关知识。注解始于JDK1.5,在Java语言中以Annotation接口表示注解。注解其实是代码里的特殊标记,这些标记可以在编译、类加载、运行时被读取,并执行相应的处理。通过使用注解,…

什么是短网址?如何调用接口生成短地址?

随着网络应用的深入和普及&#xff0c;网址资源越来越少了&#xff0c;长尾网址也派上用场了&#xff0c;只是网址太长不方便识别与记录。因此&#xff0c;就有了短网址替代长网址的技术接口。 随着SEO的重要性越来越明显&#xff0c;在推广的时候如果把网页链接缩短可以获得更…

Windows 环境下的 Socket 编程 4 - 基于 UDP 的服务器/客户端

在 TCP 中&#xff0c;套接字之间应该是一对一的关系。若向 10 个客户端提供服务&#xff0c;则除了守门的服务器套接字外&#xff0c;还需要 10 个服务器端套接字。但在 UDP 中&#xff0c;不管是服务器端还是客户端都只需要 1 个套接字。 基于 UDP 的数据 I/O 函数 UDP 套接…