fix(footer): 联系我们图标与首行文字同中线 #63

Open
zhangxiang wants to merge 6 commits from fix/footer-contact-align into dev
pull from: fix/footer-contact-align
Owner

变更摘要

页脚「联系我们」两行的 MapPin / Mail 图标与右侧文字不在同一水平中线(用户 2026-10-26 截图:图标偏高约 3px)。

根因:旧写法 flex items-start + 图标固定 mt-0.5 手拍偏移,而本项目把 leading-relaxed 重映射成
--line-height-relaxed: 1.85(globals.css:236,不是 Tailwind 默认 1.625),根字号又有 16 / 17 / 18 三档
(globals.css:542-558)。行盒高 = 25.9 / 27.52 / 29.14px,图标中心固定落在 0.125rem + 半图标
⇒ 地址行偏高 3.319 / 3.134 / 2.950px,邮箱行偏高 3.313 / 3.133 / 2.945px(root 18/17/16)。

改法(src/components/layout/footer.tsx,唯一产品代码改动):让偏移成为结构而不是数字 ——
地址行图标包进「高 = 行盒高(--line-height-relaxed × --font-size-sm)」的 items-center 单元格,
换行后仍对齐首行;邮箱是单行链接,整行 items-center。行高 / 字号 / 页高零变化,只移动两个图标。

配套:

  • 新增 e2e/footer-contact-align.spec.ts:三档视口(1440/834/390)× 2 行,盒子判据,四引擎通过。
  • 视觉基线重采 90 张(75 全页 + 5 页脚 + 10 首页主题),逐张机器核验「尺寸不变 + 差异团块只落在
    两个图标盒内」;5 张 footer 基线逐张读图。
  • 证据目录 docs/acceptance/2026-10-26-footer-icon-align/(含复跑脚本、三轮视觉读数、lessons §5.53 草稿)。

关联 Issue

关闭:N/A(无关联 Issue;来源:用户 2026-10-26 截图反馈「图标和文字不在一条水平线上」)

全链路检查

  • npm run type-check 通过(0 error,EXIT=0)
  • npm run lint 通过:EXIT=0,0 error / 84 warning;本批两文件单跑 npx eslint 亦 0 条(未新增告警)
  • 路由/链接真实:N/A——未新增或改动任何 href / Link 目标
  • 涉及 CMS 内容模型:N/A——未触及 content-types / seed,无需重跑 npm run db:seed
  • 涉及视觉/交互改动:已在新起的 npx next dev -p 3001 上用浏览器复核(端口 3000 被本机
    auth-center 容器占用,未把旧服务当现状)
  • 暗黑模式:沿用既有 text-dark-text-muted 语义 token,未新增裸色值
  • 动效合规:N/A——未改动任何动效
  • 品牌红 #C41E3A:N/A——未改品牌红触达点与面积
  • 数字与宣称口径:N/A——未改文案与结果型数字
  • 无遗留 console.log / TODO / FIXME / .only()

测试分层检查(L0–L3)

  • L0 单元:N/A——未新增工具函数 / Hook / CMS 渲染器;footer.test.tsx 28 例通过
  • L1 组件:footer.test.tsx 28 例通过(含两行渲染、图标存在、联系方式文案断言)
  • L2 E2E:npm run test:e2e:fast → EXIT=0,59 passed / 25 skipped(dev 下 16 个 @critical GA4
    用例与其它 dev 专属用例按设计 skip);新增几何守卫在 chromium / chromium-mobile / firefox / webkit
    四引擎 12 passed
  • L3 视觉回归:npm run test:visual:all -- --update-snapshots=none(PR 口径 = HEAD 的 15 路由清单)
    → 125 passed / 0 failed;重采 90 张后逐张机器核验(verify-baseline-diff.py,含 A/B 负对照)
  • 新增机械守卫带正控制:守卫先在未修复树上跑红(实测 -3.319 / -3.134 / -2.950px),修复后转绿;
    基线核验脚本的负对照 A(整幅下移 10px)与 B(非图标区横移 2px)均判红、正对照通过
    → SELFTEST PASS
  • 已运行相关测试并全绿,无 .only() / 跳过态残留

