Files
short-drama-agent-front/design-qa.md
T
GouJ 42c40383dc fix: 提升形态筛选区控件对比度
让筛选区内的搜索框和下拉框使用页面表面色,避免与浅灰容器背景融合,并补充样式契约测试。
2026-09-08 10:10:06 +08:00

3.5 KiB
Raw Blame History

Design QA

  • Source visual truth: /workspace/scratch/6e52996114b8/upload/a17fe159-829a-4938-9b65-3955b6d6f2e5.png
  • Source pixel dimensions: 494 × 326.
  • Intended implementation viewport: mobile dark theme, approximately 393px CSS width.
  • Implementation screenshot: unavailable.
  • CSS size and density normalization: unavailable because the implementation could not be opened in the cloud browser.
  • State: 形态图片页默认筛选状态。

Full-view comparison evidence

The source screenshot was opened and inspected. It shows the filter container and its search/select controls using nearly identical gray values, so the controls lose their boundaries and read as one continuous surface.

The component now keeps the lighter grouping background while overriding its inherited --app-field and --app-field-hover values with --app-surface. In the dark theme this separates the approximately #2c2c2c group from the #191919 controls; the same token relationship also preserves contrast in the light theme.

A local Sites preview started successfully, but the cloud browser rejected terminal.local with net::ERR_BLOCKED_BY_CLIENT. Therefore no browser-rendered implementation screenshot is available.

Focused region comparison evidence

  • Filter group: keeps 12px equal padding and the lighter token-derived background requested in the previous iteration.
  • Search and select controls: now inherit the darker page-surface token inside this group, restoring a clear nested-control boundary without adding borders or changing sizing.

These are code-level checks only and do not replace a rendered focused-region comparison.

Required fidelity surfaces

  • Fonts and typography: unchanged; browser comparison is blocked.
  • Spacing and layout rhythm: the existing 12px padding and two-row mobile grid are unchanged.
  • Colors and visual tokens: the group/control contrast is corrected with existing theme tokens; browser sampling is blocked.
  • Image quality and asset fidelity: no image or crop behavior changed.
  • Copy and content: unchanged.

Findings

  • [P1] Browser-rendered comparison unavailable
    • Location: 形态图片筛选区。
    • Evidence: the required cloud browser returns net::ERR_BLOCKED_BY_CLIENT for the healthy local preview.
    • Impact: exact rendered contrast, hover/focus states, interaction behavior, and console state cannot be visually certified.
    • Fix: open this branch in an available browser with project data and capture the filter area at the same mobile width.

Primary interactions tested

Automated tests protect the local field-token override together with the existing filter layout and theme contract. All 275 tests pass. Browser interactions were unavailable.

Console errors checked

Not checked because the page could not be opened in the cloud browser.

Comparison history

  • Iteration 1: identified insufficient contrast caused by the outer group (#2c2c2c) and controls (#2b2b2b) rendering at nearly the same value.
  • Iteration 2: changed only the filter region's inherited input tokens to --app-surface, retained the existing outer background and layout, and passed the full test/build suite. Browser capture remained blocked.

Implementation checklist

  • Preserve the lighter filter-group background.
  • Restore distinct search/select control surfaces in dark and light themes.
  • Add a style-contract regression assertion.
  • Capture and compare the rendered mobile state in the cloud browser.

final result: blocked