--- category: Components type: Data Display title: Image cover: https://gw.alipayobjects.com/zos/antfincdn/D1dXz9PZqa/image.svg --- Previewable image. ## When To Use - When you need to display pictures. - Display when loading a large image or fault tolerant handling when loading fail. ## API | Property | Description | Type | Default | Version | | --- | --- | --- | --- | --- | | alt | Image description | string | - | 2.0.0 | | fallback | Load failure fault-tolerant src | string | - | 2.0.0 | | height | Image height | string \| number | - | 2.0.0 | | placeholder | Load placeholder, use default placeholder when set `true` | boolean \| slot | - | 2.0.0 | | preview | preview config, disabled when `false` | boolean \| [previewType](#previewType) | true | 2.0.0 | | src | Image path | string | - | 2.0.0 | | previewMask | custom mask | false \| function \| slot | - | 3.2.0 | | width | Image width | string \| number | - | 2.0.0 | ### events | Events Name | Description | Arguments | Version | | ----------- | -------------------- | ---------------------- | ------- | | error | Load failed callback | (event: Event) => void | 3.2.0 | ### previewType ```js { visible?: boolean; onVisibleChange?: (visible, prevVisible) => void; getContainer?: string | HTMLElement | (() => HTMLElement); src?: string; maskClassName?: string; current?: number; } ``` Other attributes [<img>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#Attributes)