v81：首页卡片「新增电影」「新建纪念日」弹框（不离开首页就把事办了）

用户 2026-10-22：「首页上的其他卡片也应该有这些基本功能。比如电影观影，它有一个"新增电影"的功能；如果是纪念日，就有一个"新增纪念日"。实际上，就是把原来模块里弹的那个框，现在拿到这边来。目的就是为了在首页上就能快速完成一定工作，而不用进到模块里面。」做法：复用模块页**同一份**表单，不另写。 - app/HomeCards.php：TYPES 每张卡多登记 add（按钮文案）/ add_modal（弹框容器 id）。 - templates/home.php：按登记表挂 data-fb-add-open="#<id>"（没登记的仍用 v78 的 data-tk-add-open，两种写法并存但各有唯一来源）；页尾 require 模块的表单模板。 - assets/js/add_modal.js（新）：通用开关，只认 [data-fb-add-modal] / data-fb-add-open / data-fb-add-close；幂等闸门；Esc 先让 antd 收面板；打开那一刻才 boot 日期控件（hidden 时尺寸为 0，antd 会定位到屏幕左上角）。 - templates/{movies,days}/form.php：只在首页内嵌时（$fbAddModalAttr）挂通用属性并输出 back=home，模块页行为一字不变。 - index.php：days/save 与 movies/create 加 back=home 白名单（取 POST 再比字面量，不把 POST 当跳转地址）。过程中修掉两个真问题： - 登记表第一版写 anAddCard，而 days/form.php 实际是 anNewCard ⇒ 按钮属性写对了、 DOM 也不报错，点下去毫无反应。已加「按钮指向的容器真的存在」判据与部署静态断言里的交叉校验（拿登记表 id 去 templates/ 里逐个找 id="..."）。 - 探针判「提交后回首页」原本读 pg.url，而 wait_for_load_state(networkidle) 在点击那一刻本就 idle 时立刻返回 ⇒ 读到提交前的地址，恒绿。改成拦那次 POST 的响应看 (状态码, Location)，拆成 ⑭a 提交真发生 / ⑭b 302 指向 home / ⑭c 浏览器停在 home。验证：正向探针 23/0 · 反向验证 14/0（七注入各自变红）· e2e 1572/0 · 几何 428/0。
2026-10-22 22:05:17 +08:00
parent b1d4502148
commit fd90e33d94
7 changed files with 288 additions and 13 deletions
@@ -56,6 +56,11 @@ $anModalOnly = !empty($anModalOnly);
 $anOpen      = !empty($anOpen);
 $anEmbed     = !empty($anEmbed);
 $anShell     = !isset($anShell) ? !$anEmbed : (bool)$anShell;
+/* 🔴 v81：首页内嵌时挂通用开关属性（`assets/js/add_modal.js`）。
+   ⚠️ **只在首页设**（`$fbAddModalAttr` 由 `templates/home.php` 传）：
+      纪念日列表页有一套自己的内联开关脚本（还要管"编辑后替换卡片"那套 AJAX），
+      再挂通用属性就是两套同时绑 —— 按需挂，模块页行为不变。 */
+$fbAdd = !empty($fbAddModalAttr);

 $backUrl = url('days');
 ?>
@@ -79,12 +84,15 @@ $backUrl = url('days');
        if (!$anModalOnly) {
            echo ' data-an-standalone="1" data-an-back="' . e($backUrl) . '"';
        }
+        if ($fbAdd) {
+            echo ' data-fb-add-modal';
+        }
    } ?>>
  <?php if ($anModal): ?>
    <div class="cal-modal-panel mv-panel">
      <div class="cal-modal-head">
        <b><?= $editing ? '编辑纪念日' : '新建纪念日' ?></b>
-        <button type="button" class="cal-modal-x" id="anNewX" aria-label="关闭">&#10005;</button>
+        <button type="button" class="cal-modal-x" id="anNewX" aria-label="关闭"<?= $fbAdd ? ' data-fb-add-close' : '' ?>>&#10005;</button>
      </div>
  <?php endif; ?>
 <?php endif; ?>
@@ -93,7 +101,9 @@ $backUrl = url('days');
  <?= csrf_field() ?>
  <?php if ($editing): ?><input type="hidden" name="id" value="<?= (int)$e0['id'] ?>"><?php endif; ?>
  <?php if ($anModal && !$editing): ?>
