v49:条目浮层的「详情/编辑/删除」按**来源**分形态(三颗靠右 + 就地展开/编辑 + AJAX 删除)

用户 2026-10-14 第 2 条。用户原话:
  「下面三个按钮,都放在下面的右侧…分别是详情、编辑和删除。详细用蓝色,编辑用黄色,删除用红色。
    点击详细的时候,**如果这是一个日程**(正常日程里的事件、不是来自观影/旅程等模块)
    → 就**在当前页面让模态框变大**、显示更多信息。
    点击编辑,也是**在当前的界面**弹出编辑日程的框,就地编辑;编辑完之后下面两个按钮:取消和保存。
    点击删除,就直接把这个日程给删除。
    如果当前这个日程**来自其他模块**(观影 / 旅程 / 其它)→ 点击详情就**进入那些模块**展示它。
    **这种情况下,下面就没有编辑、也没有删除,就只有一个详情。**」
拍板:① 应用范围 = 首页日程 + 日程页条目(首页近期任务保持 v43 现状);
      ② 重复日程删除 → 弹三档范围(这一次 / 这一次及以后 / 全部)。

实现(7 个文件):
 · app/helpers.php  fb_entry_json() 扩契约:source('event'/'derived') / ref / del / info /
   repeat / occ。判据 `kind==='custom' && ref_id>0`(**不是**"有没有 edit")。
 · app/Calendar.php  month() 给自定义条目带 _can_write(供 del 判定)。
 · templates/_entry_popup.php  底栏重构成「右侧按钮组 + 7 颗」:详情态三颗、
   编辑态两颗(取消/保存)、删除范围态两颗(取消/确认删除);另加一颗
   **遮罩层里的 CSRF**(正文会被整块换掉,放正文会丢)。
 · assets/js/entry_popup.js  四态状态机(detail/info/edit/delscope),按 source 决定显哪几颗。
 · assets/css/app.css  .fb-entry-acts(margin-left:auto 靠右)+ fb-a-detail/edit/del 三色
   + .is-wide(620→860px)。⚠️ 全是**作用域类**,不动全局 .btn-edit/.btn-danger 的语义。
 · index.php  新增 calendar/event?embed=detail(只吐只读详情块);
   calendar/event_del **认 X-Requested-With 回 JSON**($done() 收口,失败也回原因)。
 · templates/calendar/event.php  支持 $evDetail(只吐 kv 只读块,与可写与否无关)。

本轮修掉两个真 bug(都是"藏不掉"):
 ① `.btn{display:inline-flex}` 是作者样式,**盖过 [hidden] 的浏览器默认**
    ⇒ 底栏四态切换时前面的按钮收不起来、全挤在一条上(派生条目本该只有「详情」,
      实测三颗都露着)。⇒ 显式写 `.fb-entry-acts .btn[hidden]{display:none!important}`。
      本项目文件前部已有同款注释(.pick-row[hidden] 等),属第 N 次同类。
 ② `footShow('detail')` 把三颗无条件点亮,**盖掉** paintDetail 按来源设的 hidden。
    ⇒ detail 组只列「详情」,且 paintDetail 里**先 footShow 再设 edit/del**(顺序写进注释)。

验证(新增 2 个套件):
 · _fb_v49_entry.py(33 条真机断言:三颗靠右/配色/派生只有详情/详情就地变宽/编辑就地/
   删除落库/日程页入口/重复弹范围)
 · _b49_falsify.py(**10 注入 / 21 断言全抓**)
 · 更新 _fb_b43_ui.py 旧断言(「详细信息」→「详情」;自定义日程的详情语义从"跳页"改"就地展开")
 · familybook_deploy.sh 加 v49 静态断言段
 · 全量 e2e / vCard / 几何 / 各批反向验证全绿;部署脚本 0 FAIL(含"第49批形态");
   线上 7 个文件 md5 与本地逐字节一致;线上门禁诊断 13 项全 YES,临时页已删并复验 404