质量门禁

  • npm run test:unit 全部通过(151 suites / 1830 tests,EXIT=0)
  • npm run test:coverage 通过 config/test/jest.config.js 的 coverageThreshold(global 实测
    stmts 89.6 / branch 88.25 / funcs 88.28 / lines 89.6,EXIT=0,未下调阈值)
  • npm run test(Playwright E2E)全部通过:N/A——本轮跑的是 test:visual:all(125/125)与
    test:e2e:fast(59 passed / 25 skipped);全量功能 E2E 未跑,列入「其他说明·未验证项」
  • npm run check:contrast 与 npm run check:headings 通过:npm run check:a11y EXIT=0,
    34 页 0 问题,brand-token 检查通过
  • npm run lighthouse:N/A——未改性能路径、未新增资源/JS;需新起生产产物才能出数,本轮未跑
  • npm run test:security:headers:N/A——未涉响应头 / CSP / 部署配置
  • 文档已同步:新增 docs/acceptance/2026-10-26-footer-icon-align/(结论、读数、复跑命令、
    lessons §5.53 草稿);README/CONTEXT/CLAUDE/DESIGN/PRODUCT 不受影响(无新命令/术语/架构)
  • 提交信息符合 Conventional Commits;按「代码+守卫+证据 → 各 project 基线」拆成 6 个可独立评审的切片
  • 破坏性/共享状态动作:无(视觉基线重采已取得用户授权;未部署、未改 DB、未 force push)

假绿灯纪律

  • 门禁命令实际执行过并在此粘贴真实输出(含一次红:首轮 e2e:fast 的 cms 401,见「其他说明」)
  • 未通过删测试、放宽断言、skip/todo、下调阈值等方式让门禁变绿;视觉阈值 maxDiffPixels: 200
    与 threshold: 0.3 均未改
  • 未把误报当问题「修掉」:首轮 e2e:fast 的唯一红是本手工作业覆盖了 CMS_REVALIDATE_SECRET
    (.env.local 56 字符 vs 我起的服务 e2e-test-secret)导致 /api/cms/revalidate 401;
    重启服务后 cms-workflow 3 passed、整套 59 passed / EXIT=0
  • 结论以 origin/dev 为准:git fetch origin dev 后 HEAD..origin/dev = 0(基线 03be1c9e)
  • UI 改动已人工复核:5 张 footer-section-*.png 逐张读图 + 390/1440 联系卡片裁图与用户原图对照;
    未验证项已在下方明列

其他说明

视觉基线口径

  • 90 张 = 75 张已入库全页图 + 5 张 footer-section + 10 张首页 theme-light/dark-main。
    主题图取 main,而 main 在 client-layout.tsx:15 包住整个营销布局(含页脚),所以同样受本次位移影响。
  • 核验方式:verify-baseline-diff.py 对每张对比 HEAD blob 与工作树文件,要求宽高严格相等、差异团块
    包围盒 ≤ 26×74 CSS px、孤立噪点 ≤ 20px;实测 90/90 通过,包围盒落在 14.7–17 × 58–66 CSS px。
    仪器自身有正/负对照(--selftest)。
  • 工作树里另有 100 张未入库基线,是另一批未提交的「20 路由视觉扩容」的配套;HEAD 的视觉清单
    只有 15 条路由 = 75 张已入库全页图。那 100 张不在本 PR(已与决策人确认)。
  • docs/lessons-learned.md 当前工作树里已有别人未提交的 §5.52,本轮不写 lessons 正文,§5.53 草稿放进
    acceptance README,随那批一起入库(已与决策人确认)。

推送说明:单次 push(223MB 基线)被服务端断开 / 413 两次,改为按 project 拆 6 个 commit 推送;
tablet 与 webkit 各重试一次成功后完成。

未验证项

  1. 全量功能 E2E(npm run test 的 functional 部分)未跑:改动不触业务逻辑,行为面由视觉全量 125/125、
    四引擎几何守卫与 test:e2e:fast 覆盖。
  2. npm run lighthouse 未跑(原因见上)。