-    <input type="hidden" name="back" value="days">
+    <?php /* 🔴 v81：首页内嵌时提交完回**首页**（`back=home`，服务端白名单见
+           index.php 的 days/save）。模块页内嵌仍回列表页 `days` —— 原样不动。 */ ?>
+    <input type="hidden" name="back" value="<?= $fbAdd ? 'home' : 'days' ?>">
  <?php endif; ?>

  <div class="mv-form-inner">
@@ -204,7 +214,7 @@ $backUrl = url('days');
    <div class="cal-modal-foot">
      <span class="cal-modal-tip" id="anNewTip"></span>
      <button class="btn btn-sm" type="submit" form="anForm" id="anNewSubmit">确定</button>
-      <button class="btn btn-ghost btn-sm" type="button" id="anNewCancel">取消</button>
+      <button class="btn btn-ghost btn-sm" type="button" id="anNewCancel"<?= $fbAdd ? ' data-fb-add-close' : '' ?>>取消</button>
    </div>
  </div><?php /* /.cal-modal-panel */ ?>
  <?php elseif ($anEmbed): ?>
@@ -122,14 +122,29 @@
            <?php endif; ?>
            <?php /* 🔴 v78（用户 2026-10-22）：「在全部任务旁边，放一个新建任务的功能，
                   其实就是把任务中的新建和编辑功能，搬过来，用弹出框来处理。」
-                   ⇒ 卡片登记表里登记了 `add` 的（目前只有「近期任务」）就在
-                      「全部任务」**右边**再多一颗 —— 同一套 `.hd-more` 配色，
-                      所以它是任务模块的主题色，不会跟旁边那颗抢眼。
-                   ⚠️ 按钮本身只带 `data-tk-add-open`：开关逻辑在 `assets/js/task_add.js`，
-                      那张弹框的 HTML 在页面末尾（`tasks/_add_modal.php`）。 */ ?>
-            <?php if ((string)($hcDef['add'] ?? '') !== '' && \App\Auth::canWrite()): ?>
+                   ⇒ 卡片登记表里登记了 `add` 的，就在「更多」**右边**再多一颗 ——
+                      同一套 `.hd-more` 配色，所以它是那个模块的主题色，不会抢眼。
+
+                   🔴 v81（用户同日）：「首页上的其他卡片也应该有这些基本功能。
+                      比如电影观影，它有一个"新增电影"的功能；如果是纪念日，就有一个
+                      "新增纪念日"。实际上，就是把原来模块里弹的那个框，现在拿到这边来。」
+                   ⇒ 属性改成**通用**的 `data-fb-add-open="#<弹框容器 id>"`（v81 的
+                      `assets/js/add_modal.js` 认这个），弹框 id 由登记表 `add_modal` 给出。
+                   ⚠️ 任务的弹框仍由老脚本 `task_add.js` + `data-tk-add-open` 管
+                      （v78 已上线，不动它以免回归）；所以这里**按登记表决定挂哪个属性**，
+                      不是一刀切换掉 —— 两种写法并存但各自有唯一来源。 */ ?>
+            <?php
+            $hcAdd      = (string)($hcDef['add'] ?? '');
+            $hcAddModal = (string)($hcDef['add_modal'] ?? '');
+            ?>
+            <?php if ($hcAdd !== '' && \App\Auth::canWrite()): ?>
              <button type="button" class="btn btn-sm hd-more<?= $hcColor === '' ? ' btn-ghost' : '' ?>"
-                      data-tk-add-open<?= $hcColor !== '' ? ' style="--hd-c: ' . e($hcColor) . ';"' : '' ?>><?= e((string)$hcDef['add']) ?></button>
+                      <?php if ($hcAddModal !== ''): ?>
+                      data-fb-add-open="#<?= e($hcAddModal) ?>" aria-haspopup="dialog" aria-expanded="false"
+                      <?php else: ?>
+                      data-tk-add-open
+                      <?php endif; ?>
+                      <?= $hcColor !== '' ? ' style="--hd-c: ' . e($hcColor) . ';"' : '' ?>><?= e($hcAdd) ?></button>
            <?php endif; ?>
          </div>
          <?php require $hcTpl; ?>
@@ -230,3 +245,49 @@
  unset($tkAddBack, $tkAddBoards, $tkAddCats, $tkAddPeople, $tkAdd);
  ?>
 <?php endif; ?>
