SxImage (图片容器)
- Implemented
增强的图片展示组件。对齐 NextUI 扩展 规范，并说明当前实现能力。
使用场景
- 展示头像、封面与缩略图
- 图片加载与错误占位
- 固定尺寸图片容器
约束说明
Src为空时仅显示占位。Fit控制object-fit行为。
行为说明
- 加载中显示占位符。
- 加载失败显示错误提示。
API
Parameters (参数)
| 状态 | 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
| Implemented | Src |
string? |
"" |
图片地址。 |
| Implemented | Alt |
string? |
"" |
替代文本。 |
| Implemented | Fit |
ObjectFit |
Cover |
缩放模式：Cover, Contain, Fill, None。 |
| Implemented | Disabled (继承) |
bool |
false |
禁用状态。 |
| Implemented | Id (继承) |
string? |
null |
组件的物理 Id。 |
| Implemented | Class (继承) |
string? |
null |
自定义 CSS 类名。 |
| Implemented | Style (继承) |
string? |
null |
自定义样式。 |
| Implemented | Title (继承) |
string? |
null |
HTML title 属性。 |
| Implemented | AdditionalAttributes (继承) |
IEnumerable<KeyValuePair<string, object>>? |
null |
捕获不匹配的 HTML 属性。 |
示例
<SxImage Src="_src" Alt="Preview" Fit="ObjectFit.Cover" />