DialogManager

一、预览(Preview)

二、导入(Import)

implementation 'com.github.javakam:dialog.core:7.6.0@aar' //核心库, 2个类
implementation 'com.github.javakam:dialog.usage:7.6.0@aar' //常用样式(如: 加载中弹窗)

implementation 'com.github.javakam:dialog.bottomsheet:7.6.0@aar' //底部弹窗(必需下面的 widget.optionview 框架)
implementation 'com.github.javakam:widget.optionview:7.6.0@aar' //单选/多选的RecyclerView,基于EasyAdapter实现

三、用法(Usage)

//1. 创建并显示弹窗
fun showLoadingDialog() {//以加载中弹窗为例
 DialogManager.with(this, R.style.AndoLoadingDialog)//建议设置主题样式(It is recommended to set the theme style)
 .useDialogFragment()//默认为`DialogFragment`实现, useDialog()表示由`Dialog`实现
 .setContentView(R.layout.layout_ando_dialog_loading) { v -> //设置显示布局 (Set display layout)
 v.findViewById<ProgressBar>(R.id.progressbar_ando_dialog_loading).visibility = View.VISIBLE
 }
 .setTitle("Title")//Need Config `<item name="android:windowNoTitle">false</item>`
 .setWidth(200)//设置宽
 .setHeight(200)//设置高
 .setSize(200, 200)//设置宽高(Set width and height)
 .setAnimationId(R.style.AndoBottomDialogAnimation)//设置动画(Set up animation)
 .setCancelable(true)
 .setCanceledOnTouchOutside(true)
 .setDimAmount(0.7F) //设置背景透明度, 0 ~ 1 之间,0为透明,1为不透明. 只要该值不是 -1, 就会应用该值
 .setDimmedBehind(false) //设置背景透明, false透明, true不透明
 .addOnGlobalLayoutListener { width, height -> }//获取显示后的真实宽高
 .setOnCancelListener {} //取消监听
 .setOnDismissListener {}//关闭监听
 .setOnKeyListener { dialog, keyCode, event -> true }//按键监听
 .setOnShowListener {}//显示监听
 .apply {
 //显示之前配置,如:
 //Display the previous configuration, such as:
 //dialog?.window?.requestFeature(Window.FEATURE_NO_TITLE)
 }
 .show()
 .apply {
 //显示之后配置, 效果和`setOnShowListener`相同
 //Configure after display, the effect is the same as `setOnShowListener`
 }
 //Dialog是否正在显示
 //Whether Dialog is showing
 DialogManager.isShowing()
 //Dialog显示后动态改变展示效果
 //The Dialog display dynamically changes the display effect
 findViewById<View>(R.id.bt_loading_progressbar_imageview).postDelayed({
 //实用性用法, 动态改变窗口文本: "加载中" -> "已完成"
 DialogManager.contentView?.findViewById<TextView>(R.id.xxx)?.text = "已完成"
 //实用性用法, 动态改变转圈儿图片
 DialogManager.contentView?.findViewById<ProgressBar>(R.id.xxx)?.visibility = View.GONE
 val image: ImageView? = DialogManager.contentView?.findViewById(R.id.xxx)
 image?.visibility = View.VISIBLE
 val anim = AnimationUtils.loadAnimation(this, ando.dialog.usage.R.anim.anim_ando_dialog_loading)
 image?.startAnimation(anim)
 //改变弹窗宽高(Change the width and height of the dialog)
 DialogManager.setWidth(280)
 DialogManager.setHeight(280)
 DialogManager.applySize()
 //控制背景亮度(Control background brightness)
 DialogManager.setDimAmount(0.3F)
 DialogManager.applyDimAmount()
 //or 直接移除背景变暗(Directly remove the background darkening)
 //DialogManager.dialog?.window?.clearFlags(WindowManager.LayoutParams.FLAG_DIM_BEHIND)
 }, 6000)
}
2. 关闭弹窗
override fun onDestroy() {
 super.onDestroy()
 DialogManager.dismiss()
}

Dialog: useDialog(); DialogFragment: useDialogFragment()

Window.addFlags / clearFlags(WindowManager.LayoutParams.FLAG_DIM_BEHIND)

