跳到主要内容

<Image>

  • 布局稳定性:加载图像时布局不会发生偏移。
  • 懒加载,只有当图片进入视口后,图片才会加载。
import Image from 'next/image'

export default function Page() {
return (
<Image
src="/profile.png"
width={500}
height={500}
alt="Picture of the author"
/>
)
}

props

NameTypeDefaultrequiredDescription
srcstring-必填图像的 URL
widthnumber--图像的宽度(px)
heightnumber--图像的高度(px)
altstring--图像的替代文本
loaderfunction--自定义加载器
fillboolean--图像是否应填充容器
sizesstring--图像的尺寸
qualitynumber--图像质量(1-100)
priorityboolean--图像是否应具有高优先级
placeholderstring--占位符,在图像加载之前显示
styleobject--图像的样式
onLoadingCompletefunction--图像加载完成时调用
onLoadfunction--图像加载时调用
onErrorfunction--图像加载失败时调用
loadingstring--图像加载时使用的 HTML 属性
blurDataURLstring--图像的占位符,在图像加载之前显示