+
+<?php /* ==================== 「新增电影」「新建纪念日」弹框（v81 用户 2026-10-22）============
+   用户原话：「首页上的其他卡片也应该有这些基本功能。比如电影观影，它有一个"新增电影"
+   的功能；如果是纪念日，就有一个"新增纪念日"。实际上，就是把原来模块里弹的那个框，
+   现在拿到这边来。目的就是为了在首页上就能快速完成一定工作，而不用进到模块里面。」
+
+   ⚠️ 与模块页**共用同一份模板**（`movies/form.php` / `days/form.php`），不另写表单：
+      字段、校验、服务端契约、附件上传全部同一套，永远不会不同步。
+   ⚠️ 三件事必须一起给，否则这张弹框"长出来了但用不了"：
+      ① `$fbAddModalAttr = true` —— 让模板挂 `data-fb-add-modal`（通用开关认它）；
+      ② 模板需要的**数据**（名册 / 影院 / 分类）由路由按"卡片在不在"准备，见 index.php；
+      ③ 表单里的 `back=home`（模板按 `$fbAddModalAttr` 自动输出）—— 提交完回首页。
+   ⚠️ 只在对应卡片**真的摆在首页**且账号可写时才渲染：卡片被关掉就没有入口，
+      不该白跑 People::roster / Cinema::all 这些查询。 */ ?>
+<?php if (!empty($homeAddModals) && \App\Auth::canWrite()): ?>
+  <?php foreach ((array)$homeAddModals as $hcAddKey => $hcAddData): ?>
+    <?php
+    $fbAddModalAttr = true;                 // 通用开关属性（见上面第 ① 条）
+    /* 每个片段自己兜底变量：模板片段不许偷宿主的变量（本项目重复踩过的坑）。 */
+    $m = null; $errors = [];
+    if ($hcAddKey === 'movies') {
+        $people  = (array)($hcAddData['people'] ?? []);
+        $cinemas = (array)($hcAddData['cinemas'] ?? []);
+        $mvModalOnly = true;                // 不输出 page-head / 设置菜单
+        $mvModalForce = true;               // 强制弹框壳（新增态本来就是，写明更稳）
+        $mvOpen = false;                    // 初始关闭，点卡片按钮才开
+        require __DIR__ . '/movies/form.php';
+        unset($mvModalOnly, $mvModalForce, $mvOpen, $people, $cinemas, $m, $errors);
+    } elseif ($hcAddKey === 'days') {
+        $anModalOnly = true; $anOpen = false; $anModal = true;
+        $anEmbed = false; $anShell = true;
+        /* ⚠️ 这三个必须逐个显式给：`days/form.php` 自己会 `$kindsFull ?? 查库` 兜底，
+           但**兜底会多跑一次查询**，而且与模块页那份不一定同源。
+           这里直接给它容器已经查好的那份（路由里按"卡片在不在"准备）。 */
+        $editing    = null;
+        $people     = (array)($hcAddData['people'] ?? []);
+        $kindsFull  = (array)($hcAddData['kindsFull'] ?? []);
+        $kinds      = array_column($kindsFull, 'name');
+        require __DIR__ . '/days/form.php';
+        unset($anModalOnly, $anOpen, $anModal, $anEmbed, $anShell,
+              $editing, $people, $kindsFull, $kinds);
+    }
+    unset($fbAddModalAttr);
+    ?>
+  <?php endforeach; ?>
+<?php endif; ?>
@@ -258,6 +258,13 @@ require __DIR__ . '/_entry_popup.php'; ?>
 <?php /* 🔴 v78：「新建任务」弹框的开关。任务页与首页共用同一张弹框，
   所以开关也只有一份 —— 两处各写一段，必然有一处忘了打开时 boot 日期控件。 */ ?>
 <script src="<?= e(asset('/assets/js/task_add.js')) ?>" defer></script>
+<?php /* 🔴 v81（用户 2026-10-22）：「首页上的其他卡片也应该有这些基本功能……把原来模块里
+   弹的那个框，现在拿到这边来。」⇒ 观影、纪念日的新建弹框也搬上首页。
+   三张弹框的开关逻辑一模一样（点遮罩关 / 点面板不关 / Esc 先让 antd 收面板 /
+   打开那一刻才 boot 日期控件），所以抽成**一份通用的**，各自只声明容器 id。
+   ⚠️ 与上面 `task_add.js` 并存不冲突：那一份仍管 `#taskAddCard`（v78 已上线），
+      这一份只认 `[data-fb-add-modal]`，两者选择器不相交。 */ ?>
+<script src="<?= e(asset('/assets/js/add_modal.js')) ?>" defer></script>
 <?php /* 🔴 v32 第 3 条：浏览器通知（站内消息 + 日程到期提醒）。
   ⚠️ **只在已登录时加载** —— 登录页轮询会一直 302 去登录页，白跑。
      同理也不在"免登录的导航展示页"上跑（那页没有会话）。
@@ -91,8 +91,14 @@ $mvModalOnly  = !empty($mvModalOnly);
 $mvModalForce = !empty($mvModalForce);
 $mvModal = $mvModalForce || !$isEdit;
 $mvOpen  = isset($mvOpen) ? !empty($mvOpen) : ($mvModal && !$mvModalOnly);
+/* 🔴 v81：首页内嵌时挂通用开关属性（`assets/js/add_modal.js`）。
+   ⚠️ **只在首页设**（`$fbAddModalAttr` 由 `templates/home.php` 传）：
+      模块页（观影列表页）自己有内联开关脚本，再挂通用属性会变成两套一起绑，
+      Esc / 点遮罩各关一次 —— 当前虽无害，但那是"两份实现同时生效"，迟早出事。
+      所以这里按需挂，模块页行为一个字不变。 */
+$fbAdd = !empty($fbAddModalAttr);
 ?>
