Skip to content

qkun0715/BasePopup

 
 

Repository files navigation

中文 | English

Logo图片似乎加载不出来

BasePopup - Android下打造通用便捷的PopupWindow

Release Candy License Api Author



有奖调查问卷:

导航


特性

  • 本库作为基类,对您的实现没有任何干预,再也不需要担心实现某些方法的时候被Api限制了
  • 无需头疼如何计算offset来进行位置控制,只需要简简单单的设置Gravity便能随心所欲的控制您的Popup
  • 无论是Animation还是Animator,只需要跟您平时一样写动画,就可以完成Popup的动效设计了,不需要xml不需要关心别的兼容性问题
  • 背景与主体分离,无论是背景模糊,亦或是背景颜色,甚至把背景换成您的View,都可以通过简单的设置完成,主体与背景隔离,不用担心事件的问题
  • 还在为Popup的触摸事件头疼吗?BasePopup帮你解决烦恼~返回键控制、外部点击透传、点击外部是否消失都只需要您动动手指头完成配置即可
  • PopupWindow自动锚定AnchorView,滑动到屏幕外自动跟随AnchorView消失,不需要复杂的逻辑设置,只需要通过linkTo方法告诉BasePopup即可帮您完成
  • 简单的PopupWindow不想新建一个类,希望拥有链式调用?没问题,QuickPopupBuilder为此而生,相信你会越用越爱~

注意事项

  • 请务必仔细阅读本README,每个版本升级请务必查阅更新日志,这可以为您减少不必要弯路
  • 2.2.2版本开始不再支持Support,建议您尽快升级到AndroidX
  • 请注意引用版本的问题,Release版本是稳定版,Candy是预览版。
    • Release版本:一般在Candy版本反复验证修复后发布到Release,如果您对稳定性要求较高,请使用Release版本。
    • Candy版本:一般新功能、issue修复都会发布到Candy版本,Candy版本发布比较频繁,但通常会拥有新的功能,如果您喜欢试验新功能同时对稳定性要求不高,请使用Candy版本。
    • Release和Candy两个版本互相切换可能会导致Build失败,这时候您Clean一下Project即可
  • 从16年第一次提交到现在,本人技术也一直在进步,BasePopup也会一直迭代更新,所以,请谨慎选择版本哦~一不小心就颠覆了之前的实现。

环境依赖

请把下述 {$latestVersion} 替换为上面表格中对应的版本。

自2.2.2版本开始,BasePopup将完全迁移至AndroidX,不再提供扩展组件了,BasePopup建议您尽早迁移到AndroidX

  • Release: implementation 'com.github.razerdp:BasePopup:{$latestVersion}'
  • Candy: implementation 'com.github.razerdp:BasePopup_Candy:{$latestVersion}'

文档

BasePopup配备完善的文档,建议您优先查阅文档。

BasePopup手册


更新日志 (历史更新)

正在开发日志(Candy版本)请查看dev分支: branch-dev

  • 【Release】2.2.18 (2021/01/19)【请更新到该版本】

    • 修复一个严重bug:适配键盘后导致触摸事件分发错误 #388
  • 2.2.13 (2021/01/15)

    • 啦啦啦,新年第一个版本~在此先预祝大家新年快乐,心想事成!以及疫情快走!
    • 在2.2.13版本中,我们修复了一些bug,以及添加一丢丢功能,下面是更新详情
    • 【功能增加】
      • 增加setShowKeybaordDelay():该方法允许您设置键盘弹出延时,默认350ms
    • 【优化】
      • 优化decorview事件拦截 #378
      • 优化lifecycle绑定对象,修复了在fragment使用销毁因activity没有销毁而导致内存泄漏的问题
      • 优化touchable设置,该设置将无法让BasePopup响应任何触摸事件,纯展示用哦~
    • 【修复】
      • 修复关联AnchorView时,底部导航栏偏移计算了两次而导致底部留空的问题
      • 修复onCreate下弹窗后立马dismiss不执行的问题 #381
      • 修复decor适配最小高度的情况下,contentview没跟随更改的问题
    • 【其他】
      • 针对一些调查问卷上的问题和其他问题,我在这里说明一下
        • 【BasePopup扩展库】:扩展库虽然没怎么提交过代码,但其实一直都有写(进度很慢就是了),而且经常写着写着就来弄BasePopup的迭代,因此可能会非常缓慢,但不会弃坑,请放心
        • 【更新频率】:如你所见,正式版一般1~2个月会更新,测试版则看情况(更重要的是看心情)
        • 【动画问题】:调查问卷中有童鞋提到过动画有待优化,针对这一点,我想说的是。。。动画完全依赖于您的自定义,BasePopup只能帮助您更方便的创建动画,至于成品展示,完全看您怎么去调了
        • 【issue提问】:请务必!一定!必须!按照issue格式提交,以前因为每次都要问版本、机型、系统,隔了很久才回复我以至于我都忘记了当时的思路,因此如果您提问格式不正确,我只能忽略掉这个问题
        • 【issue关闭】:一般来说不建议您直接关掉issue,一来让大家看到,二来我会标记哪些已经修复等待release,哪些需要后面跟进,如果您关掉了我就没法追踪了
      • 最后,感谢您一直以来的支持~新的一年,请多点丢bug过来呀哈哈哈,愿BasePopup与您一同成长

例子预览


更多例子请下载Demo:apk体验下载(密码123)



打赏(看在我那么努力维护的份上。。。给个零食呗~)

Logo图片似乎加载不出来


交流群

因公司不能登录QQ,因此解散原QQ群。

同时开通微信群,主要用于交流和BasePopup的反馈,为了保证微信群的质量(主要是远离斗图党和广告党),因此只有打赏了之后才能进群~

打赏后请加微信小号:razerdp_test,并注明付款账号,定期核验后会通过


常见问题

请查阅手册:常见问题


License

FOSSA Status

Apache-2.0

Visit Count(from 2020/08/19)

About

一款针对系统PopupWindow优化的Popup库,功能强大,支持背景模糊,使用简单,你会爱上他的~

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Java 100.0%