XPopup 完整使用指南：Android 弹窗，3 行代码弹一个确认框

XPopup 完整使用指南Android 弹窗3 行代码弹一个确认框【免费下载链接】XPopupXPopup2.0版本重磅来袭2倍以上性能提升带来可观的动画性能优化和交互细节的提升功能强大交互优雅动画丝滑的通用弹窗可以替代DialogPopupWindowPopupMenuBottomSheetDrawerLayoutSpinner等组件自带十几种效果良好的动画 支持完全的UI和动画自定义(Powerful and Beautiful Popup for Androidcan absolutely replace DialogPopupWindowPopupMenuBottomSheetDrawerLayoutSpinner. With built-in animators , very easy to custom popup view.)项目地址: https://gitcode.com/GitHub_Trending/xpo/XPopupXPopup 是一个开源的 Android 弹窗组件库这篇教程从依赖集成讲起覆盖四个高频场景的弹法、自定义布局与动画。它能替代 Dialog、PopupWindow、PopupMenu、BottomSheet、DrawerLayout 等多个组件手势关闭、软键盘适配、生命周期释放都由库内置完成。做 Android 弹窗开发的你读完这篇 XPopup 使用教程可以直接少写一堆样板代码。 项目速览XPopup 是什么先说清楚它是谁、适合谁项目说明定位通用 Android 弹窗库一个库覆盖确认框、列表选择、依附菜单、抽屉、大图浏览等场景适合谁需要快速搭弹窗的 Android 开发或对 Dialog、PopupMenu 自定义能力不满的人兼容性minSdk 19编译版本 ≥ 29支持 androidx、RTL、横竖屏切换源码布局核心实现在library模块可直接运行的示例在app模块三个值得知道的卖点七类弹窗全覆盖Center、Bottom、Attach、Drawer、ImageViewer、FullScreen、Position统一由XPopup.Builder构建十几种内置动画缩放、平移、滚动等开箱即用也支持完全自定义动画器细节默认做好手势拖拽关闭、嵌套滚动、软键盘适配、生命周期释放不用你自己实现⚡ XPopup 快速集成依赖怎么加XPopup 走 jitpack 仓库在 build.gradle 里加仓库和依赖即可注意编译版本必须 ≥ 29allprojects { repositories { maven { url https://jitpack.io } } } dependencies { implementation com.github.li-xiaojun:XPopup:2.9.19 implementation androidx.appcompat:appcompat:1.3.1 implementation com.google.android.material:material:1.4.0 implementation androidx.recyclerview:recyclerview:1.2.1 }后三个 androidx 依赖是官方要求的必选项版本不低于上面即可。加完依赖最小可运行示例就是一句内联代码new XPopup.Builder(this).asConfirm(提示, 确定要删除吗, () - { }, null).show()标题内容换掉就能用。 按场景看能力我想实现 XX 效果README 按弹窗类型分类但实际开发时你只会想我要什么效果。下面按最常见的四个需求逐个过。3 行代码弹出确认框删除、退出前需要确认取消提示内置的asConfirm是最短路径new XPopup.Builder(this) .asConfirm(提示, 确定要删除这个项目吗, () - { /* 用户点了确定 */ }, null) // 第二个 null 表示取消回调 .show();标题、内容、回调就这三行核心。顺手的asLoading(加载中...)也是一句话的事。底部滑出列表选择分享面板、选择一项这类交互用asBottomList从屏幕底部弹出列表手势拖拽关闭已经内置new XPopup.Builder(this) .asBottomList(请选择, new String[]{选项1, 选项2, 选项3}, (position, text) - { // 拿到选中的位置和内容 }) .show();列表过长时内部自动处理滚动往下拖拽即可收起无需额外配置。菜单跟着手指走系统的 PopupMenu 不好定制XPopup 的 Attach 弹窗可以依附任意 View自动判断在上方还是下方显示还支持长按触发new XPopup.Builder(this) .atView(targetView) // 先指定依附的 View .hasShadowBg(false) // 去掉半透明遮罩 .asAttachList(new String[]{分享, 收藏, 删除}, null, (position, text) - { }) .show();atView会根据剩余空间自动选择弹出方向不需要你手动算坐标。侧边抽屉不用改布局DrawerLayout 要求你改造页面根布局XPopup 的抽屉弹窗则可以直接加在任意页面上和现有布局互不干涉new XPopup.Builder(this) .popupPosition(PopupPosition.Left) // 右侧就换成 Right .hasStatusBarShadow(true) // 给状态栏加一层阴影 .asCustom(new MyDrawerPopupView(this)) // 自己写的抽屉布局 .show();MyDrawerPopupView是你继承DrawerPopupView写的类只负责填布局拖拽、状态栏阴影、手势关闭都跟着类自带。 进阶定制Android 自定义弹窗怎么做内置弹窗不够用时自定义的路子很平分两条线自定义布局继承对应基类如CenterPopupView重写getImplLayoutId()返回你的布局再像写 Activity 一样在onCreate()里初始化控件。Demo 里的自定义弹窗目录 每个文件都能直接抄。自定义动画继承PopupAnimator重写animateShow()与animateDismiss()嫌麻烦就用popupAnimation(...)从十几种内置动画里挑一个。复用已有布局项目里弹窗 UI 已经画好时把布局 ID 传给asInputConfirm的最后一个参数等入口即可复用 XPopup 的交互与逻辑封装。✋ 体验细节手势、键盘与生命周期这三件是手写弹窗最费时的部分XPopup 默认就处理好了手势关闭底部弹窗上滑、中间弹窗下滑、抽屉跟着手指走不需要你写触摸监听。软键盘适配弹窗含输入框时autoOpenSoftInput(true)可自动聚焦并拉起键盘弹窗会自己移到键盘上方不想移动就设moveUpToKeyboard(false)。生命周期释放库会自动监听 Activity/Fragment 生命周期释放资源页面直接 finish 也不泄漏Builder 还支持customHostLifecycle(getLifecycle())绑定 Fragment弹窗本身实现了 LifecycleOwner可以直接被 LiveData 观察做到可见才更新数据。⚠️ 避坑指南XPopup 常见问题三个高频坑各一行解法弹窗不显示确认在主线程调用且容器 Activity 还活着在 Fragment 里使用时记得传生命周期。弹窗复用与销毁一次性弹窗加.isDestroyOnDismiss(true)Loading 这类反复显示的缓存返回的对象再调show()。混淆后弹窗异常release 构建需保留 widget 包混淆规则写一行-keep class com.lxj.xpopup.widget.**{*;}即可。写在最后一个库接管七类弹窗从 3 行确认框到全自定义。现在去加上依赖把第一个 XPopup 弹窗弹出来。【免费下载链接】XPopupXPopup2.0版本重磅来袭2倍以上性能提升带来可观的动画性能优化和交互细节的提升功能强大交互优雅动画丝滑的通用弹窗可以替代DialogPopupWindowPopupMenuBottomSheetDrawerLayoutSpinner等组件自带十几种效果良好的动画 支持完全的UI和动画自定义(Powerful and Beautiful Popup for Androidcan absolutely replace DialogPopupWindowPopupMenuBottomSheetDrawerLayoutSpinner. With built-in animators , very easy to custom popup view.)项目地址: https://gitcode.com/GitHub_Trending/xpo/XPopup创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考