组件功能
用于显示图片的组件,支持多种适配模式、位置、尺寸以及边框和圆角配置。
基础用法
通过 src 指定图片 URL,fit 控制适配模式,alt 提供替代文本。
Template 示例:
<Image
src="https://picsum.photos/id/237/400/400"
alt="示例图片"
fit="cover"
/>
效果展示如下:

属性说明
| 属性名 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| src ★ | string |
图片 URL | - |
| alt | string |
图片替代文本 | - |
| frame | boolean |
是否显示边框 | false |
| fit | "cover" | "contain" | "fill" | "scale-down" | "none" |
图片适配模式 | "cover" |
| position | ImagePosition |
图片位置 | "center" |
| flush | boolean |
是否贴边显示 | false |
尺寸属性
| 属性名 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| height | number | string |
高度 | - |
| width | number | string |
宽度 | - |
| size | number | string |
同时设置宽高 | - |
| minHeight | number | string |
最小高度 | - |
| minWidth | number | string |
最小宽度 | - |
| minSize | number | string |
最小尺寸 | - |
| maxHeight | number | string |
最大高度 | - |
| maxWidth | number | string |
最大宽度 | - |
| maxSize | number | string |
最大尺寸 | - |
| aspectRatio | number | string |
宽高比 | - |
| radius | RadiusValue |
圆角 | - |
| margin | number | string | Spacing |
外边距 | - |
注意:
★ 标记为必填属性。
ImagePosition 类型
用于控制图片再容器中的显示位置,可选值:
-
"top left"- 左上 -
"top"- 上中 -
"top right"- 右上 -
"left"- 左中 -
"center"- 居中 -
"right"- 右中 -
"bottom left"- 左下 -
"bottom"- 下中 -
"bottom right"- 右下
适配模式说明
-
cover:保持比例,裁剪以填充整个容器。
-
contain:保持比例,完整显示图片。
-
fill:拉伸图片以填充容器。
-
scale-down:选择 none 或 contain 中较小的一个。
-
none:保持原始尺寸。