Skip to content

[Feature]: unify asset preview image loading states #435

Description

@huyanxius

Problem

资产库、角色详情和 Playtest 最近预览共用 AssetPreviewSurface,但图片地址存在时会直接渲染 <img>。图片尚未下载或解码、加载失败和图片已经可见之间没有明确状态,慢速网络下会先出现空白卡片,且失败可能长期保留破损图片。

Goal

  • 为共享资产预览建立 loading / ready / empty / error 状态。
  • 复用 Quick Start 已有点阵动画作为图片下载与解码期间的反馈。
  • 图片成功后平滑显现,失败时与“暂无造型预览”严格区分。

Scope

  • AssetPreviewSurfaceAssetPreviewCard
  • 资产库角色卡、角色详情造型主图、Playtest 最近预览卡。
  • 图片缓存命中、下载解码、加载失败和 reduced-motion 的定向测试。

Out of Scope

Acceptance Criteria

  • 图片尚未完成加载与解码时,预览区域保留明确点阵加载状态。
  • 图片真正可见后才结束加载反馈,并使用克制的进入过渡。
  • 缓存完成的图片不会产生明显 loading 闪烁。
  • 图片加载失败时显示独立错误状态,不冒充空资产。
  • 没有图片地址时继续显示现有“暂无造型预览”空状态。
  • 资产库、角色详情与 Playtest 最近预览保持同一套行为。
  • 支持 prefers-reduced-motion,并通过相关定向测试、类型检查和真实慢速图片验收。

Blocked By

Metadata

Metadata

Assignees

No one assigned

    Labels

    MiniSpec小改动的精简规格enhancementNew feature or request

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions