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)//点击空白不消失valbtnConfirm=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:初始化数据*/abstractfuninitData() /*** AUTHOR:AbnerMing* INTRODUCE:初始化样式*/abstractfuninitStyle() /*** AUTHOR:AbnerMing* INTRODUCE:传递的视图*/abstractfungetLayoutId(): Int
除了必要实现的方法之外,我们还可以把一些公用的方法,定义到Base里,如获取View的方法,获取控件的方法等,这么做的目的,便于子类自定义实现一些效果以及减少findViewById的调用次数。
/*** AUTHOR:AbnerMing* INTRODUCE:获取View视图*/fun<V>findView(id: Int): View { varview=mViewSparseArray[id] if (view==null) { view=mView?.findViewById(id) mViewSparseArray.put(id, view) } returnview } /*** AUTHOR:AbnerMing* INTRODUCE:获取当前View视图*/fungetDialogView(): View { returnmView!! }
以上只是列举了几个实现的方法,完整的代码,大家可以看源码中的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布局*/funaddLayout(mLayoutId: Int): VipDialog { this.mLayoutId=mLayoutIdreturnthis }
提供普通使用和DataBinding形式使用方法
普通和DataBinding方法,这里用到了接口回调,接口的实现则在initVMData方法里,两个方法本身功能是一样的,无非就是一个是普通,一个是返回ViewDataBinding。
/*** AUTHOR:AbnerMing* INTRODUCE:初始化数据*/fun<VB : ViewDataBinding>bind(block: (bind: VB) ->Unit): VipDialog { setDataCallBackListener(object : OnDialogDataCallbackListener { overridefundataCallback() { block.invoke(getDataBinding()) } }) returnthis } /*** AUTHOR:AbnerMing* INTRODUCE:初始化数据*/funset(block: () ->Unit): VipDialog { setDataCallBackListener(object : OnDialogDataCallbackListener { overridefundataCallback() { block.invoke() } }) returnthis }
提供设置样式的方法
样式的设置也就是使用了接口回调。
/*** AUTHOR:AbnerMing* INTRODUCE:设置样式*/funstyle(style: () ->Unit): VipDialog { setStyleCallBackListener(object : OnStyleCallBackListener { overridefunstyleCallback() { style.invoke() } }) returnthis }
提供获取ViewDataBinding的方法
这个方法的提供是便于拿到ViewDataBinding,有效的更新视图数据。
/*** AUTHOR:AbnerMing* INTRODUCE:获取ViewDataBinding*/fun<VB : ViewDataBinding>getDataBinding(): VB { returnmBindingasVB }
我们看下整体的代码,如下:
/***AUTHOR:AbnerMing*DATE:2022/11/22*INTRODUCE:实例化功能*/classVipDialog : BaseBindingDialog<ViewDataBinding>() { companionobject { funinit(): VipDialog { returnVipDialog() } } privatevarmLayoutId=0overridefuninitVMData() { mOnDialogDataCallbackListener?.dataCallback() } overridefuninitStyle() { mOnStyleCallBackListener?.styleCallback() } overridefungetLayoutId(): Int { returnmLayoutId } /*** AUTHOR:AbnerMing* INTRODUCE:获取ViewDataBinding*/fun<VB : ViewDataBinding>getDataBinding(): VB { returnmBindingasVB } /*** AUTHOR:AbnerMing* INTRODUCE:设置layout* @param mLayoutId xml布局*/funaddLayout(mLayoutId: Int): VipDialog { this.mLayoutId=mLayoutIdreturnthis } /*** AUTHOR:AbnerMing* INTRODUCE:初始化数据*/fun<VB : ViewDataBinding>bind(block: (bind: VB) ->Unit): VipDialog { setDataCallBackListener(object : OnDialogDataCallbackListener { overridefundataCallback() { block.invoke(getDataBinding()) } }) returnthis } /*** AUTHOR:AbnerMing* INTRODUCE:初始化数据*/funset(block: () ->Unit): VipDialog { setDataCallBackListener(object : OnDialogDataCallbackListener { overridefundataCallback() { block.invoke() } }) returnthis } /*** AUTHOR:AbnerMing* INTRODUCE:设置样式*/funstyle(style: () ->Unit): VipDialog { setStyleCallBackListener(object : OnStyleCallBackListener { overridefunstyleCallback() { style.invoke() } }) returnthis } privatevarmOnDialogDataCallbackListener: OnDialogDataCallbackListener?=nullprivatefunsetDataCallBackListener(mOnDialogDataCallbackListener: OnDialogDataCallbackListener) { this.mOnDialogDataCallbackListener=mOnDialogDataCallbackListener } privatevarmOnStyleCallBackListener: OnStyleCallBackListener?=nullprivatefunsetStyleCallBackListener(mOnStyleCallBackListener: OnStyleCallBackListener) { this.mOnStyleCallBackListener=mOnStyleCallBackListener } }
4、封装拓展函数,简化调用
dialog的弹出可能有很多场景,比如Activity里,比如Fragment里,比如一个工具类中,我们可以根据已知的场景,来定义我们的调用方式,目前,我定义了两种,在Activity或者Fragment里可以直接进行调用,也就是开头的调用方式,当然了,大家也可以自己拓展。
/*** AUTHOR:AbnerMing* INTRODUCE:Activity显示Dialog*/funAppCompatActivity.showVipDialog(vipDialog: VipDialog.() ->Unit): VipDialog { valdialog=VipDialog.init() dialog.apply(vipDialog) setActivityDialog(this.supportFragmentManager, dialog) returndialog} /*** AUTHOR:AbnerMing* INTRODUCE:Fragment显示Dialog*/funFragment.showVipDialog(vipDialog: VipDialog.() ->Unit): VipDialog { valdialog=VipDialog.init() dialog.apply(vipDialog) setActivityDialog(this.childFragmentManager, dialog) returndialog}
通过以上几步,我们就可以实现开头的简单调用,具体的大家可以查看相关源码。
三、开源地址
项目地址:https://github.com/AbnerMing888/VipDialog
四、总结及注意事项
在开头已经阐述,这种方式易于拓展,但是代码量相对比较多,毕竟所有的UI和逻辑都必须独自来处理,在项目中的解决方式为,如果很多的弹框效果一样,建议再封装一层,抽取公共的工具类。
还有一个需要注意的,本身扩展函数showVipDialog返回的就是调用的类,也就是一个Dialog,大家可以直接获取变量,在其他的地方做更新Dialog或者销毁的操作。
valdialog=showVipDialog { ……}