-<div class="<?= $mvModal ? 'cal-modal' : 'mv-form-wrap' ?>"<?= $mvModal ? ' id="mvAddCard" role="dialog" aria-modal="true" aria-label="' . ($isEdit ? '编辑观影记录' : '记一场电影') . '"' . ($mvOpen ? '' : ' hidden') : '' ?>>
+<div class="<?= $mvModal ? 'cal-modal' : 'mv-form-wrap' ?>"<?= $mvModal ? ' id="mvAddCard" role="dialog" aria-modal="true" aria-label="' . ($isEdit ? '编辑观影记录' : '记一场电影') . '"' . ($mvOpen ? '' : ' hidden') . ($fbAdd ? ' data-fb-add-modal' : '') : '' ?>>
  <?php if ($mvModal): ?>
    <?php /* 🔴 v40：弹框的标题 / 主按钮文案**随用途变** —— 详情页点「编辑」时进来的是
           同一份模板，标题得写「编辑观影记录」、按钮写「保存」，不能还叫"记下这场电影"。
@@ -101,7 +107,7 @@ $mvOpen  = isset($mvOpen) ? !empty($mvOpen) : ($mvModal && !$mvModalOnly);
    <div class="cal-modal-panel mv-panel">
      <div class="cal-modal-head">
        <b><?= $isEdit ? '编辑观影记录' : '记一场电影' ?></b>
-        <button type="button" class="cal-modal-x" id="mvAddX" aria-label="关闭">✕</button>
+        <button type="button" class="cal-modal-x" id="mvAddX" aria-label="关闭"<?= $fbAdd ? ' data-fb-add-close' : '' ?>>✕</button>
      </div>
  <?php endif; ?>
 <form method="post" enctype="multipart/form-data"
@@ -111,6 +117,14 @@ $mvOpen  = isset($mvOpen) ? !empty($mvOpen) : ($mvModal && !$mvModalOnly);
  <?php if ($isEdit): ?>
    <input type="hidden" name="id" value="<?= (int)$m['id'] ?>">
  <?php endif; ?>
+  <?php /* 🔴 v81：首页内嵌时提交完回**首页**（不是跳去观影列表/详情 ——
+       用户要的是"不离开首页就把事办了"，跳走就等于把他从首页赶出去）。
+       取值走服务端白名单（见 index.php 的 movies/create 分支），
+       **不把 POST 的字符串直接当跳转地址**（开放重定向）。
+       ⚠️ 只在新建时给（编辑没有"回首页"的语义）。 */ ?>
+  <?php if (!$isEdit && $fbAdd): ?>
+    <input type="hidden" name="back" value="home">
+  <?php endif; ?>
  <?php /* ⚠️ 弹框模式下"主要动作在右下角"（与日程 / 任务弹框一致）：
          body 滚、foot 固定。编辑态仍是页面上的普通卡片。 */ ?>
  <?php if ($mvModal): ?><div class="cal-modal-body"><?php endif; ?>
@@ -394,7 +408,7 @@ $mDelForms  = [];   // 收集起来，在表单**外面**统一渲染
      <div class="cal-modal-foot">
        <span class="cal-modal-tip" id="mvAddTip"></span>
        <button class="btn btn-sm" type="submit" form="mvForm" id="mvAddSubmit">确定</button>
-        <button class="btn btn-ghost btn-sm" type="button" id="mvAddCancel">取消</button>
+        <button class="btn btn-ghost btn-sm" type="button" id="mvAddCancel"<?= $fbAdd ? ' data-fb-add-close' : '' ?>>取消</button>
      </div>
    </div><?php /* /.cal-modal-panel（仅弹框形态） */ ?>
    <?php else: ?>