## 变更摘要 页脚「联系我们」两行的 MapPin / Mail 图标与右侧文字不在同一水平中线(用户 2026-10-26 截图:图标偏高约 3px)。 根因:旧写法 `flex items-start` + 图标固定 `mt-0.5` 手拍偏移,而本项目把 `leading-relaxed` 重映射成 `--line-height-relaxed: 1.85`(`globals.css:236`,不是 Tailwind 默认 1.625),根字号又有 16 / 17 / 18 三档 (`globals.css:542-558`)。行盒高 = 25.9 / 27.52 / 29.14px,图标中心固定落在 `0.125rem + 半图标` ⇒ 地址行偏高 3.319 / 3.134 / 2.950px,邮箱行偏高 3.313 / 3.133 / 2.945px(root 18/17/16)。 改法(`src/components/layout/footer.tsx`,唯一产品代码改动):让偏移成为结构而不是数字 —— 地址行图标包进「高 = 行盒高(`--line-height-relaxed × --font-size-sm`)」的 `items-center` 单元格, 换行后仍对齐首行;邮箱是单行链接,整行 `items-center`。**行高 / 字号 / 页高零变化,只移动两个图标**。 配套: - 新增 `e2e/footer-contact-align.spec.ts`:三档视口(1440/834/390)× 2 行,盒子判据,四引擎通过。 - 视觉基线重采 **90 张**(75 全页 + 5 页脚 + 10 首页主题),逐张机器核验「尺寸不变 + 差异团块只落在 两个图标盒内」;5 张 footer 基线逐张读图。 - 证据目录 `docs/acceptance/2026-10-26-footer-icon-align/`(含复跑脚本、三轮视觉读数、lessons §5.53 草稿)。 ## 关联 Issue 关闭:N/A(无关联 Issue;来源:用户 2026-10-26 截图反馈「图标和文字不在一条水平线上」) ## 全链路检查 - [x] `npm run type-check` 通过(0 error,EXIT=0) - [x] `npm run lint` 通过:EXIT=0,0 error / 84 warning;本批两文件单跑 `npx eslint` 亦 0 条(未新增告警) - [x] 路由/链接真实:N/A——未新增或改动任何 `href` / `Link` 目标 - [x] 涉及 CMS 内容模型:N/A——未触及 content-types / seed,无需重跑 `npm run db:seed` - [x] 涉及视觉/交互改动:已在新起的 `npx next dev -p 3001` 上用浏览器复核(端口 3000 被本机 `auth-center` 容器占用,未把旧服务当现状) - [x] 暗黑模式:沿用既有 `text-dark-text-muted` 语义 token,未新增裸色值 - [x] 动效合规:N/A——未改动任何动效 - [x] 品牌红 `#C41E3A`:N/A——未改品牌红触达点与面积 - [x] 数字与宣称口径:N/A——未改文案与结果型数字 - [x] 无遗留 `console.log` / `TODO` / `FIXME` / `.only()` ## 测试分层检查(L0–L3) - [x] **L0 单元**:N/A——未新增工具函数 / Hook / CMS 渲染器;`footer.test.tsx` 28 例通过 - [x] **L1 组件**:`footer.test.tsx` 28 例通过(含两行渲染、图标存在、联系方式文案断言) - [x] **L2 E2E**:`npm run test:e2e:fast` → EXIT=0,**59 passed / 25 skipped**(dev 下 16 个 @critical GA4 用例与其它 dev 专属用例按设计 skip);新增几何守卫在 chromium / chromium-mobile / firefox / webkit 四引擎 **12 passed** - [x] **L3 视觉回归**:`npm run test:visual:all -- --update-snapshots=none`(PR 口径 = HEAD 的 15 路由清单) → **125 passed / 0 failed**;重采 90 张后逐张机器核验(`verify-baseline-diff.py`,含 A/B 负对照) - [x] 新增机械守卫带**正控制**:守卫先在未修复树上跑红(实测 -3.319 / -3.134 / -2.950px),修复后转绿; 基线核验脚本的负对照 A(整幅下移 10px)与 B(非图标区横移 2px)均判红、正对照通过 → `SELFTEST PASS` - [x] 已运行相关测试并全绿,无 `.only()` / 跳过态残留 ## 质量门禁 - [x] `npm run test:unit` 全部通过(151 suites / 1830 tests,EXIT=0) - [x] `npm run test:coverage` 通过 `config/test/jest.config.js` 的 `coverageThreshold`(global 实测 stmts 89.6 / branch 88.25 / funcs 88.28 / lines 89.6,EXIT=0,未下调阈值) - [x] `npm run test`(Playwright E2E)全部通过:**N/A**——本轮跑的是 `test:visual:all`(125/125)与 `test:e2e:fast`(59 passed / 25 skipped);**全量功能 E2E 未跑**,列入「其他说明·未验证项」 - [x] `npm run check:contrast` 与 `npm run check:headings` 通过:`npm run check:a11y` EXIT=0, 34 页 0 问题,brand-token 检查通过 - [x] `npm run lighthouse`:**N/A**——未改性能路径、未新增资源/JS;需新起生产产物才能出数,本轮未跑 - [x] `npm run test:security:headers`:**N/A**——未涉响应头 / CSP / 部署配置 - [x] 文档已同步:新增 `docs/acceptance/2026-10-26-footer-icon-align/`(结论、读数、复跑命令、 lessons §5.53 草稿);`README/CONTEXT/CLAUDE/DESIGN/PRODUCT` 不受影响(无新命令/术语/架构) - [x] 提交信息符合 Conventional Commits;按「代码+守卫+证据 → 各 project 基线」拆成 6 个可独立评审的切片 - [x] 破坏性/共享状态动作:无(视觉基线重采已取得用户授权;未部署、未改 DB、未 force push) ## 假绿灯纪律 - [x] 门禁命令**实际执行过**并在此粘贴真实输出(含一次红:首轮 `e2e:fast` 的 cms 401,见「其他说明」) - [x] 未通过删测试、放宽断言、`skip`/`todo`、下调阈值等方式让门禁变绿;视觉阈值 `maxDiffPixels: 200` 与 `threshold: 0.3` 均未改 - [x] 未把误报当问题「修掉」:首轮 `e2e:fast` 的唯一红是**本手工作业**覆盖了 `CMS_REVALIDATE_SECRET` (`.env.local` 56 字符 vs 我起的服务 `e2e-test-secret`)导致 `/api/cms/revalidate` 401; 重启服务后 `cms-workflow` 3 passed、整套 **59 passed / EXIT=0** - [x] 结论以 `origin/dev` 为准:`git fetch origin dev` 后 `HEAD..origin/dev` = **0**(基线 03be1c9e) - [x] UI 改动已人工复核:5 张 `footer-section-*.png` 逐张读图 + 390/1440 联系卡片裁图与用户原图对照; 未验证项已在下方明列 ## 其他说明 **视觉基线口径** - 90 张 = 75 张已入库全页图 + 5 张 `footer-section` + 10 张首页 `theme-light/dark-main`。 主题图取 `main`,而 `main` 在 `client-layout.tsx:15` 包住整个营销布局(含页脚),所以同样受本次位移影响。 - 核验方式:`verify-baseline-diff.py` 对每张对比 `HEAD` blob 与工作树文件,要求宽高严格相等、差异团块 包围盒 ≤ 26×74 CSS px、孤立噪点 ≤ 20px;实测 90/90 通过,包围盒落在 14.7–17 × 58–66 CSS px。 仪器自身有正/负对照(`--selftest`)。 - 工作树里另有 **100 张未入库基线**,是另一批**未提交**的「20 路由视觉扩容」的配套;`HEAD` 的视觉清单 只有 15 条路由 = 75 张已入库全页图。那 100 张不在本 PR(已与决策人确认)。 - `docs/lessons-learned.md` 当前工作树里已有别人未提交的 §5.52,本轮不写 lessons 正文,§5.53 草稿放进 acceptance README,随那批一起入库(已与决策人确认)。 **推送说明**:单次 push(223MB 基线)被服务端断开 / 413 两次,改为按 project 拆 6 个 commit 推送; tablet 与 webkit 各重试一次成功后完成。 **未验证项** 1. 全量功能 E2E(`npm run test` 的 functional 部分)未跑:改动不触业务逻辑,行为面由视觉全量 125/125、 四引擎几何守卫与 `test:e2e:fast` 覆盖。 2. `npm run lighthouse` 未跑(原因见上)。
zhangxiang added 6 commits 2026-10-26 10:56:42 +08:00
旧写法用固定 mt-0.5 给图标手拍偏移,而本项目 --line-height-relaxed 是 1.85(非 Tailwind
默认 1.625),根字号又有 16/17/18 三档 ⇒ 图标中心比文字行盒中心高 3.319/3.134/2.950px
(地址行)与 3.313/3.133/2.945px(邮箱行)。

改为结构对齐:地址行图标包进高 = 行盒高(--line-height-relaxed × --font-size-sm)的
items-center 单元格,换行后仍对齐首行;邮箱行是单行链接,整行 items-center。
行高/字号/页高零变化,只移动两个图标。
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin fix/footer-contact-align:fix/footer-contact-align
git checkout fix/footer-contact-align
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novalon/novalon-website#63