Android 通用 Dialog

最新推荐文章于 2025-07-15 10:11:57 发布
最新推荐文章于 2025-07-15 10:11:57 发布
阅读量725 收藏
点赞数 1
CC 4.0 BY-SA版权
分类专栏： Android 文章标签： Android 通用 Dialog 万能Dialog
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/zhishenluo/article/details/83186232

1. 概述

1.1 特点说明

  1. 代码简洁, 不需要其他资源文件, 使用方便, 可定制性高
  2. 基于 DialogFragment 实现, 避免 Activity 销毁了对话框还存在
  3. 基于 AppCompatDialogFragment 实现, 确保 Android 各版本样式兼容
  4. 支持设置圆角、横坚屏切换、显示动画、位置、大小等
  5. 支持横坚屏切换保存控件状态, 如 EditText 数据

1.2 注意事项

  • 默认使用 AppCompatDialogFragment, 必须添加 AppCompat 依赖并设置主题, 如果不想使用, 让 UniversalDialog 继承 DialogFragment 即可
// 1. 添加依赖 appcompat
dependencies {
    implementation 'com.android.support:appcompat-v7:28.0.0'
}

// 2. 使用 AppCompat 的主题
<resources>
    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
       ..........
    </style>
</resources>

2. 使用方式

2.1 MainActivity.java

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        Button button = new Button(this);
        button.setOnClickListener(this);
        button.setText("Hello");
        button.setLayoutParams(new ViewGroup.LayoutParams(200, 100));
        setContentView(button);
    }

    @Override
    public void onClick(View v) {

        UniversalDialog.Builder
                .setView(R.layout.dialog_layout)                        // 设置布局文件
                .setWidth(800)                                          // 设置宽
                .setHeight(500)                                         // 设置高
                .setGravity(Gravity.CENTER)                             // 设置位置
                .setRoundRadius(15)                                     // 设置圆角
                .setAnimation(android.R.style.Animation_Translucent)    // 设置动画
                .setDimAmount(0.5f)                                     // 设置背景透明度
                .setCancelable(false)                                   // 设置为强制对话框
                .setOnBindViewListener((dialog, holder) -> {            // 设置布局
                    holder.setOnClickListener(R.id.no_tv, (view) -> dialog.dismiss());
                    holder.setOnClickListener(R.id.yes_tv, (view) -> dialog.dismiss());
                })
                .setOnSaveStateListener((outState, holder, resume) -> { // 保存 View 状态

                    // 恢复数据
                    final String key = "password_et";
                    if (resume) {
                        String password = outState.getString(key);
                        holder.setText(R.id.password_et, password);
                        return;
                    }

                    // 保存数据
                    String password = holder.getView(R.id.password_et).toString().trim();
                    if (!TextUtils.isEmpty(password)) {
                        outState.putString(key, password);
                    }
                })
                .create()                                                // 创建对话框
                .show(getSupportFragmentManager(), "TAG");
    }
}

2.2 dialog_layout.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/holo_blue_dark"
    android:orientation="vertical"
    android:padding="15dp">

    <TextView
        android:id="@+id/title_tv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="提示" />

    <TextView
        android:id="@+id/message_tv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="请输入您的密码" />

    <EditText
        android:id="@+id/password_et"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="15dp"
        android:gravity="right|end"
        android:orientation="horizontal">

        <TextView
            android:id="@+id/no_tv"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="No" />

        <TextView
            android:id="@+id/yes_tv"
            android:layout_width="wrap_content"
            android:layout_marginLeft="20dp"
            android:layout_height="wrap_content"
            android:text="Yes" />
    </LinearLayout>

</LinearLayout>

2.3 UniversalDialog.java

package com.ken.dialog;

import android.content.Context;
import android.graphics.Color;
import android.graphics.drawable.GradientDrawable;
import android.os.Bundle;
import android.os.Parcel;
import android.os.Parcelable;
import android.support.annotation.LayoutRes;
import android.support.annotation.NonNull;
import android.support.annotation.Nullable;
import android.support.annotation.StyleRes;
import android.support.v4.app.DialogFragment;
import android.support.v7.app.AppCompatDialogFragment;
import android.view.Gravity;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.view.Window;
import android.view.WindowManager;


