如何使用Tailwind CSS阻止点击Modal外部时关闭弹窗

基于Tailwind CSS官网示例，使用Headless UI的Dialog组件实现了一个Modal弹窗，目前点击Modal外部时弹窗会自动关闭。尝试过pointer-events-none类以及设置backdrop为static的方法，但都没有效果。询问是否有Tailwind CSS的类可以解决该问题，相关React代码如下：

import { Fragment, useEffect, useRef, useState } from "react";
import { Dialog, Transition } from "@headlessui/react";
import { ExclamationTriangleIcon } from "@heroicons/react/24/outline";

export default function AuthModal() {
  const [open, setOpen] = useState(false);

  useEffect(() => {
    let authInformation = localStorage.getItem("authInformation");
    console.log(`authInformation: ${authInformation}`);
    if (authInformation) {
      setOpen(false);
    } else {
      setOpen(true);
    }
  }, []);

  const cancelButtonRef = useRef(null);

  return (
    <Transition.Root show={open} as={Fragment}>
      <Dialog
        as="div"
        className="relative z-10"
        initialFocus={cancelButtonRef}
        onClose={setOpen}
      >
        <Transition.Child
          as={Fragment}
          enter="ease-out duration-300"
          enterFrom="opacity-0"
          enterTo="opacity-100"
          leave="ease-in duration-200"
          leaveFrom="opacity-100"
          leaveTo="opacity-0"
        >
          <div className="fixed inset-0 bg-gray-500 bg-opacity-75 transition-opacity" />
        </Transition.Child>

        <div className="fixed inset-0 z-10 overflow-y-auto">
          <div className="flex min-h-full items-end justify-center p-4 text-center sm:items-center sm:p-0">
            <Transition.Child
              as={Fragment}
              enter="ease-out duration-300"
              enterFrom="opacity-0 translate-y-4 sm:translate-y-0 sm:scale-95"
              enterTo="opacity-100 translate-y-0 sm:scale-100"
              leave="ease-in duration-200"
              leaveFrom="opacity-100 translate-y-0 sm:scale-100"
              leaveTo="opacity-0 translate-y-4 sm:translate-y-0 sm:scale-95"
            >
              <Dialog.Panel className="relative transform overflow-hidden rounded-lg bg-white text-left shadow-xl transition-all sm:my-8 sm:w-full sm:max-w-lg">
                <div className="bg-white px-4 pt-5 pb-4 sm:p-6 sm:pb-4">
                  <div className="sm:flex sm:items-start">
                    <div className="mx-auto flex h-12 w-12 flex-shrink-0 items-center justify-center rounded-full bg-red-100 sm:mx-0 sm:h-10 sm:w-10">
                      <ExclamationTriangleIcon
                        className="h-6 w-6 text-red-600"
                        aria-hidden="true"
                      />
                    </div>
                    <div className="mt-3 text-center sm:mt-0 sm:ml-4 sm:text-left">
                      <Dialog.Title
                        as="h3"
                        className="text-lg font-medium leading-6 text-gray-900"
                      >
                        No user information!
                      </Dialog.Title>
                      <div className="mt-2">
                        <p className="text-sm text-gray-500">
                          Please Enter your UserID
                        </p>
                        <input
                          className="shadow appearance-none border rounded w-full py-2 px-3 mt-2 leading-tight focus:outline-none focus:shadow-outline"
                          id="userId"
                          type="text"
                          placeholder="UserId"
                        />
                      </div>
                    </div>
                  </div>
                </div>
                <div className="bg-gray-50 px-4 py-3 sm:flex sm:flex-row-reverse sm:px-6">
                  <button
                    type="button"
                    className="inline-flex w-full justify-center rounded-md border border-transparent bg-blue-600 px-4 py-2 text-base font-medium text-white shadow-sm hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2 sm:ml-3 sm:w-auto sm:text-sm"
                    onClick={() => setOpen(false)}
                  >
                    Deactivate
                  </button>
                  <button
                    type="button"
                    className="mt-3 inline-flex w-full justify-center rounded-md border border-gray-300 bg-white px-4 py-2 text-base font-medium text-gray-700 shadow-sm hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2 sm:mt-0 sm:ml-3 sm:w-auto sm:text-sm"
                    onClick={() => setOpen(true)}
                    ref={cancelButtonRef}
                  >
                    Cancel
                  </button>
                </div>
              </Dialog.Panel>
            </Transition.Child>
          </div>
        </div>
      </Dialog>
    </Transition.Root>
  );
}

这个问题无法直接通过Tailwind CSS类解决，因为点击外部关闭是Headless UI Dialog组件的默认行为，需要通过修改组件的回调逻辑来控制：

• 核心思路：利用Dialog组件onClose回调接收的reason参数，判断关闭触发的原因，仅在非外部点击时执行关闭操作。
• 具体修改：将Dialog的onClose={setOpen}替换为以下逻辑：

<Dialog
  as="div"
  className="relative z-10"
  initialFocus={cancelButtonRef}
  onClose={(reason) => {
    // 仅当触发原因不是外部点击时，才关闭弹窗
    if (reason !== 'backdropClick') {
      setOpen(false);
    }
  }}
>

补充说明 #

如果之前尝试pointer-events-none无效，大概率是加错了位置。正确的做法是给弹窗的背景层（即那个半透明的灰色div）添加该类，这样背景层不会响应点击事件，从而阻止外部关闭：

<div className="fixed inset-0 bg-gray-500 bg-opacity-75 transition-opacity pointer-events-none" />

但这种方法会同时禁用背景层的交互反馈，不如通过onClose的reason判断更灵活，推荐使用第一种方案。

内容的提问来源于stack exchange，提问作者writingdeveloper