mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-16 18:09:22 +08:00
1.6 KiB
1.6 KiB
category | subtitle | type | title | cols | cover |
---|---|---|---|---|---|
Components | 图片 | 数据展示 | Image | 2 | https://gw.alipayobjects.com/zos/antfincdn/D1dXz9PZqa/image.svg |
可预览的图片。
何时使用
- 需要展示图片时使用。
- 加载大图时显示 loading 或加载失败时容错处理。
API
参数 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
alt | 图像描述 | string | - | 4.6.0 |
fallback | 加载失败容错地址 | string | - | 4.6.0 |
height | 图像高度 | string | number | - | 4.6.0 |
placeholder | 加载占位, 为 true 时使用默认占位 |
ReactNode | - | 4.6.0 |
preview | 预览参数,为 false 时禁用 |
boolean | previewType | true | 4.6.0 previewType:4.7.0 |
src | 图片地址 | string | - | 4.6.0 |
width | 图像宽度 | string | number | - | 4.6.0 |
onError | 加载错误回调 | (event: Event) => void | - | 4.12.0 |
rootClassName | 为展示图片根 DOM 和预览大图根 DOM 提供自定义 className | string | - | 4.20.0 |
previewType
{
visible?: boolean;
onVisibleChange?: (visible, prevVisible) => void;
getContainer?: string | HTMLElement | (() => HTMLElement); // v4.8.0
src?: string; // v4.10.0
mask?: ReactNode; // v4.9.0
maskClassName?: string; // v4.11.0
current?: number; // v4.12.0 仅支持 PreviewGroup
countRender?: (current: number, total: number) => string // v4.20.0 仅支持 PreviewGroup
scaleStep?: number;
forceRender?: boolean;
}
其他属性见 <img>