FamilyBook/templates/_attachments.php

<?php
/**
 * 附件缩略图墙（v24 用户第 3 条）
 *
 * 一处渲染、全站通用：旅程节点 / 资源 / 任务 / 日程的附件都长一样。
 *
 * 规则（用户原话）：
 *   · 图片、视频 → **缩略图**，点开在**本页**预览（不再新开标签页）
 *   · PDF → 浏览器里直接预览（自带阅读器）
 *   · Word / Excel / PPT / 其它 → 一个**和缩略图一样大**的图标，点了直接下载
 *     （浏览器渲染不了的东西，绝不装一个"点了没反应"的预览）
 *   · 预览框**右上角**恒有一个下载按钮
 *
 * 用法（先准备变量再 require）：
 *   $attRows     附件行（Attachment::list 的结果）
 *   $attCanEdit  是否显示删除按钮
 *   $attDelUrl   删除动作的路由名（如 'resources/attach_del'）
 *   $attHostId   删除时要回传的宿主 id（表单里的隐藏字段用 $attHostKey 指定键名）
 *   $attDelField 删除表单里「附件 id」的字段名（各路由不一致：有的叫 id、有的叫 attach_id）
 *   $attExtra    额外隐藏字段 [键 => 值]（如日程要连带传宿主 id 才能判权限）
 *
 * ⚠️ 无 JS 也能用：可预览的是 <a href=预览地址>，不可预览的是 <a href=下载地址>，
 *    脚本只是把"可预览"的那部分拦下来改成弹层。
 */

$attCanEdit  = !empty($attCanEdit);
$attRows     = $attRows ?? [];
$attDelField = $attDelField ?? 'id';
$attExtra    = $attExtra ?? [];
$attDelUrl   = $attDelUrl ?? '';
?>
<?php if ($attRows): ?>
  <div class="att-wall">
    <?php foreach ($attRows as $attRow): ?>
      <?php
      $attKind   = \App\Attachment::kind($attRow);
      $canPrev   = \App\Attachment::previewable($attRow);
      $attView   = media_url((string)$attRow['key']);
      $attDl     = media_url((string)$attRow['key'], ['dl' => 1]);
      $attNm     = (string)($attRow['name'] ?? '');
      $attSz     = \App\Attachment::sizeWord($attRow['size'] ?? 0);
      ?>
      <div class="att-cell">
        <?php if ($canPrev): ?>
          <a class="att-thumb att-kind-<?= e($attKind) ?>"
             href="<?= e($attView) ?>"
             data-prev="<?= e($attKind === 'pdf' ? 'pdf' : ($attKind === 'video' ? 'video' : 'image')) ?>"
             data-src="<?= e($attView) ?>"
             data-dl="<?= e($attDl) ?>"
             data-name="<?= e($attNm !== '' ? $attNm : \App\Attachment::kindWord($attKind)) ?>"
             data-size="<?= e($attSz) ?>"
             title="<?= e($attNm) ?>">
            <?php if ($attKind === 'image'): ?>
              <img src="<?= e($attView) ?>" alt="<?= e($attNm) ?>" loading="lazy">
            <?php elseif ($attKind === 'video'): ?>
              <?php /* #t=0.1 让浏览器把第 0.1 秒那一帧当封面显示出来 ——
                      没有它视频位就是一块黑板，看不出这是段什么视频。 */ ?>
              <video src="<?= e($attView) ?>#t=0.1" preload="metadata" muted playsinline></video>
              <span class="att-play" aria-hidden="true">▶</span>
            <?php else: ?>
              <span class="att-doc att-doc-pdf">PDF</span>
            <?php endif; ?>
          </a>
        <?php else: ?>
          <a class="att-thumb att-kind-<?= e($attKind) ?>" href="<?= e($attDl) ?>"
             title="<?= e($attNm) ?>（点击下载）">
            <span class="att-doc att-doc-<?= e($attKind) ?>"><?= e(\App\Attachment::kindWord($attKind)) ?></span>
          </a>
        <?php endif; ?>
        <div class="att-meta">
          <span class="att-fname" title="<?= e($attNm) ?>"><?= e($attNm !== '' ? $attNm : \App\Attachment::kindWord($attKind)) ?></span>
          <span class="att-fsize"><?= e($attSz) ?></span>
          <a class="link-quiet att-dl" href="<?= e($attDl) ?>">下载</a>
          <?php if ($attCanEdit && !empty($attDelUrl)): ?>
            <form method="post" action="<?= e(url($attDelUrl)) ?>" class="att-del">
              <?= csrf_field() ?>
              <input type="hidden" name="<?= e($attDelField) ?>" value="<?= (int)$attRow['id'] ?>">
              <?php foreach ($attExtra as $ek => $ev): ?>
                <input type="hidden" name="<?= e((string)$ek) ?>" value="<?= e((string)$ev) ?>">
              <?php endforeach; ?>
              <button class="btn btn-ghost btn-sm" type="submit"
                      onclick="return confirm('删掉这个附件？')">删除</button>
            </form>
          <?php endif; ?>
        </div>
      </div>
    <?php endforeach; ?>
    <?php /* ⚠️ 循环里用到的临时变量一律用完即清：宿主模板里很可能也有 $attRow / $attKind /
             $attView / $attDl / $attNm / $attSz（各模块页面都爱用这种短名），留着就是静默覆盖。 */ ?>
    <?php unset($attRow, $attKind, $canPrev, $attView, $attDl, $attNm, $attSz); ?>
  </div>
<?php endif; ?>