超快！超简单！几行代码搞定安卓自定义对话框！带数据传入、传出

之前有做过一个列表适配器的简化，直接在代码中创建匿名类绑定数据到布局就可以，后面遇到项目中很多对话框，也想做个类似的简化，参考了一些博客，有了第一版的简化对话框，过了很久，今天又拿着改进了一下，这里记录一下吧！

超简单使用

这里直接通过静态方法 newInstance 创建对话框，传入布局 ID、参数、以及绑定数据到的回调接口就可以了，绑定数据用了一个通用的 ViewHolder（后面给出），如果需要监听结果，要设置 DismissListener，显示的时候要传入 FragmentManager。

String param = "input";
QuickDialogFragment.newInstance(android.R.layout.simple_list_item_1, param, (holder, dialog, input) -> {
            //绑定数据
            holder.setText(android.R.id.text1, input);
            //返回结果
            dialog.setResult("over");
}).setOnDismissListener(
        //显示结果
        result -> showToast((String) result)
).show(getSupportFragmentManager());

这里 QuickDialogFragment 用到了两个泛型变量，对应传入值和传出值，如果能推断出来就可以省略了，不行就在 newInstance 前面指定。

超级自定义

最终效果

自定义使用

对话框要自定义的话，一般就是圆角、底部对齐、动画、自定义宽高什么的，这里代码都做了支持，在后面链式追加就可以设置了，本来想写成 Builder 的，后面觉得这样也可以。Character 就是个数据类不给出了。圆角的使用需要设置背景透明才有用。

Character info = new Character("boy", 123,"小智", "12","真新镇");
QuickDialogFragment.newInstance(
        R.layout.item_data_dialog, info, (holder, dialog, character) -> {

    //绑定数据
    holder.setText(R.id.order, character.getOrder() + "");
    holder.setText(R.id.name, character.getName());
    holder.setText(R.id.old, character.getOld());
    holder.setText(R.id.sex, character.getSex());
    holder.setText(R.id.from, character.getFrom());

    // 设置点击事件，这里设置了点击变颜色功能
    // 数组起到不受 final 的限制作用（对象不变）
    final boolean[] flag = {false};
    holder.setOnClickListener(R.id.order, view -> {
        if (flag[0]) {
            holder.setTextColor(R.id.order, Color.GREEN);
            flag[0] = !flag[0];
        }else {
            holder.setTextColor(R.id.order, Color.BLUE);
            flag[0] = !flag[0];
        }
    });

    //返回结果
    dialog.setResult("over");

})
        //底部
        .setAlignBottom(true)
        //背景透明，配合圆角
        .setTransparent(true)
        //宽度指定 300dp，高度自适应
        .setSize(300, 0)
        //消失事件监听
        .setOnDismissListener(result -> showToast((String) result))
        //需要传入 FragmentManager 使之显示
        .show(getSupportFragmentManager());

下面是对应布局

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:background="@drawable/radius_dialog"
    android:paddingStart="5dp"
    android:paddingEnd="5dp"
    android:layout_height="wrap_content">

    <TextView
        android:id="@+id/order"
        android:textSize="18sp"
        android:gravity="center"
        android:textColor="#98A7B5"
        android:layout_width="match_parent"
        android:layout_height="40dp" />

    <View
        android:background="@color/grey"
        android:layout_width="match_parent"
        android:layout_height="1dp"/>

    <LinearLayout
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <TextView
            android:id="@+id/name"
            android:textSize="18sp"
            android:gravity="center"
            android:textColor="#98A7B5"
            android:layout_weight="1"
            android:layout_width="0dp"
            android:layout_height="match_parent" />

        <TextView
            android:id="@+id/old"
            android:textSize="18sp"
            android:gravity="center"
            android:textColor="#98A7B5"
            android:layout_weight="1"
            android:layout_width="0dp"
            android:layout_height="match_parent" />

    </LinearLayout>

    <View
        android:background="@color/grey"
        android:layout_width="match_parent"
        android:layout_height="1dp"/>

    <LinearLayout
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <TextView
            android:id="@+id/sex"
            android:textSize="18sp"
            android:gravity="center"
            android:textColor="#98A7B5"
            android:layout_weight="1"
            android:layout_width="0dp"
            android:layout_height="match_parent" />

        <TextView
            android:id="@+id/from"
            android:textSize="18sp"
            android:gravity="center"
            android:textColor="#98A7B5"
            android:layout_weight="1"
            android:layout_width="0dp"
            android:layout_height="match_parent" />

    </LinearLayout>

</LinearLayout>

圆角背景就是一个自定义的 shape

