媒体
image
图片资源展示组件。
稳定
微信兼容子集
使用示例
<image src="assets/icon.png" mode="aspectFit" />
属性说明
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
id | string | 否 | 节点标识,可用于 label.for 或测试定位。 | |
class | string | 否 | 附加样式类名。 | |
style | string | 否 | 受限内联样式。 | |
hidden | boolean | false | 否 | 是否隐藏当前节点。 |
data-* | string | 否 | 事件触发时进入 event.dataset。 | |
src | string | 否 | 资源地址或包内资源路径。 | |
alt | string | 否 | 图片替代文本。 | |
mode | string | 否 | 资源展示模式。 |
事件说明
| 事件 | event.detail | 说明 |
|---|---|---|
bindtap | { dataset } | 点击时触发。 |
bindload | { dataset } | 组件状态变化时触发。 |
binderror | { dataset } | 组件状态变化时触发。 |
Manifest 声明
能力组件必须声明权限和 API。没有宿主 provider 时,运行时会展示稳定降级态或返回结构化错误。
{
"permissions": [],
"apisUsed": []
}
平台支持
| 平台 | 支持情况 |
|---|---|
| Web | 支持 |
| Android SDK | WebView 运行时支持 |
| iOS SDK | WebView 运行时支持 |
| Flutter SDK | WebView 运行时支持 |
渲染协议
| 字段 | 值 |
|---|---|
| HTML 标签 | img |
| 样式类 | mini-image |
| 是否空元素 | 是 |
| 必填属性 | - |
| 必需 API | - |