PopupLayout 是通用弹出布局辅助库，允许开发者从顶部、底部、左侧、右侧和中心这五个位置弹出自己指定的 View，此外还提供圆角和动画特性。

效果预览

Gradle

//根项目下的 build.gradle
allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}

//主项目下的 build.gradle
dependencies {
    implementation 'com.github.CodingEnding:PopupLayout:v1.0'
}

Usage

基本使用

PopLayout 的使用非常简单，只需要执行以下两步：

1.初始化 PopupLayout

通过调用静态方法 init 初始化 PopupLayout。这个方法有两个参数：第一个参数是 Context 对象，第二个参数代表弹出布局的内容，可以将 layout 资源 Id 或者 View 对象作为参数传入，如下所示：

//1.使用 layout 资源 Id 作为弹出布局的内容
PopupLayout popupLayout=PopupLayout.init(MainActivity.this, R.layout.layout_left);

//2.使用 View 作为弹出布局的内容
View view=View.inflate(MainActivity.this,R.layout.layout_bottom_menu,null);
PopupLayout popupLayout=PopupLayout.init(MainActivity.this,view);

2.在指定位置显示弹出布局

PopupLayout 可以从屏幕顶部、底部、左侧、右侧和中心弹出（默认从底部弹出），如下所示：

//从左侧弹出
popupLayout.show(PopupLayout.POSITION_LEFT);
//默认从底部弹出
popupLayout.show();

position 的可选值：

• POSITION_LEFT
• POSITION_RIGHT
• POSITION_CENTER
• POSITION_TOP
• POSITION_BOTTOM

关闭弹出布局

点击弹出布局之外的区域，PopupLayout 会被自动关闭。当然，也可以通过调用 dismiss 或 hide 方法手动关闭。这两个方法的区别在于 hide 只是隐藏弹出布局，并不会释放资源；而 dismiss 会销毁弹出布局并释放资源。通常情况下，建议使用 dismiss 方法。

public void dismiss()
public void hide()

注意：在 Activity 退出时必须使用 dismiss 方法销毁弹出布局，释放资源。

限制弹出布局的大小

默认情况下，PopupLayout 会根据不同的弹出位置自动适配弹出布局的大小。具体而言，如果从顶部/底部弹出，宽度为 MATCH_PARENT，高度为 WRAP_CONTENT；如果从左侧/右侧弹出，宽度为 WRAP_CONTENT，高度为 MATCH_PARENT；如果从中心弹出，宽度为 WRAP_CONTENT，高度为 WRAP_CONTENT。

当然，PopupLayout 也提供了 setHeight 和 setWidth 两个方法用于手动设置弹出布局的大小。这两个方法原型如下：

/**
 * 设置弹出布局的高度
 * @param height 高度
 * @param dpMode 是否以 dp 为单位
 */
public void setHeight(int height,boolean dpMode)

/**
 * 设置弹出布局的宽度
 * @param width 宽度
 * @param dpMode 是否以 dp 为单位
 */
public void setWidth(int width,boolean dpMode)

注意：这两个方法必须要在调用 show 方法之前使用才有效。

相关方法

方法名	返回值	说明
static init(Context context,@LayoutRes int contentLayoutId)	PopupLayout	初始化弹出布局
static init(Context context,View contentView)	PopupLayout	初始化弹出布局
show(int position)	void	从指定位置显示弹出布局
show()	void	默认从底部显示弹出布局
dismiss()	void	隐藏弹出布局（同时会销毁弹出布局，释放资源），建议使用
hide()	void	隐藏弹出布局（不会销毁弹出布局），不会触发 DismissListener
setUseRadius(boolean useRadius)	void	是否使用圆角特性（默认使用）
setHeight(int height,boolean dpMode)	void	设置弹出布局的高度
setWidth(int width,boolean dpMode)	void	设置弹出布局的宽度
setDismissListener(DismissListener dismissListener)	void	设置 Dismiss 监听器（在弹出布局消失时触发）

监听器

PopupLayout 允许使用者监听弹出布局的消失事件，只需要为 PopupLayout 设置 DismissListener 即可，如下所示：

PopupLayout popupLayout=PopupLayout.init(MainActivity.this, R.layout.layout_bottom);
popupLayout.setDismissListener(new PopupLayout.DismissListener() {
    @Override
    public void onDismiss() {
        Toast.makeText(MainActivity.this,"弹出窗口关闭",Toast.LENGTH_SHORT).show();
    }
});//添加监听器

Blog

欢迎访问我的博客：

https://blog.csdn.net/codingending

License

Copyright CodingEnding

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.