<?xml version="1.0" encoding="utf-8"?>
    <shape xmlns:android="http://schemas.android.com/apk/res/android"
        android:shape="rectangle">
        <!-- rectangle表示为矩形 -->

        <!-- 填充的颜色 -->
        <solid android:color="@color/colorWhite" />

        <!-- 边框的颜色和粗细 -->
        <stroke
            android:width="1dp"
            android:color="@color/grey"
            />
        <padding
            android:left="5dp"
            android:top="5dp"
            android:bottom="5dp"
            android:right="5dp"/>
        <!-- android:radius 圆角的半径 -->
        <corners
            android:radius="10dp"
            />

    </shape>

具体代码

import android.content.Context;
import android.content.DialogInterface;
import android.os.Bundle;
import android.util.DisplayMetrics;
import android.view.Gravity;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.view.Window;
import android.view.WindowManager;

import androidx.annotation.FloatRange;
import androidx.annotation.LayoutRes;
import androidx.annotation.Nullable;
import androidx.annotation.StyleRes;
import androidx.fragment.app.DialogFragment;
import androidx.fragment.app.FragmentManager;

/**
 * 超简单、快速的对话框使用
 * @author fdk
 * @date 2021/07/14
 */
@SuppressWarnings({"UnusedReturnValue", "unused"})
public class QuickDialogFragment<T, R> extends DialogFragment{

    /**
     * 布局ID
     */
    @LayoutRes
    private final int mLayoutResId;

    /**
     * 传入数据
     */
    private final T param;

    /**
     * 传出数据
     */
    private R result;

    /**
     * 是否背景透明
     */
    private boolean isTransparent = false;

    /**
     * 是否底部显示
     */
    private boolean isAlignBottom = false;

    /**
     * 点击返回键取消
     */
    private boolean isCancelable  = true;

    /**
     * 背景昏暗度
     */
    private float mDimAmount = 0.5f;

    /**
     * 左右边距
     */
    private int mMargin = 0;

    /**
     * 进入退出动画
     */
    private int mAnimStyle = 0;

    /**
     * 对话框的主题
     */
    private int mThemeStyle = 0;

    /**
     * 对话框宽度
     */
    private int mWidth;

    /**
     * 对话框高度
     */
    private int mHeight;

    /**
     * 核心接口，绑定对话框布局里的数据、点击效果等
     */
    private OnConvertViewListener<T,R> onConvertListener;

    /**
     * 对话框消失时回调，可以获取结果
     */
    private OnDismissListener<R> onDismissListener;

    /**
     *  构造函数，请勿直接使用，使用 newInstance，别忘了传入 OnConvertViewListener
     *
     * @param mLayoutResId 布局ID
     * @param param 输入数据
     */
    public QuickDialogFragment(@LayoutRes int mLayoutResId, T param) {
        this.mLayoutResId = mLayoutResId;
        this.param = param;
    }