四、Dialog.Window Setting

1. show()之前设置(Set before Dialog.show)

Dialog / Window.requestWindowFeature(Window.FEATURE_LEFT_ICON)

2. show()之后设置(Set after Dialog.show)

setOnShowListener {
 //对`Window`的设置需要在`Dialog`显示后才有效果
 //The setting of `Window` needs to be effective after `Dialog` is displayed
 val attributes = DialogManager.getDialog().window?.attributes
 attributes?.apply {
 width = 800
 height = 500
 gravity = Gravity.CENTER //居中显示 (Center display)
 dimAmount = 0.5f //背景透明度 (Background transparency) 0 ~ 1
 }
 DialogManager.getDialog().window?.attributes = attributes
}

五、Dialog设置动画(Dialog set animation)

1. 准备配置文件(Prepare configuration file)

<?xml version="1.0" encoding="utf-8"?>
<translate xmlns:android="http://schemas.android.com/apk/res/android"
 android:duration="@integer/integer_ando_dialog_bottom_translate_duration" android:fromXDelta="0"
 android:fromYDelta="100%" android:toXDelta="0" android:toYDelta="0" />

<?xml version="1.0" encoding="utf-8"?>
<translate xmlns:android="http://schemas.android.com/apk/res/android"
 android:duration="@integer/integer_ando_dialog_bottom_translate_duration" android:fromXDelta="0"
 android:fromYDelta="0" android:toXDelta="0" android:toYDelta="100%" />

<style name="AndoBottomDialogAnimation">
 <item name="android:windowEnterAnimation">@anim/anim_ando_dialog_bottom_in</item>
 <item name="android:windowExitAnimation">@anim/anim_ando_dialog_bottom_out</item>
</style>

2. 设置动画(Set animation)

Dialog.window.setWindowAnimations(R.style.AndoBottomDialogAnimation)

六、Dialog设置圆角(Dialog set rounded corners)

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
 <corners android:topLeftRadius="10dp" android:topRightRadius="10dp" />
 <solid android:color="@android:color/white" />
</shape>

七、Dialog设置宽高(Dialog set width and height)

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
 android:layout_width="match_parent" android:layout_height="match_parent"
 android:gravity="center">
 <LinearLayout android:layout_width="200dp" android:layout_height="150dp"
 android:layout_gravity="center" android:orientation="vertical">
 ...
 </LinearLayout>
</FrameLayout>

inflate(view, null);/inflate(resource, null, true/false);

inflate(resource, mContentParent);/inflate(resource, root, true);

DialogManager中已处理该问题(This issue has been dealt with in Dialog Manager)

fun setContentView(
 layoutId: Int,
 block: ((Dialog?, View) -> Unit)? = null
): DialogManager {
 FrameLayout(mContext ?: return this).apply {
 layoutParams = ViewGroup.LayoutParams(
 ViewGroup.LayoutParams.MATCH_PARENT,
 ViewGroup.LayoutParams.MATCH_PARENT
 )
 contentView = LayoutInflater.from(mContext).inflate(layoutId, this, true)
 ...
 }
 return this
}

八、总结(Summary)

九、感谢(Thanks)

十、遇到的BUG(BUG encountered)

//若`AndroidManifest.xml`中已经配置了`android:configChanges="orientation|screenSize|screenLayout|smallestScreenSize"`则不需要设置该项
Acticity / Context.registerComponentCallbacks(object : ComponentCallbacks {
 override fun onConfigurationChanged(newConfig: Configuration) {
 dialog?.dismiss()
 }
 override fun onLowMemory() {
 }
})

override fun onDestroy() {
 super.onDestroy()
 DialogManager.dismiss()
}

fun addOnGlobalLayoutListener(onGlobalLayout: (width: Int, height: Int) -> Unit): DialogManager {
 contentView?.viewTreeObserver?.addOnGlobalLayoutListener(object :
 ViewTreeObserver.OnGlobalLayoutListener {
 override fun onGlobalLayout() {
 contentView?.viewTreeObserver?.removeOnGlobalLayoutListener(this)
 onGlobalLayout.invoke(contentView?.width ?: 0, contentView?.height ?: 0)
 }
 })
 return this
}