/**
 * 通用对话框
 * @author Ken Luo
 * @version 1.0
 */
public class UniversalDialog extends AppCompatDialogFragment {

    private DialogParams params;
    private ViewHolder viewHolder;
    private static final String SAVE_STATE_KEY = "params";

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        return setView(inflater, container, savedInstanceState);
    }

    @Override
    public void onStart() {
        super.onStart();
        setDialog();
    }

    @Override
    public void onSaveInstanceState(@NonNull Bundle outState) {
        super.onSaveInstanceState(outState);
        outState.putParcelable(SAVE_STATE_KEY, params);                     // 横坚屏切换时保存数据
        if (params.saveStateListener != null) {
            params.saveStateListener.onSaveInstanceState(outState, viewHolder, false);
        }
    }

    private void setParams(DialogParams params) {
        this.params = params;
    }

    private View setView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {

        // 恢复横坚屏切换时保存的对话框数据
        if (params == null && savedInstanceState != null) {
            params = savedInstanceState.getParcelable(SAVE_STATE_KEY);
        }

        if (params == null || params.layoutResId <= 0)
            return null;

        View view = inflater.inflate(params.layoutResId, container, false);
        viewHolder = new ViewHolder(getContext(), view);

        // 设置布局
        if (params.bindViewListener != null) {
            params.bindViewListener.onBindView(this, viewHolder);
        }

        // 恢复 View 状态, 如 EditText 的数据
        if (params.saveStateListener != null && savedInstanceState != null) {
            params.saveStateListener.onSaveInstanceState(savedInstanceState, viewHolder, true);
        }
        return view;
    }


    private void setDialog() {

        if (params == null || getContext() == null || getDialog() == null || getDialog().getWindow() == null)
            return;

        // 圆角背景
        Window window = getDialog().getWindow();
        GradientDrawable drawable = new GradientDrawable();
        drawable.setColor(Color.TRANSPARENT);
        drawable.setCornerRadius(params.roundRadius > 0 ? params.roundRadius : dp2px(getContext(), 5));
        drawable.setStroke(0, Color.TRANSPARENT);
        window.setBackgroundDrawable(drawable);

        // 背景变暗
        window.addFlags(WindowManager.LayoutParams.FLAG_DIM_BEHIND);
        window.setDimAmount(params.dimAmount);

        // 设置宽高和位置
        window.setLayout(params.width > 0 ? params.width : getScreenWidth(getContext()) / 4 * 3,
                         params.height > 0 ? params.height : WindowManager.LayoutParams.WRAP_CONTENT);
        window.setGravity(params.gravity);

        // 设置显示和退出动画
        if (params.animation > 0)
            window.setWindowAnimations(params.animation);

        // 是否为强制对话框
        this.setCancelable(params.cancelable);
    }

    private static int getScreenWidth(Context context) {
        return context.getResources().getDisplayMetrics().widthPixels;
    }

    private static int dp2px(Context context, int dps) {
        return Math.round(context.getResources().getDisplayMetrics().density * dps);
    }


    /**
     * 通用对话框构建器
     */
    public static class Builder {

        private final DialogParams P;

        private Builder(@LayoutRes  int layoutResId) {
            P = new DialogParams();
            P.layoutResId = layoutResId;
        }

        /**
         * 设置对话框布局
         * @param layoutResId : 布局文件
         * @return 对话框构建器
         */
        public static Builder setView(@LayoutRes  int layoutResId) {
            return new Builder(layoutResId);
        }

        /**
         * 设置对话框构宽度
         * @param width : 对话框宽度, 默认为屏幕宽度的 3/4
         * @return 对话框构建器
         */
        public Builder setWidth(int width) {
            P.width = width;
            return this;
        }

        /**
         * 设置对话框构高度
         * @param height 高度, 默认 WRAP_CONTENT
         * @return 对话框构建器
         */
        public Builder setHeight(int height) {
            P.height = height;
            return this;
        }

        /**
         * 设置对话框显示位置
         * @param gravity 显示位置, 默认 Gravity.CENTER
         * @return 对话框构建器
         */
        public Builder setGravity(int gravity) {
            P.gravity = gravity;
            return this;
        }

        /**
         * 设置对话框构圆角大小
         * @param roundRadius 圆角大小, 默认 5dip
         * @return 对话框构建器
         */
        public Builder setRoundRadius(int roundRadius) {
            P.roundRadius = roundRadius;
            return this;
        }

        /**
         * 设置显示和退出动画
         * @param resId 资源文件
         * @return 对话框构建器
         *
         * <pre>
         *     <style name="Animation.Translucent">
         *         <item name="windowEnterAnimation">@anim/translucent_enter</item>
         *         <item name="windowExitAnimation">@anim/translucent_exit</item>
         *     </style>
         *
         *      <!-- translucent_enter.xml -->
         *      <set xmlns:android="http://schemas.android.com/apk/res/android" android:interpolator="@interpolator/decelerate_quad">
         *          <translate android:fromXDelta="75%" android:toXDelta="0" android:duration="@android:integer/config_shortAnimTime"/>
         *          <alpha android:fromAlpha="0.0" android:toAlpha="1.0" android:duration="@android:integer/config_shortAnimTime"/>
         *      </set>
         *
         *      <!-- translucent_exit.xml -->
         *      <set xmlns:android="http://schemas.android.com/apk/res/android" android:interpolator="@interpolator/accelerate_quad">
         *          <translate android:fromXDelta="0%" android:toXDelta="75%" android:duration="@android:integer/config_shortAnimTime"/>
         *          <alpha android:fromAlpha="1.0" android:toAlpha="0" android:duration="@android:integer/config_shortAnimTime"/>
         *      </set>
         *
         * </pre>
         */
        public Builder setAnimation(@StyleRes int resId) {
            P.animation = resId;
            return this;
        }

        /**
         * 设置窗口透明度
         * @param dimAmount 范围 0~1.0, 0-完全透明, 1-全黑; 默认 0.5f
         * @return 对话框构建器
         */
        public Builder setDimAmount(float dimAmount) {
            P.dimAmount = dimAmount;
            return this;
        }

        /**
         * 设置是否为强制对话框
         * @param cancelable true 非强制, false 强制; 默认为非强制
         * @return 对话框构建器
         */
        public Builder setCancelable(boolean cancelable) {
            P.cancelable = cancelable;
            return this;
        }

        /**
         * 设置布局监听器
         * @param listener 对话框布局设置监听器
         * @return 对话框构建器
         */
        public Builder setOnBindViewListener(OnBindViewListener listener) {
            P.bindViewListener = listener;
            return this;
        }

        public Builder setOnSaveStateListener(OnSaveStateListener listener) {
            P.saveStateListener = listener;
            return this;
        }

        /**
         * 创建对话框
         * @return 创建好的对话框
         * @exception NullPointerException 如果布局文件 ID 小于等于 0
         */
        public DialogFragment create() {

            if (P.layoutResId <= 0)
                throw new NullPointerException("The dialog without layout!");

            final UniversalDialog dialog = new UniversalDialog();
            dialog.setParams(P);
            return dialog;
        }
    }


    private static class DialogParams implements Parcelable {

        private int layoutResId    = 0;
        private int width          = 0;
        private int height         = 0;
        private int gravity        = Gravity.CENTER;
        private int roundRadius    = 0;
        private int animation      = 0;
        private float dimAmount    = 0.5f;
        private boolean cancelable = true;
        private OnBindViewListener bindViewListener;
        private OnSaveStateListener saveStateListener;

        private DialogParams() {
        }

        DialogParams(Parcel in) {
            layoutResId = in.readInt();
            width = in.readInt();
            height = in.readInt();
            gravity = in.readInt();
            roundRadius = in.readInt();
            animation = in.readInt();
            dimAmount = in.readFloat();
            cancelable = in.readByte() != 0;
        }

        public static final Creator<DialogParams> CREATOR = new Creator<DialogParams>() {
            @Override
            public DialogParams createFromParcel(Parcel in) {
                return new DialogParams(in);
            }

            @Override
            public DialogParams[] newArray(int size) {
                return new DialogParams[size];
            }
        };

        @Override
        public int describeContents() {
            return 0;
        }

        @Override
        public void writeToParcel(Parcel dest, int flags) {
            dest.writeInt(layoutResId);
            dest.writeInt(width);
            dest.writeInt(height);
            dest.writeInt(gravity);
            dest.writeInt(roundRadius);
            dest.writeInt(animation);
            dest.writeFloat(dimAmount);
            dest.writeByte((byte) (cancelable ? 1 : 0));
        }
    }


    public interface OnBindViewListener {
        void onBindView(DialogFragment dialog, ViewHolder holder);
    }

    public interface OnSaveStateListener {
        /**
         * 控件状态保存回调函数
         * @param bundle 保存或恢复数据
         * @param holder ViewHolder
         * @param resume true 表示恢复数据, false 表示保存数据
         */
        void onSaveInstanceState(@NonNull Bundle bundle, ViewHolder holder, boolean resume);
    }
}
Android通用Dialog的封装
MuMuSir的博客
07-22 1568
日常开发中或多或少都会使用到Dialog，每次都需要自定义继承Dialog，写多了不胜其烦，今天我们对Dialog做个封装，可通过链式构建，以ViewDataBinding方式设置ContentView（之后会扩展支持通过View方式设置ContentView，类似的封装可看我的另外一篇文章Android通用PopupWindow的封装）。 先看使用示例： 这里的layout_sorting_filter是我们自定义View的xml文件，LayoutSortingFilterBinding是对应的View
通用Dialog
08-15
通用Dialog例子，Android通用对话框组件设计，稍微修改自己使用。
android通用的Dialog
u010067689的博客
06-25 484
android开发中一般需要设计到dialog的显示，而dialog的显示需求可能多种多样，我们可以把这种变化封装到一个基类中提供给其他人使用。
Android原生Dialog
最新发布
m0_73444363的博客
07-15 553
Android开发中Dialog有两种实现方式：1. 使用系统提供的AlertDialog.Builder方法快速创建，但样式老旧，功能有限；2. 自定义Dialog，通过XML布局设计UI，继承Dialog类实现逻辑控制，可完全定制样式和功能。前者适合简单场景，后者更灵活美观。文中详细演示了两种方式的代码实现步骤，包括AlertDialog的按钮设置和自定义Dialog的布局设计、样式定义等，并对比展示了两种Dialog的视觉效果差异。
Android 自定义通用Dialog
星枫的博客
02-14 348
public MyDialog(Context context, int width, int height, View layout) { super(context, R.style.DialogTheme); setContentView(layout); Window window = getWindow(); WindowManager.Layo...
Android通用Dialog基类
移动，移着动动
05-03 323
一个通用Android的Dialog基类 public abstract class BaseDialog extends AppCompatDialog { public BaseDialog(Context context) { this(context, R.style.XTDialogTheme); } public BaseDialog(Context context, int theme) { super(context, them
Android View 高级框架二 Builder模式打造通用对话框
带你装逼带你飞的专栏
11-04 760
1 前言在我们的日常开发中，对话框是一个常见的组件，例如下面的对话框，分别是三种不同类型的对话框 在Android开发中，对话框也和我们的TitleBar一样，有各种样式，而且它比TitleBar更加的复杂，因为对话框显示的位置还有底部显示，中心显示，顶部显示，以及动画等，因此。对于对话框，我们也可以封装以下。这里我们还是采用Builder模式来封装。封装思路：将UI实现及事件和我们对话框基本
android 通用dialog
04-24
### Android 中通用 Dialog 的实现与使用 在 Android 开发中，`Dialog` 是一种用于显示临时交互窗口的小型界面组件。通过创建自定义 `Dialog` 或扩展其功能，可以满足多种需求场景下的弹窗设计。 #### 使用内置的 ...
自定义Android通用Dialog提示框代码库实践
在Android开发过程中，自定义一套通用的Dialog提示框是一个常见的需求，它有助于提高开发效率和代码复用。本文档详细介绍了如何创建一个名为CommomDialog的自定义Dialog类，用于实现基础的对话框功能，并强调了使用...
封装一个通用Dialog，使用DialogFragment
07-12
在Android开发中，创建对话框（Dialog）是常见的任务，用于与用户进行交互。DialogFragment是自Android 3.0（API级别11）引入的一个组件，它将Dialog的功能与Fragment的优势结合在一起，使得对话框的管理和显示更加...
Android自定义Dialog实现通用圆角对话框
01-04
前言：圆角对话框在项目中用的越来越多，之前一篇文章有介绍过使用系统的AlertDialog+CardView（Android中使用CardView实现圆角对话框）实现了圆角对话框的样式，今天介绍自定义Dialog实现通用的圆角对话框。...
android dialog
08-03
NULL 博文链接：https://bn922.iteye.com/blog/2002530
通用的Dialog工具类
12-19
通用的Dialog工具类,可以实现PopupWindow的效果,完全适应任何自定义布局样式.
Android常用对话框大全——Dialog
热门推荐
上辈子作恶多端，这辈子写前端。
01-18 7万+
唉！最近一直忙碌着写项目以至于都没有空出点时间来总结近期的学习，记录学习到的东西…现在正好有时间了就该好好记录一下学习的过程了。今天就来谈谈开发中经常用的到的一个控件——Dialog,对话框一般我们就用来提示一些信息给用户，让用户自主选择，或者在一些操作不可逆的情况下我们提示用户是否继续操作，下面就让我们一起来学习吧。老司机发车啦…一：最简单的对话框 AlertDialog dialog = new
Android通用UI组件之Dialog
weixin_33896726的博客
07-30 189
背景 Dialog是Android开发中常用的UI组件，为了方便显示对话框，系统提供了AlertDialog，它提供了丰富的API，使用时只需要设置相应的属性即可。但通常情况下，不会直接使用AlertDialog, 因为APP的设计并不一定都遵循Material Design的设计标准，同时这种通用的UI组件的设计风格也会经常发生变化。所以通常情况下，都会对AlertDialog的样式进行自定义，...
Dialog再次理解了。
路在脚下
02-08 1423
前言 　　对话框对于应用也是必不可少的一个组件，在Android中也不例外，对话框对于一些提示重要信息，或者一些需要用户额外交互的一些内容很有帮 助。本篇博客就讲解一下Android下对话框的使用，在本篇博客中，将了解到对话框的一些常规属性的设置，以及各式的对话框的使用，并都会提供小 Demo来展示所有的效果。 Dialog 　　Dialog，对话框，一个对话框就是一个小窗口，并
Android自定义通用的Dialog
陆仁甲的博客
01-25 857
先来唠唠嗑 昨晚杭州迎来了2018年的第一场雪，还不错，回家之前看到雪了，去年都没看到。雪天路滑，大家注意安全，小心开车！ 今天来写一篇关于自定义Dialog的文章，我们在开发中Dialog也是避免不了的，所以封装一个通用的Dialog很有必要，可以避免类的重复，减少代码冗余，我会通过封装一个Java类，然后通过填充不同样式的布局，来达到实现不同的弹出框效果。好了，天也不早了，话不多说，开始今...
Android 通用Dialog的写法
qq_23531145的博客
12-14 1265
1、概述 相信大家在项目开发中都会用到一些提示框，如果用的地方多了系统的dialog无法满足需求，那我们就要自定义dialog了，怎样能够简单方便呢？不多说了直接上代码。 2、BaseDialog.javapublic class BaseDialog extends Dialog { private Context context; private int itemLayoutId;
android dialog封装,Android开发实践之通用Dialog封装
weixin_39729837的博客
05-27 419
通用Dialog封装Android开发实践之通用Dialog封装前言在日常android开发中，我们会碰到各式各样的Dialog，一般情况下，我们都会封装一个通用的Dialog“壳子”去装不同风格的View，以减少样板代码的书写，今天就来说一说如何封装这个“壳子”。自定义Dialog主题Android默认的Dialog主题样式会包括标题栏，背景颜色等，这些通常情况下我们都不需要，会影响Dialog...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值