    /**
     * 新建对话框方式，可继续调用相关设置参数函数，实现链式调用
     *
     * @param mLayoutResId 布局id
     * @param param 输入数据
     * @param convertViewListener 转换接口
     * @return 返回 dialog
     */
    public static <T,R> QuickDialogFragment<T,R> newInstance(
            @LayoutRes int mLayoutResId, T param, OnConvertViewListener<T,R> convertViewListener) {
        QuickDialogFragment<T,R> dialog = new QuickDialogFragment<>(mLayoutResId, param);
        return dialog.setOnConvertListener(convertViewListener);
    }

    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater,
                             @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        View view = inflater.inflate(mLayoutResId, container, false);
        onConvertListener.convertView(ViewHolder.create(view), this, param);
        return view;
    }

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

    /**
     * 初始化参数
     */
    private void initParams() {
        Window window = getDialog().getWindow();
        if (window != null) {
            WindowManager.LayoutParams params = window.getAttributes();
            params.dimAmount = mDimAmount;

            //设置dialog显示位置
            if (isAlignBottom) {
                params.gravity = Gravity.BOTTOM;
            }

            //设置dialog的主题
            if (mThemeStyle != 0) {
                setStyle(DialogFragment.STYLE_NO_TITLE, mThemeStyle);
            }


            if (null != getContext()) {

                //设置dialog宽度
                if (mWidth == 0) {
                    params.width = getScreenWidth(getContext()) - 2 * dp2px(getContext(), mMargin);
                } else {
                    params.width = dp2px(getContext(), mWidth);
                }

                //设置dialog高度
                if (mHeight == 0) {
                    params.height = WindowManager.LayoutParams.WRAP_CONTENT;
                } else {
                    params.height = dp2px(getContext(), mHeight);
                }

            }

            //设置dialog动画
            if (mAnimStyle != 0) {
                window.setWindowAnimations(mAnimStyle);
            }

            //设置背景透明
            if(isTransparent){
                window.setBackgroundDrawableResource(android.R.color.transparent);
            }

            window.setAttributes(params);
        }

        //设置是否可以取消
        setCancelable(isCancelable);
    }

    /**
     * 设置背景昏暗度
     *
     * @param dimAmount 设置背景昏暗度
     * @return dialog
     */
    public QuickDialogFragment<T,R> setDimAmount(@FloatRange(from = 0, to = 1) float dimAmount) {
        mDimAmount = dimAmount;
        return this;
    }

    /**
     * 是否显示底部
     *
     * @param alignBottom 是否显示底部
     * @return dialog
     */
    public QuickDialogFragment<T,R> setAlignBottom(boolean alignBottom) {
        isAlignBottom = alignBottom;
        return this;
    }

    /**
     * 是否透明
     *
     * @param transparent 是否透明
     * @return dialog
     */
    public QuickDialogFragment<T,R> setTransparent(boolean transparent) {
        this.isTransparent = transparent;
        return this;
    }

    /**
     * 设置宽高
     *
     * @param width 长度
     * @param height 高度
     * @return dialog
     */
    public QuickDialogFragment<T,R> setSize(int width, int height) {
        mWidth = width;
        mHeight = height;
        return this;
    }

    /**
     * 设置左右margin
     *
     * @param margin margin
     * @return dialog
     */
    public QuickDialogFragment<T,R> setMargin(int margin) {
        mMargin = margin;
        return this;
    }

    /**
     * 设置进入退出动画
     *
     * @param animStyle anim
     * @return dialog
     */
    public QuickDialogFragment<T,R> setAnimStyle(@StyleRes int animStyle) {
        mAnimStyle = animStyle;
        return this;
    }

    /**
     * 设置主题
     *
     * @param mThemeStyle style
     * @return dialog
     */
    public QuickDialogFragment<T,R>  setThemeStyle(@StyleRes int mThemeStyle) {
        this.mThemeStyle = mThemeStyle;
        return this;
    }

    /**
     * 设置是否点击外部取消
     *
     * @param outCancel 是否点击外部取消
     * @return dialog
     */
    public QuickDialogFragment<T,R> setOutCancel(boolean outCancel) {
        isCancelable = outCancel;
        return this;
    }

    /**
     * 设置传出数据
     *
     * @param result 导出数据
     */
    public void setResult(R result) {
        this.result = result;
    }

    /**
     * 显示dialog
     *
     * @param manager manager
     */
    public void show(FragmentManager manager) {
        super.show(manager, String.valueOf(System.currentTimeMillis()));
    }

    /**
     * 设置转换接口
     * @param onConvertListener 转换接口
     * @return dialog
     */
    private QuickDialogFragment<T,R> setOnConvertListener(
            OnConvertViewListener<T,R> onConvertListener) {
        this.onConvertListener = onConvertListener;
        return this;
    }

    /**
     * 设置对话框消失监听接口
     * @param listener 对话框消失监听接口
     * @return dialog
     */
    public QuickDialogFragment<T,R> setOnDismissListener(OnDismissListener<R> listener) {
        this.onDismissListener = listener;
        return this;
    }

    @Override
    public void onDismiss(DialogInterface dialog) {
        super.onDismiss(dialog);
        if(onDismissListener != null) {
            onDismissListener.onDialogDismiss(result);
        }
    }

    /**
     * 获取屏幕宽度
     *
     * @param context context
     * @return width
     */
    public static int getScreenWidth(Context context) {
        DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
        return displayMetrics.widthPixels;
    }

    /**
     * 将 dp 值转成 px 值
     *
     * @param context context
     * @param dipValue dp
     * @return px
     */
    public static int dp2px(Context context, float dipValue) {
        final float scale = context.getResources().getDisplayMetrics().density;
        return (int) (dipValue * scale + 0.5f);
    }


    /**
     * 转换接口
     */
    public interface OnConvertViewListener<T,R>{

        /**
         * 绑定数据到布局，设置布局点击事件等
         *
         * @param holder 通用的 ViewHolder
         * @param dialog 对话框
         * @param param 传入参数
         */
        void convertView(ViewHolder holder, QuickDialogFragment<T,R> dialog, T param);
    }

    /**
     * 消失接口
     */
    public interface OnDismissListener<R>{

        /**
         * 对话框消失
         *
         * @param result 对话框中传递的结果数据
         */
        void onDialogDismiss(R result);
    }
}

• 通用的 ViewHolder

import android.util.SparseArray;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
import android.widget.TextView;

import androidx.annotation.DrawableRes;
import androidx.annotation.IdRes;
import androidx.recyclerview.widget.RecyclerView;

