# 图集预览 · 设计说明（image-preview.vue）

> 单元：`image-preview` ｜ group=community（公共辅助层，overlay） ｜ P03/P09 ｜ 依据：pages.json unit#17 + P03「双指放大」/P09「九宫格点击大图浏览」+ 执行方案 §5.17
> 实现：`vue/src/pages/image-preview.vue` ｜ 状态帧 fixtures：`design/fixtures/community.states.json`

## 1. 区块对照

| 区块 | 实现落点 |
|---|---|
| ① 全屏 swiper 大图 | 横向 scroll-snap 轨道；图源=itemDetail.gallery（normal）/9 张满（extreme）；**contain 收纳展示**，不整屏 cover 拉伸低分辨率示意素材 |
| ② 计数 i/N + 指示点 | 顶部居中「1/5」（随滚动实时更新）+ 底部胶囊指示点（可点跳页） |
| ③ 双指放大示意 | 点按图片切 CSS transform scale(1.8) 演示帧 + 底部提示行「双指缩放 · 点按图片演示」（真实端为双指手势） |
| ④ 关闭按钮 | 左上 44×44pt 圆钮→back()（E：物理返回=关闭，同键语义） |

## 2. 状态帧（board_parts=2）

| 帧 | 渲染 |
|---|---|
| normal | item 图集 5 张（末张=null→.ph「大图位 · 素材缺口示意」）；真实登记素材位带可见「示意素材」角标（2026-10-10 验收看查修复：原仅 alt 文本，可见层无标注） |
| loading | 大图加载占位骨架（.sk 块/图）；**黑底适配**（验收打回修复：浅粉骨架在暗场刺眼，页面作用域改深色渐变 #1B2430↔#273242，不改共享 base.css） |
| error | **单图失败+重试**：帧内自动定位第 2 张失败卡（计数 2/5、失败卡+重试钮在画面内；2026-10-10 验收看查修复：原停第 1 张导致失败卡无视觉证据），其余图正常可见——不整屏死黑 |
| extreme | 9 张满（6 个唯一登记素材+3 示意占位，同屏无重复素材——走查规避同图复用） |
| guest | N/A（pages.json na_reason：纯浏览层，无账户语义） |

## 3. 九维度

- **A**：加载/错误为单图层状态（不整屏失效）。
- **B**：滑动切页（scroll-snap）；点按=缩放演示；点按关层（关闭钮/返回键）。
- **C**：N/A——无表单（pages.json na 同口径）。
- **D**：计数 i/N 格式（1/5→9/9）。
- **E**：仅全屏层，物理返回=关闭（back 注入）；来自 item 图集/post 九宫格（pages.json links）。
- **F**：按 §0.5。
- **G**：大图懒加载（loading=lazy）+1:1 占位（.ph）。
- **H**：关闭按钮 44×44pt；黑底白字对比充足（#E8ECF1 on #0E1218）。
- **I**：图片列表来自 item.images / post.images（本稿=itemDetail.gallery / 极端池）。

## 4. 决策触点 → 字段/组件

| 决策点 | 落点 |
|---|---|
| 看图识货（收藏品交易核心） | 全屏大图 contain 收纳+计数+缩放演示 |

## 5. 素材纪律与缺口（如实声明）

- 页面级令牌覆写：`.preview { --text-strong:#FFF; --text:#E8ECF1 }`（黑底状态栏/图标切白，**不动共享 tokens.css**，页面作用域覆盖）；黑底骨架渐变同为页面作用域覆盖（不动共享 base.css）。
- 登记裁切素材均为低分辨率示意（manifest 全部禁 detail-gallery-main 生产位）→ 预览按 contain 收纳、**可见「示意素材」角标**（与 .ph 缺口位「示意图」角标口径对齐，.ph 位不重复加）；**2x/1080px 大图素材缺口已列 docs 素材缺口清单**，需主代理批准后另补。
- 末张 null→.ph「大图位 · 素材缺口示意」角标，不冒充实拍。
- **修不掉登记（2026-10-10 验收看查）**：device-393.png 底部被裁（提示行不可见、指示点贴底缘）——渲染输出为 750×1624（375×812@2x）画布而页面按 393×852 渲染，属 `scripts/render.py` 输出管线画布错配（全站 device-393 系列同类），本组无权改共享脚本，待底座修复后重拍复验。