⚠️ 反向验证抓到一条**假绿**(值得记下来):注入「给派生条目也塞 del」时探针**没变红** ——
   因为按钮显隐是 `source` **且** `del` 的多条件"与",只塞 del 在界面上显不出来。
   ⇒ 补一条**数据层**断言(直接读 data-fb-entry 的 del 必须为空),两层判据都在。

⚠️ 末段唯一"失败"是沙箱的安全删除门禁(SAFE_DELETE_BULK_CONFIRM_REQUIRED,按轮次累计、
   本轮流水线删超 50 个文件):单独重跑 _fb_v46_carddav.py 是 **29/0**,与环境有关,与本次改动无关。
This commit is contained in:
2026-10-14 19:05:13 +08:00
parent 6ee5662854
commit 1bf56b114b
7 changed files with 437 additions and 105 deletions
+43 -23
View File
@@ -1,31 +1,43 @@
<?php
/**
* 🔴 v43(用户 2026-10-11 第 6 条)——「条目详情浮层」的**空壳**。
* 条目详情浮层 —— **空壳**(全站一份,挂在 layout.php)。
*
* 用户原话:
* 「首页上的日程、首页上的近期任务,以及日程里面的日程,点击它们的时候,
* 都会弹出一个框显示更详细的信息。上面有不同的功能按钮,比如说详细信息,
* 在日程里面,如果是观影啊、旅程啊,点击详细信息就会进入到观影或者旅程的
* 那个相关的页面。如果是日程的话,点击详细信息就进到日程的详细页面。
* 当然还可以直接点击编辑,点击编辑不同的来源就进入不同的编辑页面,
* 就在当前的页面弹窗,把之前的窗给去掉,然后弹出编辑的那个框来就可以了。」
* 起源 v43(用户 2026-10-11 第 6 条):「首页上的日程、首页上的近期任务,以及日程里面的
* 日程,点击它们的时候,都会弹出一个框显示更详细的信息。上面有不同的功能按钮…」
*
* ⇒ 三处入口(首页日程 / 首页近期任务 / 日程页条目)都挂同一个浮层,
* 内容由 `assets/js/entry_popup.js` 按点击项的 `data-fb-entry` 现填。
* 🔴🔴 v49(用户 2026-10-14)——**底栏按「来源」分两种形态**,用户原话:
* 「在首页上点击某一个日程…下面三个按钮,都放在下面的右侧…三个按钮分别是详情、编辑和删除。
* 详细用蓝色,编辑用黄色,删除用红色。
* 当点击详细的时候,**如果这是一个日程**(正常的日程里的事件、不是来自观影/旅程等其他模块)
* → 就**在当前页面让模态框变大**、显示更多信息。
* 当点击编辑的时候,也是**在当前的界面**弹出编辑日程的框,就地编辑;
* 编辑了之后下面有两个按钮:**取消和保存**。
* 当点击删除的时候,就直接把这个日程给删除。
* 如果当前这个日程**来自其他模块**(观影 / 旅程 / 其它)→ 点击详情就**进入那些模块**展示它
* (观影→那一天的观影详情页;旅程→那个行程所在的旅程页)。
* **这种情况下,下面就没有编辑、也没有删除,就只有一个详情。**」
*
* 两种形态(由 JS 切):
* ① **详情态**:正文几行「标签:值」;底栏 = 详细信息(跳该来源详情页)+ 编辑
* ② **编辑态**:正文换成该来源的编辑表单;底栏 = 返回(回详情态)+ 保存
* (保存走**原生提交** —— 四个来源的 update 路由本来就收普通 POST 并跳转,
* 不依赖任何页面自带脚本,所以浮层在任何页面都能用)
* ⇒ 底栏的三态(由 JS 切,见 assets/js/entry_popup.js):
* ① **详情态**(点条目进来):`详情`(蓝) + `编辑`(黄,仅自定义日程且可写) + `删除`(红,同前)
* —— 三颗一律**靠右**(用户:"都放在下面的右侧")。
* 派生条目(观影/旅程/任务/纪念日/农历/节假日)只有 `详情` 一颗。
* ② **展开态**(点「详情」,仅自定义日程):面板变宽、正文换成服务端的完整详情。
* ③ **编辑态**:正文换成编辑表单;底栏 = `取消` + `保存`。
* 删除范围(重复日程)另有一种临时态,见 JS。
*
* ⚠️ 空壳放在 **layout.php** 里(全站一份):三处入口在不同页面,
* 放各页面迟早有一个忘了 include —— 那种"某些页面点了没反应"最难查。
* ⚠️ 面板里**不放任何服务端内容**:同一页一百条日程也只有一个浮层,开销可忽略。
* ⚠️ 面板里**不放任何服务端内容**(除了那颗 CSRF):同一页一百条日程也只有一个浮层,开销可忽略。
* ⚠️ 按钮的**显隐全部由 JS 按 `data-fb-entry` 的内容决定**,服务端只给数据:
* 空壳里全部 `hidden`,避免"先闪一下三颗、随即收起一颗"。
*/
?>
<div class="fb-entry-modal" id="fbEntryModal" role="dialog" aria-modal="true"
aria-label="条目详情" hidden>
<?php /* `_csrf` 放在遮罩层里(不放进正文)—— 删除是 AJAX POST,需要它;
而正文会被整块换掉(编辑态 = 服务端表单,里面自带 tokens),
放正文里会在换掉时丢。 */ ?>
<div class="fb-entry-csrf" hidden><?= csrf_field() ?></div>
<div class="cal-modal-panel fb-entry-panel" id="fbEntryPanel">
<div class="cal-modal-head">
<b id="fbEntryTitle">详情</b>
@@ -34,13 +46,21 @@
<div class="cal-modal-body" id="fbEntryBody"></div>
<div class="cal-modal-foot" id="fbEntryFoot">
<span class="cal-modal-tip" id="fbEntryTip"></span>
<?php /* 详情态的两颗 */ ?>
<a class="btn btn-ghost btn-sm" id="fbEntryDetail" href="#" hidden>详细信息</a>
<button class="btn btn-sm" type="button" id="fbEntryEdit" hidden>编辑</button>
<?php /* 编辑态的两颗(默认藏着)—— 「返回」不丢用户填的东西吗?
⚠️ 会丢。所以措辞用「返回」,并且在有改动时先问一句(见 JS)。 */ ?>
<button class="btn btn-ghost btn-sm" type="button" id="fbEntryBack" hidden>返回</button>
<button class="btn btn-sm" type="button" id="fbEntrySave" hidden>保存</button>
<?php /* 右侧按钮组(`margin-left:auto` 把整组推到右边)。
顺序:详情 / 编辑 / 删除 —— 用户点名的顺序。
⚠️ 三颗各自的作用域类(fb-a-detail/edit/del)给颜色,**不动全局 .btn-edit
/ .btn-danger** 的语义(本项目踩过"裸类改色波及别页"的坑,见 app.css)。 */ ?>
<div class="fb-entry-acts" id="fbEntryActs">
<a class="btn btn-sm fb-a-detail" id="fbEntryDetail" href="#" hidden>详情</a>
<button class="btn btn-sm fb-a-edit" type="button" id="fbEntryEdit" hidden>编辑</button>
<button class="btn btn-sm fb-a-del" type="button" id="fbEntryDelete" hidden>删除</button>
<?php /* 编辑态的两颗(默认藏着) */ ?>
<button class="btn btn-ghost btn-sm" type="button" id="fbEntryCancel" hidden>取消</button>
<button class="btn btn-sm" type="button" id="fbEntrySave" hidden>保存</button>
<?php /* 删除范围态(重复日程才有):取消 + 确认删除 */ ?>
<button class="btn btn-ghost btn-sm" type="button" id="fbEntryDelCancel" hidden>取消</button>
<button class="btn btn-sm fb-a-del" type="button" id="fbEntryDelGo" hidden>确认删除</button>
</div>
</div>
</div>
</div>