51 lines
2.8 KiB
PHP
51 lines
2.8 KiB
PHP
|
<?php
|
|||
|
|
/**
|
|||
|
|
* 任务「完成」复选框（v24 第 25 批 用户第 6 条）—— 全站唯一画法。
|
|||
|
|
*
|
|||
|
|
* 用户原话：「任务相关的模块，所有的任务，前面都带一个复选框，在任何地方，
|
|||
|
|
* 点这个复选框，这个任务就完成了。」
|
|||
|
|
*
|
|||
|
|
* 所以它出现在**每一个**列出任务的地方：任务看板、首页「手头在做」、任务详情、
|
|||
|
|
* 子任务列表。抄四份必然走样（改一处忘三处），所以抽成这一个片段。
|
|||
|
|
*
|
|||
|
|
* 用法（在模板里先准备好变量再 include）：
|
|||
|
|
* $tkId 任务的 id（必填）
|
|||
|
|
* $tkStatus 当前状态（'todo' / 'doing' / 'done'）
|
|||
|
|
* $tkBack 改完之后回哪儿：'tasks'（默认）或 'show'（详情页里点的时候）
|
|||
|
|
* $tkLabel 可选，无障碍用的说明（默认「标记完成」）
|
|||
|
|
* $tkStatic 可选，true = 只读账号 → 渲染成**不可点**的静态方块（不是按钮）
|
|||
|
|
*
|
|||
|
|
* ⚠️ 三件必须做对的事：
|
|||
|
|
* ① **它是 button 不是 input[type=checkbox]** ——
|
|||
|
|
* 它要发一个带 CSRF 的表单（或者被 JS 接管），
|
|||
|
|
* `input` 的 `checked` 是浏览器自己管的，会被"点了没提交成功但看着已勾上"骗到。
|
|||
|
|
* 用 button + `aria-pressed` 表达状态，页面上的"勾没勾"始终由**服务端状态**说了算。
|
|||
|
|
* ② 表单**全页只渲染一份**（`#taskDoneForm`，见下面的说明）：几十张卡就是几十份 form，
|
|||
|
|
* 那是名册页被密码管理器拖垮的同一个坑（2369 个 form 的实测记录在 people/index.php）。
|
|||
|
|
* 所以卡片上只放 `data-tk-done="<id>"`，真正的表单在页面末尾。
|
|||
|
|
* ③ **不写 `checked` 属性、不写 `onsubmit`**：状态由服务端渲染的 class 决定，
|
|||
|
|
* 点击由 app.js 统一接管（有 JS → AJAX 就地改；无 JS → 表单提交回 302）。
|
|||
|
|
*/
|
|||
|
|
$tkId = (int)($tkId ?? 0);
|
|||
|
|
$tkStatus = (string)($tkStatus ?? 'todo');
|
|||
|
|
$tkBack = (string)($tkBack ?? 'tasks');
|
|||
|
|
$tkLabel = (string)($tkLabel ?? '标记完成');
|
|||
|
|
$tkStatic = !empty($tkStatic);
|
|||
|
|
$tkIsDone = $tkStatus === 'done';
|
|||
|
|
if ($tkId <= 0) {
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
?>
|
|||
|
|
<?php if ($tkStatic): ?>
|
|||
|
|
<span class="tk-check is-static<?= $tkIsDone ? ' is-done' : '' ?>"
|
|||
|
|
aria-hidden="true" title="<?= e(\App\Task::statusWord($tkStatus)) ?>"></span>
|
|||
|
|
<?php else: ?>
|
|||
|
|
<button type="button" class="tk-check<?= $tkIsDone ? ' is-done' : '' ?>"
|
|||
|
|
data-tk-done="<?= $tkId ?>"
|
|||
|
|
data-tk-status="<?= e($tkStatus) ?>"
|
|||
|
|
data-tk-back="<?= e($tkBack) ?>"
|
|||
|
|
aria-pressed="<?= $tkIsDone ? 'true' : 'false' ?>"
|
|||
|
|
title="<?= $tkIsDone ? '已完成（再点一下取消）' : '点一下标记完成' ?>">
|
|||
|
|
<span class="visually-hidden"><?= e($tkLabel) ?>：<?= e(\App\Task::statusWord($tkStatus)) ?></span>
|
|||
|
|
</button>
|
|||
|
|
<?php endif; ?>
|