<Image>

  • Image 组件

值得注意 : 如果您使用的是 Next.js 13 之前的版本,您需要参考 next/legacy/image 文档,因为该组件已被重命名。

本 API 参考文档将帮助您了解如何使用 props 和 配置选项 来配置 Image 组件。有关功能和用法,请参阅 Image 组件 页面。

// app/page.js import Image from 'next/image'; export default function Page() { return ( <Image src="/profile.png" width={500} height={500} alt="作者的照片" /> ); }

Props

以下是 Image 组件的属性摘要:

属性示例类型状态
srcsrc="/profile.png"字符串必需
widthwidth={500}整数(px)必需
heightheight={500}整数(px)必需
altalt="作者的照片"字符串必需
loaderloader={imageLoader}函数-
fillfill={true}布尔值-
sizessizes="(max-width: 768px) 100vw, 33vw"字符串-
qualityquality={80}整数(1-100)-
prioritypriority={true}布尔值-
placeholderplaceholder="blur"字符串-
stylestyle={{objectFit: "contain"}}对象-
onLoadingCompleteonLoadingComplete={img => done())}函数已弃用
onLoadonLoad={event => done())}函数-
onErroronError(event => fail()}函数-
loadingloading="lazy"字符串-
blurDataURLblurDataURL="data:image/jpeg..."字符串-
overrideSrcoverrideSrc="/seo.png"字符串-

关于更多

如果你想要了解更多可以去官方文档详细参阅