Image 更新日志
v1.5.0 (2026-10-20)
修正外部 children 与 Frame 内部同名 Snippet 在 SSR 编译时相互遮蔽造成递归；媒体挂件行为保持。
新增
mediaLoading与公开provideMediaLoading()作用域默认值；默认 lazy，单项覆盖优先，保持视频及资源组件原行为。
2026-09-21：统一使用文档、源码属性表与 Site / AI 阅读入口；仅文档修订，不改变组件行为。
Image-Docs.2026-05-25 源码顶部历史更新日志已归档；后续新增变更统一写入本文档 更新日志，源码顶部只保留职责、当前关键架构与文档路径。
v1.4.0 (2026-07-05)
调整
未显式声明
previewMode时，页面存在共享 ImageViewer 服务则自动使用viewer；服务不存在时继续回退window。显式
viewer / window / none始终优先于自动路由。
v1.3.4 (2026-05-20)
调整
IM-Behavior.5 默认字符串图片/视频仍可点击打开；只有具备点击交互的 Image 才显示 hover 变色、手形指针与 button 语义，
previewMode="none"且无点击回调时保持静态展示。
v1.3.3 (2026-03-13)
调整
IM-Adjust.9 字符串图片与字符串视频在真实加载阶段接入组件内
Skeleton占位，媒体加载完成后再显示。
v1.3.2 (2026-03-13)
调整
IM-Adjust.8 扩展尺寸梯度：新增
56 / 64 / 72，并将圆角映射更新为56→16px、64/72/80→20px。
v1.3.1 (2026-03-13)
调整
IM-Adjust.7 移除
openable / disableImageViewer兼容属性；当前打开行为只由previewMode控制。
v1.3.0 (2026-03-12)
调整
IM-Adjust.5 新增
previewMode="viewer" | "window" | "none"，并将默认打开方式收口为window。IM-Behavior.4
Image不再因页面存在ImageViewer自动接入页面级预览；只有显式声明previewMode="viewer"时才进入 Viewer 链路。
v1.2.2 (2026-03-12)
修复
IM-Fix.12
openable新增Enter键支持，补齐与Space一致的键盘打开语义。IM-Behavior.3 页面中存在自动模式
ImageViewer时，Image默认可点击打开，不再要求显式传入openable；disableImageViewer仍可强制改走新窗口。IM-Fix.13 恢复外部
mouseenter / mouseleave回调透传，避免视频 hover 逻辑吞掉页面层联动。IM-Fix.14 移除
!important焦点覆盖，改为仅在:focus-visible下清空默认 outline；同时将内部 hover 覆写变量改为--snowui-image-*命名。
v1.2.0 (2026-03-10)
新功能
IM-Feat.6 新增
disableImageViewer属性，可强制当前Image回退为新窗口打开。IM-Behavior.2
openable在页面存在自动模式ImageViewer时默认接入页面级单一 Viewer；否则自动回退为新窗口打开。
v1.2.1 (2026-03-11)
调整
IM-Adjust.4 字符串图片改为直接使用原生
<img>加载并通过load/error事件更新状态，移除额外的window.Image()预加载器，降低大图列表下的重复加载开销。
v1.1.11 (2026-03-10)
新功能
IM-Feat.5 新增字符串视频资源支持；
Image现在可渲染 mp4/webm/ogg/mov。IM-Behavior.1 视频缩略态 hover 时自动播放，离开后暂停并回到起始帧。
v1.0.6 (2026-03-10)
修复
IM-Fix.5 有图模式 hover 改为内部视觉遮罩层压暗，避免仅依赖
filter时在部分图片场景下视觉效果不明显。
v1.1.4 (2026-03-10)
调整
IM-Adjust.3 下调
Image图片态 hover 遮罩强度，使 hover 颜色与Avatar既有 hover 观感保持一致。
v1.1.3 (2026-03-10)
修复
IM-Fix.11 恢复
Image在本轮中已验证可见的图片态 hover：改回内部视觉遮罩层变暗，不再依赖图片节点brightness。
v1.1.2 (2026-03-10)
修复
IM-Fix.10 图片态 hover 统一同时命中视觉层与实际
media节点，进一步消除不同图片来源下的 hover 丢失问题。
v1.1.1 (2026-03-10)
修复
IM-Fix.9 图片态 hover 统一命中实际
media节点，修复有图Image在资源图片场景下 hover 不生效的问题。
v1.1.0 (2026-03-10)
调整
IM-Adjust.2
Image的 hover 选择器移至src/styles/layout.css，与Avatar共用统一 hover 规则。
v1.0.9 (2026-03-10)
修复
IM-Fix.8 为
resource-svelte图片补充轻量 hover 保底层，解决资源图片场景下 hover 视觉丢失的问题。
v1.0.8 (2026-03-10)
修复
IM-Fix.7 强化图片态 hover 命中：在保留
brightness(0.85)策略的前提下，让图片节点也参与亮度变化，避免部分图片场景下 hover 视觉丢失。
v1.0.7 (2026-03-10)
修复
IM-Fix.6
Image的 hover 实现完全对齐Avatar：移除图片遮罩层，恢复有图模式对视觉层使用brightness(0.85)。
v1.0.5 (2026-03-10)
修复
IM-Fix.4 对齐
Avatar的 hover 分层：图片模式压暗视觉层；占位态 hover 改为背景层从--black-4过渡到--black-10。
v1.0.4 (2026-03-10)
修复
IM-Fix.3
as="icon"宿主样式改为仅负责居中定位，不再通过inset: 0拉伸Button等子组件尺寸。
v1.0.3 (2026-03-10)
调整
IM-Adjust.1
Image新增尺寸到圆角的固定映射：12/16/20→4px，24/28/32→8px，40/48→12px，80→20px。
v1.0.2 (2026-03-10)
修复
IM-Fix.2 移除容器底色与背景层的重复
--black-4叠加，默认占位态收敛为单一背景层。
v1.0.1 (2026-03-10)
修复
IM-Fix.1 默认占位态改为单层
--black-4背景，移除重复叠层造成的视觉偏深。
v1.0.0 (2026-03-10)
新功能
IM-Feat.1 新增 Image 组件，支持字符串图片与
resource-svelte图片组件。IM-Feat.2 新增默认占位态，未传素材时显示
--black-4背景。IM-Feat.3 新增
as="badge"与as="icon"组合定位协议。IM-Feat.4 新增
openable触发语义，支持点击和空格打开预览。