# CommonPopupWindow
**Repository Path**: fangbinbin1990/CommonPopupWindow
## Basic Information
- **Project Name**: CommonPopupWindow
- **Description**: Popular popupwindow in the market and customized（结合市面流行的弹窗样式+支持自定义布局）.
- **Primary Language**: Android
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 6
- **Created**: 2019-02-28
- **Last Updated**: 2020-12-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# CommonPopupWindow
Popular popupwindow in the market and customized.
[  ](https://bintray.com/resetmyself/holdon/commonpop/1.0.4/link)
（结合市面流行的弹窗样式+支持自定义布局）.
# Description
>poplibrary引入即可调用弹窗
>(其他配置待续)
>目前集成库后apk大小约增加了196KB(默认分享图片资源总大小约100KB)
# Feature
>支持自定义布局(所有点击事件统一回调)
>底部分享弹窗-结合市面流行样式(目前两种主流样式，如需增加请issue)
>注册登录弹窗基本样式(登录可以设置显示多种组合样式)
>更新弹窗(目前经典样式)
>基于更新弹窗+Rx家族的App更新模块1.0.1.4(只包含自定义1.0.1+更新弹窗1.0.4) (第一版完成)
# Effect
>总的效果
~V1.0.1
- 2019.02.14 - - 自定义布局
~V1.0.2
- 2019.02.16 - - 添加分享弹窗
~V1.0.3
- 2019.02.19 - - 添加注册登录弹窗
~V1.0.4
- 2019.02.20 - - 添加经典更新弹窗
~V1.0.1.4
- 2019.02.22 - - APP更新模块
##### [Demo apk下载](https://github.com/FanChael/CommonPopupWindow/blob/master/doc/app-debug.apk)
# Import Library
>For gradle:
```Java
//1.0.1 自定义
implementation 'com.hl:poplibrary:1.0.1'
//1.0.2 自定义+分享弹窗
implementation 'com.hl:poplibrary:1.0.2'
//1.0.3 自定义+分享弹窗+注册登录弹窗
implementation 'com.hl:poplibrary:1.0.3'
//1.0.4 自定义+分享弹窗+注册登录弹窗+更新弹窗
implementation 'com.hl:poplibrary:1.0.4'
//1.0.1.4 App更新请移步传送门
//依赖过可以忽略（使用分享弹窗需要依赖）/1.0.2
implementation 'com.android.support:recyclerview-v7:28.0.0'//看你版本
//依赖过可以忽略（使用注册登录弹窗需要依赖）/1.0.3
implementation 'com.android.support:design:28.+'//看你版本
```
>Or in maven:
```Java
com.hl
poplibrary
1.0.x
pom
```
# 传送门
> 使用
* [分享弹窗使用](https://github.com/FanChael/CommonPopupWindow/blob/master/doc/library/share_guid.md)
* [注册登录弹窗使用](https://github.com/FanChael/CommonPopupWindow/blob/master/doc/library/login_register_guid.md)
* [更新弹窗使用](https://github.com/FanChael/CommonPopupWindow/blob/master/doc/library/updagrade_guid.md)
* [APP更新使用](https://github.com/FanChael/CommonPopupWindow/tree/appupdate)
> Hold on！
* [更新日志](https://github.com/FanChael/CommonPopupWindow/blob/master/doc/library/update_guid.md)
* [学习博客](https://github.com/FanChael/CommonPopupWindow/blob/master/doc/library/study_guid.md)
* [指教交流QQ群: 752871516](https://github.com/FanChael/CommonPopupWindow#传送门)
# API
>调用类介绍(重点关注自定义布局视图类BasePopView)
+BasePopView、SharePopView是主要调用类，对创建显示进行了一定封装
+同时也是提供方位，动画、监听属性的关键类
>显示方位介绍
方位分两种:
a.一种是基于点击控件的位置显示
b. 另外一种是简单的上下左右居中的位置显示
```Java
/**
* 显示方位【基于控件】
*/
public enum GRAVITY {
LEFTTOP_TO_LEFTBOTTOM, LEFTTOP_TO_RIGHTBOTTOM,
LEFTTOP_TO_LEFTTOP, LEFTTOP_TO_RIGHTTOP,
RIGHTTOP_TO_LEFTBOTTOM, RIGHTTOP_TO_RIGHTBOTTOM,
RIGHTTOP_TO_RIGHTTOP, RIGHTBOTTOM_TO_LEFTTOP,
RIGHTBOTTOM_TO_RIGHTTOP, LEFTBOTTOM_TO_RIGHTTOP,
LEFTBOTTOM_TO_LEFTTOP
}
/**
* 简单上下左右中显示
*/
public enum SIMPLE_GRAVITY {
CENTER_IN_PARENT, FROM_BOTTOM, FROM_TOP,
FROM_LEFT, FROM_RIGHT
}
```
>动画介绍
居于控件方位显示可以设置SCALE动画
居于简单平移显示可以设置平移动画
其他情况设置动画不会生效
```Java
/**
* 显示动画
*/
public enum ANIMATION {
NONE, SCALE, TRANSLATE
}
```
>调用接口介绍
1.自定义弹窗方式 - 提供调用类 BasePopView.java
```Java
/**
* 传递对应参数进行窗体创建和显示
* @param _context 【必填】
* @param _anchor 【必填】
* @param _layoutResId 【必填】
* @param _popW 不需要给 < 0 - 那样需要自己做好布局自适应处理
* @param _popH 不需要给 < 0 - 那样需要自己做好布局自适应处理
* @param bOutsideTouchable 【必填】
* @param _backColor - 不需要给-1
* @param _animation - 不需要给null
* @param _onClickListenner - 不需要给null
* @param _gravity 【必填】 BasePopView.SIMPLE_GRAVITY
* @return BasePop.Builder
*/
public static BasePop.Builder show(Context _context, View _anchor,
int _layoutResId, int _popW, int _popH,
boolean bOutsideTouchable, int _backColor,
BasePopView.ANIMATION _animation,
BasePopView.OnClickListenner _onClickListenner,
BasePopView.SIMPLE_GRAVITY _gravity){
return show(_context, _anchor, _layoutResId, _popW, _popH,
bOutsideTouchable, _backColor, _animation,
_onClickListenner, null, _gravity);
}
/**
* 传递对应参数进行窗体创建和显示
* @param _context 【必填】
* @param _anchor 【必填】
* @param _layoutResId 【必填】
* @param _popW 不需要给 < 0 - 那样需要自己做好布局自适应处理
* @param _popH 不需要给 < 0 - 那样需要自己做好布局自适应处理
* @param bOutsideTouchable 【必填】
* @param _backColor - 不需要给-1
* @param _animation - 不需要给null
* @param _onClickListenner - 不需要给null
* @param _gravity 【必填】 BasePopView.GRAVITY
* @return BasePop.Builder
*/
public static BasePop.Builder show(Context _context, View _anchor,
int _layoutResId, int _popW, int _popH,
boolean bOutsideTouchable, int _backColor,
BasePopView.ANIMATION _animation,
BasePopView.OnClickListenner _onClickListenner,
BasePopView.GRAVITY _gravity){
return show(_context, _anchor, _layoutResId, _popW, _popH,
bOutsideTouchable, _backColor, _animation,
_onClickListenner, _gravity, null);
}
/**
* 传递对应参数进行窗体创建和显示
* @param _context 【必填】
* @param _anchor 【必填】
* @param _layoutResId 【必填】
* @param _popW 不需要给 < 0 - 那样需要自己做好布局自适应处理
* @param _popH 不需要给 < 0 - 那样需要自己做好布局自适应处理
* @param bOutsideTouchable 【必填】
* @param _backColor - 不需要给-1
* @param _animation - 不需要给null
* @param _onClickListenner - 不需要给null
* @param _gravity 【与_sgravity选一个】 BasePopView.GRAVITY
* @param _sgravity 【与_gravity选一个】 BasePopView.SIMPLE_GRAVITY
* @return BasePop.Builder
*/
private static BasePop.Builder show(Context _context, View _anchor,
int _layoutResId, int _popW, int _popH,
boolean bOutsideTouchable, int _backColor,
BasePopView.ANIMATION _animation,
BasePopView.OnClickListenner _onClickListenner,
BasePopView.GRAVITY _gravity, BasePopView.SIMPLE_GRAVITY _sgravity){
}
```
2.分享弹窗 - 提供调用类 SharePopView.java
>目前提供两种显示样式
```Java
/**
* 分享弹窗样式
* ME - 自家的
* TENCENT - 仿腾讯
*/
public enum SHARE_TYPE{
ME, F_TENCENT
}
```
>分享列表提供横向滑动+网格类型
```Java
/**
* 分享列表显示模式
* HORIZON - 水平滑动 Item's Count > 5个的情况下
* GRID - 网格 5列
*/
public enum SHOW_TYPE{
HORIZON, GRID
}
```
>调用显示方法
```Java
/**
* 显示分享弹窗 - 默认大于5个方可左右滑动
* @param _context
* @param _achor
* @param _share2Name - 如果传null，默认提供朋友圈、微信、qq、新浪、复制链接
* @param _share2Icon
* @param _simple_gravity - 支持从下到上以及从上到下显示方式
* @param _show_type
* @param _onShareClickListenner
* @return
*/
public static BasePop.Builder showShare(Context _context, View _achor,
List _share2Name, List _share2Icon,
BasePopView.SIMPLE_GRAVITY _simple_gravity,
SharePopView.SHOW_TYPE _show_type,
OnEventListenner.OnShareClickListenner _onShareClickListenner){
return new Builder(_context)
.create(_achor, SHARE_TYPE.ME)
.setTitleAndIcon(_share2Name, _share2Icon)
.showShareBorder(_simple_gravity, _show_type, _onShareClickListenner);
}
/**
* 显示分享弹窗 - 默认大于5个方可左右滑动
* @param _context
* @param _achor
* @param _share2Name- 如果传null，默认提供朋友圈、微信、qq、新浪、复制链接
* @param _share2Icon
* @param _simple_gravity- 支持从下到上以及从上到下显示方式
* @param _show_type
* @param _onShareClickListenner
* @return
*/
public static BasePop.Builder showShareFTencent(Context _context, View _achor,
List _share2Name, List _share2Icon,
BasePopView.SIMPLE_GRAVITY _simple_gravity,
SharePopView.SHOW_TYPE _show_type,
OnEventListenner.OnShareClickListenner _onShareClickListenner){
return new Builder(_context)
.create(_achor, SHARE_TYPE.F_TENCENT)
.setTitleAndIcon(_share2Name, _share2Icon)
.showShareBorder(_simple_gravity, _show_type, _onShareClickListenner);
}
```
##### 3.后续新的功能的用法，请移步传送门
# USE
#### --> 自定义方式
a. 基于控件(achor_view)右下角显示
```Java
// BasePopView.ANIMATION animation可以传null或者BasePopView.NONE
BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this) / 2, 500,
BasePopView.ANIMATION.SCALE, null,
BasePopView.GRAVITY.LEFTTOP_TO_RIGHTBOTTOM);
```
b. 基于控件(achor_view)左下角显示
```Java
BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this) / 2, 500,
BasePopView.ANIMATION.SCALE, null,
BasePopView.GRAVITY.RIGHTTOP_TO_LEFTBOTTOM);
```
c. 基于控件(achor_view)右上角显示
```Java
BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this) / 2, 500,
BasePopView.ANIMATION.SCALE, null,
BasePopView.GRAVITY.LEFTBOTTOM_TO_RIGHTTOP);
```
d. 基于控件(achor_view)左上角显示
```Java
BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this) / 2, 500,
BasePopView.ANIMATION.SCALE, null,
BasePopView.GRAVITY.RIGHTBOTTOM_TO_LEFTTOP);
```
e. 居中显示
```Java
BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this) / 2, 500,
BasePopView.ANIMATION.SCALE, null,
BasePopView.SIMPLE_GRAVITY.CENTER_IN_PARENT);
```
f. 从上往下平移显示
```Java
BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this), 500,
BasePopView.ANIMATION.TRANSLATE, null,
BasePopView.SIMPLE_GRAVITY.FROM_TOP);
```
g. 从下往上平移显示
```Java
BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this), 500,
BasePopView.ANIMATION.TRANSLATE, null,
BasePopView.GRAVITY.FROM_BOTTOM);
```
h. 从左往右平移显示
```Java
BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this) / 4, ScreenUtil.getScreenH(this),
BasePopView.ANIMATION.TRANSLATE, null,
BasePopView.GRAVITY.FROM_LEFT);
```
i. 从右往左平移显示
```Java
BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this) / 4, ScreenUtil.getScreenH(this),
BasePopView.ANIMATION.TRANSLATE, null,
BasePopView.GRAVITY.FROM_RIGHT);
```
#### --> 其他使用请移步传送门
# ATTENTION
>Animation:
1.基于控件方位(GRAVITY)显示的方式-平移动画无效
2.基于简单上下左右平移(SIMPLE_GRAVITY)显示的方式-缩放无效
3.居中显示方式-只有居中缩放动画
4.不需要动画传null即可
# 其他逻辑
>调用BasePopView.show后可以保存BasePop.Builder，方便处理消失等逻辑;
比如，demo工程里面的案例
```Java
/**
* 弹窗显示测试
*
* @param view
*/
public void testPop(View view) {
///< 已经显示则重新来过
if (null != builder && builder.bIsShowing()) {
builder.dissmiss();///< 或者return，防止重复显示
}
///< 点击事件走起
OnEventListenner.OnBaseClickListenner onClickListenner = new OnEventListenner.OnBaseClickListenner() {
@Override
public void onClick(View view) {
if (view.getId() == R.id.ap_leftBtn ||
view.getId() == R.id.ap_rightBtn) {
builder.dissmiss();
}
}
};
switch (view.getId()) {
case R.id.am_lefttop_btn: ///< Achor右下角缩放显示
builder = BasePopView.show(this,
view, R.layout.activity_pop,
ScreenUtil.getScreenW(this) / 2, 500,
BasePopView.ANIMATION.SCALE, onClickListenner,
BasePopView.GRAVITY.LEFTTOP_TO_RIGHTBOTTOM);
break;
///....其他方式
}
}
```