Files
short-drama-agent-front/design-qa.md
T
GouJ c2639ca7af feat: 为桌面折叠侧栏添加菜单提示
PC 折叠侧栏菜单图标增加 NPopover 提示,并保留图标导航能力;展开态和移动端不显示重复提示。
2026-09-09 10:18:02 +08:00

3.5 KiB
Raw Blame History

Design QA

  • Source visual truth: /workspace/scratch/6e52996114b8/upload/6c29987c-43a6-4ded-ba86-b66d1c638f51.png
  • Source pixel dimensions: 151 × 506.
  • Browser-rendered implementation: /workspace/scratch/6e52996114b8/sidebar-popover-pc-final-20260909.jpg
  • Browser-rendered implementation dimensions: 1363 × 936.
  • Focused side-by-side comparison: /workspace/scratch/6e52996114b8/sidebar-popover-comparison-final-20260909.jpg
  • Implementation CSS viewport: 1363 × 936, device scale factor 1.
  • State: PC dark theme, collapsed sidebar, pointer hovering the disabled “视觉风格” icon.

Full-view comparison evidence

The implementation preserves the existing collapsed sidebar width, icon order, selected state and main-content boundary. Hovering an icon opens a compact Naive UI popover to the right without shifting the sidebar or content.

Focused region comparison evidence

The focused comparison places the supplied sidebar crop beside a 320 × 506 crop of the browser render. The source icon spacing, dark surfaces and green selected state remain unchanged. The implementation adds the requested hover label beside the icon; disabled workflow items use the explanatory suffix “(剧本完成后可用)”.

Required fidelity surfaces

  • Typography: the application typography is unchanged; popover copy uses the current Naive UI theme and compact UI text sizing.
  • Spacing and layout rhythm: the 64px collapsed sidebar and existing vertical menu rhythm are preserved. Popovers use placement="right" and do not alter document flow.
  • Colors and visual tokens: dark sidebar surfaces and the selected green state remain unchanged. Popovers inherit the existing dark Naive UI theme.
  • Image and asset fidelity: no raster assets were introduced. Existing Lucide menu icons are preserved.
  • Copy and content: PC hints use each menu's existing label. Locked entries append “(剧本完成后可用)”; “后端连接” keeps its original copy.

Findings

  • No actionable P0/P1/P2 visual or responsive issues remain.
  • The disconnected local backend produces the expected in-page 502 response; it does not affect sidebar layout or popover behavior.

Primary interactions tested

  • Collapsed the PC sidebar and hovered an enabled menu icon; “我的剧本” appeared.
  • Hovered the disabled “视觉风格” icon; its availability explanation appeared.
  • Hovered the bottom settings icon; “后端连接” appeared.
  • Clicked an enabled collapsed icon and confirmed navigation to the target workflow route.
  • Expanded the PC sidebar and confirmed menu popovers were absent.
  • Confirmed through component tests that mobile navigation does not render menu popovers.

Console errors checked

No application-origin console errors were reported. The cloud browser logged only extension metadata messages outside the application.

Comparison history

  • Iteration 1: added native NPopover wrappers and found that the full-width transparent RouterLink intercepted hover on enabled menu icons.
  • Iteration 2: made enabled collapsed icons direct RouterLinks, raised their trigger layer above the transparent label and rechecked enabled, disabled and settings hints in the browser.

Implementation checklist

  • Add NPopover hints to all PC collapsed sidebar menu icons.
  • Preserve click navigation for enabled collapsed icons.
  • Explain locked workflow items in their hint copy.
  • Keep PC expanded and mobile navigation free of duplicate popovers.
  • Preserve sidebar size, spacing, theme and selected state.

final result: passed