/**
 * ViewHolder主要是做一些与控件布局有关的操作 ，所有我们可以在这边简化一下获取控件对象的代码
 */
public class ViewHolder extends RecyclerView.ViewHolder {

    private View mConvertView;
    private SparseArray<View> mViews;

    /**
     *
     * @param itemView
     * itemView
     */
    public ViewHolder(View itemView) {

        super(itemView);
        mViews = new SparseArray<>() ;
        mConvertView = itemView ;
    }

    /**
     *
     * @param view
     * view
     * @return
     * holder
     */
    public static ViewHolder create(View view) {
        return new ViewHolder(view);
    }

    /**
     * 根据资源获取View对象
     * @param res
     * 控件ID
     * @param <T>
     * 类型
     * @return
     * 控件
     */
    public <T extends View> T getView(@IdRes int res) {

        View view = mViews.get(res);
        if (view == null) {
            view = mConvertView.findViewById(res) ;
            mViews.put(res,view);
        }
        //noinspection unchecked
        return (T) view;
    }

    /**
     * 提供TextView和Button设置文本简化操作
     * @param idRes
     * 控件ID
     * @param charSequence
     * 字符串
     * @return
     * holder
     */
    public ViewHolder setText(@IdRes int idRes , CharSequence charSequence) {
        View view = getView(idRes);
        if (view instanceof TextView) {
            ((TextView)view).setText(charSequence);
        }else if (view instanceof Button) {
            ((Button)view).setText(charSequence);
        }

        return this ;
    }

    /**
     * 提供TextView和Button设置文本颜色简化操作
     * @param idRes
     * 控件ID
     * @param color
     * 颜色
     * @return
     * holder
     */
    public ViewHolder setTextColor(@IdRes int idRes , int color) {
        View view = getView(idRes);
        if (view instanceof TextView) {
            ((TextView)view).setTextColor(color);
        }else if (view instanceof Button) {
            ((Button)view).setTextColor(color);
        }
        return this ;
    }


    /**
     * 设置指定ViewId的背景颜色
     * @param idRes
     * 控件ID
     * @param color
     * 颜色
     * @return
     * holder
     */
    public ViewHolder setBackgroundColor(@IdRes int idRes , int color) {

        View view = getView(idRes);
        view.setBackgroundColor(color);

        return this;
    }


    /**
     * 设置指定ViewId的可见度
     * @param idRes
     * 控件ID
     * @param visibility
     * 可见度
     * @return
     * holder
     */
    public ViewHolder setVisibility(@IdRes int idRes , @DrawableRes int visibility) {

        View view = getView(idRes);
        view.setVisibility(visibility);

        return this ;
    }

    /**
     * 设置ImageView显示图片
     * @param idRes
     * 控件ID
     * @param res
     * 图片路径
     * @return
     * holder
     */
    public ViewHolder setImageResource(@IdRes int idRes , @DrawableRes int res) {
        View view = getView(idRes);
        if (view instanceof ImageView) {
            ((ImageView)view).setImageResource(res);
        }

        return this ;
    }

    /**
     * 设置指定控件ID的点击事件
     * @param idRes
     * 控件ID
     * @param listener
     * 监听接口
     * @return
     * holder
     */
    public ViewHolder setOnClickListener(@IdRes int idRes , View.OnClickListener listener) {

        View view = getView(idRes);
        view.setOnClickListener(listener);

        return this;
    }

    /**
     * 设置指定控件ID的长按事件
     * @param idRes
     * 控件ID
     * @param listener
     * 监听接口
     * @return
     * holder
     */
    public ViewHolder setOnLongClickListener(@IdRes int idRes , View.OnLongClickListener listener) {
        View view = getView(idRes);
        view.setOnLongClickListener(listener);

        return this;
    }

    /**
     * 设置指定控件的TAG
     * @param idRes
     * 控件ID
     * @param tag
     * tag
     * @return
     * holder
     */
    public ViewHolder setTag(@IdRes int idRes , Object tag) {
        View view = getView(idRes);
        view.setTag(tag);

        return this;
    }

    /**
     * 获取指定控件的TAG
     * @param idRes
     * 控件ID
     * @return
     * holder
     */
    public Object getTag(@IdRes int idRes) {
        View view = getView(idRes);
        return  view.getTag() ;
    }

}

小结

这里用的是 DialogFragment 来实现的对话框，没有直接给确定、取消等按钮（可以自己写几个按钮，最后设置结果，监听返回值就可以了），实际上使用起来就和 fragment 类似，适合用来快速自定义自己的对话框，如果读者觉得还可以的话，可以一键三连，点赞、评论、收藏啊！