KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #cli #react #mcp

GenjiDialogV2

★ 147 Open GitHub ↗

一个实用的Dialog库

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GenjiDialog

[![](https://jitpack.io/v/q876625596/GenjiDialogV2.svg)](https://jitpack.io/#q876625596/GenjiDialogV2)

#### 基于kotlin的通用dialog

开始用kotlin开发之后，
发现很多东西都能简化，毕竟kotlin的语法糖不能浪费了，所以就有了这个库，
只要我还在做Android开发，应该会一直维护该库。

#### 依赖

``` groovy
allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
```

##### androidx
``` groovy
dependencies {
    implementation 'com.github.q876625596:GenjiDialogV2:1.4.1'
}
```

##### support
``` groovy
dependencies {
    implementation 'com.github.q876625596:GenjiDialogV2:1.2.0'
}
```

##### 混淆
```
-keep public class com.ly.genjidialog.GenjiDialog { *; }
```

#### 版本更新

##### v1.4.1   优化show

##### v1.4.0   优化dataBinding的绑定部分2

##### v1.3.9   优化dataBinding的绑定部分

##### v1.3.8   修复沉浸式状态栏无法改变状态栏颜色的问题,更新kotlin到1.3.40

##### v1.3.7   修改依附在view上的坐标为屏幕的绝对坐标

##### v1.3.6   忘记增加版本号导致jitPack不编译1.3.5版本，重新发布

##### v1.3.5   kotlin升级到1.3.31,添加混淆，修复unLeak模式下dialog点击空白处关闭后，熄屏再次打开时重新显示的bug，移除onKeyListenerForOptions扩展中的dialog参数

##### v1.3.4   kotlin升级到1.3.21，默认初始化模式改为 DialogInitMode.NORMAL

##### v1.3.3   移除rx

##### v1.3.2   删除log日志

##### v1.3.0   升级到androidx

##### v1.2.0   同样是重要更新

主要修复一个内存泄露bug，这是google留下的坑
    bug描述：当DialogFragment非一次性使用的时候，在dismiss()之后，dialogFragment和dialog的Message依旧相互引用，导致内存泄露。
    解决方式：改写show方法，通过反射拿到状态值，然后在dismiss和show的时候仅使用dialog的方法
    注意事项：由于这样做，会使dialogFragment始终被add到fragmentManager中，
    所以，当在同一个activity使用多个dialogFragment时，需要注意管控，
    但是我建议每次使用时都newGenjiDialog{}，只需要保存数据就行了

-使用方法（当不是一次性使用时）
``` kotlin
val testDialog =  newGenjiDialog {
    ......
    //只需要将unLeak属性设置为true
    unLeak = true
    ......
    }.showOnWindow(supportFragmentManager)
```

##### v1.1.9   重要更新

1、kotlin升级到1.3.11
    2、新增初始化模式，现有3种模式，具体请看表格
    3、支持DataBinding
使用方法

-改变初始化模式
``` kotlin
 newGenjiDialog {
    ......
    initMode = DialogInitMode.DRAW_COMPLETE //DialogInitMode.NORMAL为默认模式
    ......
    }.showOnWindow(supportFragmentManager)
```

-DataBinding的绑定方法
``` kotlin
newGenjiDialog {
    //绑定DataBinding则不需要设置layoutId
    //layoutId = R.layout.aaa
    gravity = DialogGravity.CENTER_CENTER
    animStyle = R.style.BottomTransAlphaADAnimation
    //此方法用于创建布局对应的DataBinding,并且将创建的binding赋给dialog中的dialogBinding字段
    //最后返回视图   binding.root
    bindingListenerFun { container, dialog ->
        return@bindingListenerFun DataBindingUtil.inflate<AaaBinding>(inflater, R.layout.aaa, container, false).apply {
            this.setLifecycleOwner(dialog.viewLifecycleOwner)
            this.textStr = "hello"
            dialog.dialogBinding = this
        }.root
    }
    //初始化赋值操作(非必须)   也可以在bindingListenerFun中操作
    dataConvertListenerFun { dialogBinding, dialog ->
        dialogBinding as AaaBinding
        dialogBinding.text = "hello1"
    }
}.showOnWindow(supportFragmentManager)
```

##### v1.1.8
    1、kotlin升级到1.3.0
    2、新增自定义控件MaskView，可做新用户引导层。
使用方法
``` kotlin
 newGenjiDialog {
    layoutId = R.layout.dialog_mask
    dimAmount = 0f
    isFullHorizontal = true
    isFullVerticalOverStatusBar = true
    gravity = DialogGravity.CENTER_CENTER
    animStyle = R.style.AlphaEnterExitAnimation
    convertListenerFun { holder, dialog ->
        holder.getView<MaskView>(R.id.maskView)?.apply {
        this.highlightArea = HighlightArea(RectF(
                                this@MaskViewActivity.btn.left.toFloat(),
                                this@MaskViewActivity.btn.top.toFloat(),
                                this@MaskViewActivity.btn.right.toFloat(),
                                this@MaskViewActivity.btn.bottom.toFloat()))
            }
        }
    }.showOnWindow(supportFragmentManager)
```
详细设置请看MaskView中注释，十分详细
##### v1.1.7
    为dialog的show和dismiss新增增量方法onAddDialogShow和onAddDialogDismiss，用于在同一个监听中新增逻辑
##### v1.1.6
    修复viewHolder中的setVisible类型转换问题，kotlin升级到1.2.71

废话不多说，直接上图

![onWindow](https://raw.githubusercontent.com/q876625596/GenjiDialogV2/master/image/show_on_window.gif)

![onView](https://raw.githubusercontent.com/q876625596/GenjiDialogV2/master/image/show_on_view.gif)

![onView](https://raw.githubusercontent.com/q876625596/GenjiDialogV2/master/image/show_mask_slide.gif)

#### 内置大量基础动画，基本能满足基本需求

#### 第一次写README也不知道该怎么吹，就直接贴代码吧

``` kotlin
newGenjiDialog {
    width = dp2px(100f)
    height = dp2px(100f)
}.showOnWindow(supportFragmentManager)
```

就这么简单，一个默认居中的加载中loadDialog就出来了，如图：

![loading.GIF](https://raw.githubusercontent.com/q876625596/GenjiDialogV2/master/image/loading.gif)

### 1、位置

#### 如果我想让他显示在屏幕右上角怎么办？非常简单！

``` kotlin
newGenjiDialog {
    width = dp2px(100f)
    height = dp2px(100f)
    gravity = DialogGravity.RIGHT_TOP
}.showOnWindow(supportFragmentManager)
```
#### DialogGravity这个枚举中我设定了9种显示方式，左上，中上，右上，左中，正中，右中，左下，中下，右下
因此只需要添加一行代码指定dialog的位置就行了、效果如图：

![loading_right_top.GIF](https://raw.githubusercontent.com/q876625596/GenjiDialogV2/master/image/loading_right_top.gif)

你现在可能要问了，你只设置了9个位置，我需要偏移怎么办呢,
当然，这时候就需要用到偏移了

``` kotlin
newGenjiDialog {
    width = dp2px(100f)
    height = dp2px(100f)
    verticalMargin = dp2px(100f).toFloat()
    horizontalMargin = dp2px(100f).toFloat()
    gravity = DialogGravity.RIGHT_TOP
}.showOnWindow(supportFragmentManager)
```

就这样我就给dialog加上了横向纵向分别100dp的偏移，效果如图：

![loading_right_top_margin](https://raw.githubusercontent.com/q876625596/GenjiDialogV2/master/image/loading_right_top_margin.gif)

关于这个偏移量，这里我多说两句，原本偏移量的取值范围是在[0-1]，指的是所占屏幕宽高的百分比，
但是为了方便起见，我这里给大于1的偏移量自动换算成了百分比，如果针对个别机型有误差的，可以自行换算成[0-1]即可

### 2、动画

细心地你可能发现了，在屏幕右上角显示的时候是从屏幕边缘滑出的，
没错，我给DialogGravity的每一个显示位置都设定了默认的动画，
当没有指定动画的时候就会按照默认的动画来显示、

#### 当然自定义动画是肯定要有的
``` kotlin
newGenjiDialog {
    width = dp2px(100f)
    height = dp2px(100f)
    animStyle = R.style.ScaleADEnterExitAnimationX50Y50
    gravity = DialogGravity.RIGHT_TOP
}.showOnWindow(supportFragmentManager)
```

这样就完成了动画的自定义，当然你还可以这样写:
``` kotlin
dialog.showOnWindow(supportFragmentManager,DialogGravity.RIGHT_TOP,R.style.ScaleADEnterExitAnimationX50Y50)
```

效果如图：

![loading_right_top_scale_ad](https://raw.githubusercontent.com/q876625596/GenjiDialogV2/master/image/loading_right_top_scale_ad.gif)

内置动画我在style文件中注释写了作用，可以自己去看看

#### 如果想要贴在一个view附近怎么办？

``` kotlin
newGenjiDialog {
    width = dp2px(100f)
    height = dp2px(100f)
    animStyle = R.style.ScaleADEnterExitAnimationX50Y100
    gravityAsView = DialogGravity.CENTER_TOP
}.showOnView(supportFragmentManager,showLoading)
```

需要注意的是这里的gravaty换成了gravityAsView，效果如图：

![loading_center_top_as_view](https://raw.githubusercontent.com/q876625596/GenjiDialogV2/master/image/loading_center_top_as_view.gif)

同样你还可以这样写:
``` kotlin
dialog.showOnWindow(supportFragmentManager,DialogGravity.RIGHT_TOP,R.style.ScaleADEnterExitAnimationX50Y50)
```

##### 相对view的偏移量 offsetX和offsetY属性
这两个属性建议去DialogOptions中的dialogAsView()方法去查看方法注释

##### 附加一个稍微特殊点的滑出方式（带遮罩）
``` kotlin
newGenjiDialog { genjiDialog ->
    //设置布局
    layoutId = R.layout.slide_view_bottom
    //isLazy = true
    //设置横纵向占满
    isFullHorizontal = true
    isFullVerticalOverStatusBar = true
    //阴影透明度
    dimAmount = 0f
    //处理事件/数据绑定
    convertListenerFun { holder, dialog ->
        //设置点击realView以外的部分就dismiss
        holder.setOnClickListener(R.id.bottomTouchView) {
            if (canClick) {
                dialog.dismiss()
            }
        }.setOnClickListener(R.id.topTouchView) {
            if (canClick) {
                dialog.dismiss()
            }
        }
    }
    setOnEnterAnimator { rootView ->
        //在此处设置进入动画
        AnimatorSet().apply {
            duration = 500L
            val realView = rootView.findViewById<View>(R.id.realView)
            val touchView = rootView.findViewById<View>(R.id.bottomTouchView)
            val topTouchView = rootView.findViewById<View>(R.id.topTouchView)
            val maskLayout = rootView.findViewById<View>(R.id.maskLayout)
            //给realView的父布局(遮罩布局)设置距顶部margin
            maskLayout?.apply {
                layoutParams = (layoutParams as ConstraintLayout.LayoutParams).apply {
                    topMargin = (slideForBottom.y + slideForBottom.height).toInt()
                }
            }
            play(ObjectAnimator
                    .ofFloat(realView, "y", -UtilsExtension.dp2px(resources, 200f).toFloat(), 0f))
                    .with(ObjectAnimator
                            .ofFloat(touchView, "alpha", 0f, 1f))
                    .with(ObjectAnimator
                            .ofFloat(topTouchView, "alpha", 0f, 1f))
        }
    }
    setOnExitAnimator {
        //退出动画
        AnimatorSet().apply {
            duration = 500L
            val realView = it.findViewById<View>(R.id.realView)
            val touchView = it.findViewById<View>(R.id.bottomTouchView)
            val topTouchView = it.findViewById<View>(R.id.topTouchView)
            play(ObjectAnimator
                    .ofFloat(realView, "y", 0f, -UtilsExtension.dp2px(resources, 200f).toFloat()))
                    .with(ObjectAnimator
                            .ofFloat(touchView, "alpha", 1f, 0f))
                    .with(ObjectAnimator
                            .ofFloat(topTouchView, "alpha", 1f, 0f))
        }
    }
}.showOnWindow(supportFragmentManager)
```

效果图：

![show_mask_slide_down](https://raw.githubusercontent.com/q876625596/GenjiDialogV2/master/image/show_mask_slide_down.gif)

#### 基本的显示模式都已经说了，接下来就放一个整体可见的参数表格出来

##### GenjiDialog中
| 属性名/方法名 | 介绍 |
| ------ | ------ |
| rootView | layoutId所对应的布局 |
| getMyActivity() | 获取该dialog所在的activity |
| setDialogOptions(...) | 设置dialogOptions |
| getDialogOptions() | 获取dialogOptions |
| extendsOptions() | 当继承GenjiDialog时需要重写该方法，在该方法里面设置新的dialogOptions |
| showOnWindow(...) | 将dialog显示在屏幕中，有多个重载方法，具体可见源码注释 |
| showOnView(...) | 将dialog依附于某个View，有多个重载方法，具体可见源码注释 |

##### DialogOptions
| 属性名/方法名 | 介绍 |
| ------ | ------ |
| layoutId | 布局id，默认:R.layout.loading_layout |
| dialogStyle | dialog的样式，一般情况下不用修改，为了方便某些朋友可能有特殊需求，所以放出来可供重写，默认：DialogFragment.STYLE_NO_TITLE |
| dialogThemeFun | dialog的主题，同上，重写方法setDialogTheme(fun) |
| setStatusBarModeFun | dialog的状态栏设置，同上，重写方法setStatusMode(fun) |
| animStyle | dialog的进出动画，用于一般情况，内置了很多日常所需动画，可以到res/values/styles中查看，动画文件在res/anim中查看，默认根据gravity来判断 |
| setOnEnterAnimator(fun) | dialog的进入动画，这个动画是用于一些特殊情况，比如上面的带遮罩的滑出动画，默认：null |
| exitAnimator(fun) | dialog的退出动画，同上 （这两个动画的示例请看上面带遮罩滑出动画的代码，也可以去源码查看）|
| canClick | 否可以触发取消，默认：true，比如在动画开始时将此属性设置false，防止在动画进行时，被再次触发动画，当使用上面两种自定义特殊动画时，我已经默认添加了改变这个状态值的监听 |
| initMode | 初始化模式，默认：DialogInitMode.DRAW_COMPLETE，表示在视图绘制完成时调用convertListener，其余类型请查看DialogInitMode类 |
| duration | 懒加载的延时，默认：0L，配合isLazy使用，这个值一般设置为动画的时长，为了保证动画流畅 |
| dialogStatusBarColor | dialog的statusBar颜色，默认：透明，一般来说无需改变 |
| width | dialog宽度，默认：0px |
| height | dialog高度，默认：0px |
| isFullHorizontal | dialog是否横向占满，默认：false |
| isFullVertical | dialog是否纵向占满，默认：false，该纵向占满并非全屏，纵向占满会自动扣掉状态栏的高度 |
| isFullVerticalOverStatusBar | dialog是否纵向占满，默认：false，该纵向占满全屏不会扣掉状态栏高度,是真正的全屏 |
| verticalMargin | dialog上下边距，默认：0，详细注释请在源码中查看 |
| horizontalMargin | dialog左右边距，默认：0，详细注释请在源码中查看 |
| fullVerticalMargin | dialog在上下占满时的边距，默认：0px |
| fullHorizontalMargin | dialog在左右占满时的边距，默认：0px |
| dimAmount | dialog背景的阴影的透明度：默认：0.3f |
| gravity | dialog显示为showOnWindow()时的位置：默认：DialogGravity.CENTER_CENTER |
| gravityAsView | dialog显示为showOnView()时的位置：默认：DialogGravity.CENTER_BOTTOM |
| dialogViewX | x轴坐标值，用于特殊动画时定位dialog，默认：0px |
| dialogViewY | y轴坐标值，用于特殊动画时定位dialog，默认：0px |
| offsetX | 当dialog依附在view上时x轴的偏移量，默认：0px |
| offsetX | 当dialog依附在view上时x轴的偏移量，默认：0px |
| touchCancel | 是否点击屏幕区域取消（不包含返回按钮），默认：false |
| outCancel | 是否点击外部取消，默认：false，当 touchCancel == true时此属性无效，必须是 touchCancel和该属性均为false时，那么点击屏幕区域和返回按钮都不能关闭dialog |
| showDismissMap | 显示与消失的监听map |
| onKeyListener | 按钮监听 |
| convertListener | view初始化 |

这里我给出的属性/方法，注释不详细可以到DialogOptions源码里面查看，那里面注释很详细

#### 因为也是第一次写kotlin的库，可能有一些东西不算很完美，希望有能力强的大佬能够指出

# 喜欢的话请点个star支持一下，谢谢

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

GenjiDialogV2

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README