بهینه‌سازی تصاویر در Next.js – استفاده از تصاویر محلی و ریموت با کامپوننت <Image>

کامپوننت <Image> در Next.js نسخه‌ای پیشرفته از تگ <img> است که امکاناتی مانند بارگذاری تنبل، جلوگیری از جابه‌جایی چیدمان، پشتیبانی از فرمت‌های مدرن و بهینه‌سازی خودکار اندازه تصویر را فراهم می‌کند. این مقاله نحوهٔ استفاده از این کامپوننت برای تصاویر محلی و ریموت، و همچنین پیکربندی دامنه‌های مجاز برای تصاویر خارجی را بررسی می‌کند.

Next.js ImageImage OptimizationLazy LoadingRemote ImagesBlur Placeholder

~2 دقیقه مطالعه · آخرین به‌روزرسانی ۳ آبان ۱۴۰۴

چرا از <Image> استفاده کنیم؟


کامپوننت next/image نسخه‌ای بهینه‌شده از تگ <img> است که امکانات زیر را فراهم می‌کند:

  • بهینه‌سازی اندازه: ارائهٔ خودکار تصویر با اندازه و فرمت مناسب (مانند WebP) برای هر دستگاه
  • ثبات بصری: جلوگیری از جابه‌جایی چیدمان هنگام بارگذاری تصویر
  • بارگذاری تنبل: بارگذاری تصویر فقط زمانی که وارد دید کاربر می‌شود
  • پیش‌نمایش محو: نمایش نسخهٔ کم‌کیفیت تا بارگذاری کامل تصویر
  • پشتیبانی از منابع خارجی: بهینه‌سازی تصاویر حتی از سرورهای ریموت

شروع استفاده


ابتدا کامپوننت را وارد کرده و در JSX استفاده کنید:

import Image from 'next/image'

export default function Page() {
  return <Image src="" alt="" />
}

استفاده از تصاویر محلی


تصاویر را در پوشهٔ /public قرار دهید و با مسیر نسبی از ریشه به آن‌ها ارجاع دهید:

<Image
  src="/profile.png"
  alt="تصویر نویسنده"
  width={500}
  height={500}
/>

وارد کردن ایستا


اگر تصویر را به‌صورت ایستا import کنید، Next.js به‌طور خودکار عرض، ارتفاع و placeholder محو را تشخیص می‌دهد:

import ProfileImage from './profile.png'

<Image
  src={ProfileImage}
  alt="تصویر نویسنده"
  placeholder="blur"
/>

استفاده از تصاویر ریموت


برای استفاده از تصاویر خارجی، کافی است URL تصویر را در src قرار دهید:

<Image
  src="https://s3.amazonaws.com/my-bucket/profile.png"
  alt="تصویر نویسنده"
  width={500}
  height={500}
/>

چون Next.js در زمان build به تصاویر ریموت دسترسی ندارد، باید width و height را به‌صورت دستی مشخص کنید تا نسبت تصویر حفظ شود و از جابه‌جایی چیدمان جلوگیری شود. همچنین می‌توانید از ویژگی fill برای پر کردن فضای والد استفاده کنید.


اجازه دادن به دامنه‌های ریموت


برای استفاده ایمن از تصاویر خارجی، دامنه‌های مجاز را در next.config.ts تعریف کنید:

// next.config.ts
import type { NextConfig } from 'next'

const config: NextConfig = {
  images: {
    remotePatterns: [
      {
        protocol: 'https',
        hostname: 's3.amazonaws.com',
        pathname: '/my-bucket/**',
      },
    ],
  },
}

export default config

نکته: دامنه‌ها را به‌صورت دقیق مشخص کنید تا از سوءاستفاده جلوگیری شود.


جمع‌بندی


کامپوننت <Image> در Next.js راهکاری مدرن و بهینه برای مدیریت تصاویر است. چه از تصاویر محلی استفاده کنید و چه از منابع خارجی، این کامپوننت تضمین می‌کند که تصاویر با سرعت بالا، کیفیت مناسب و بدون جابه‌جایی چیدمان بارگذاری شوند.


نوشته و پژوهش‌شده توسط دکتر شاهین صیامی

مقالات مرتبط

مسیریابی پیشرفته و هوک‌های عملکرد در Next.js — راهنمای توسعه‌دهنده برای App Router

Next.js مجموعه‌ای غنی از هوک‌های کلاینت و ابزارهای کش و ناوبری را در اختیار توسعه‌دهندگان قرار می‌دهد. از خواندن پارامترهای مسیر تا گزارش Web Vitals و مدیریت کش، این مقاله مهم‌ترین ابزارهای App Router را با مثال‌های کاربردی معرفی می‌کند.

ادامه

مدیریت احراز هویت و کش در Next.js — راهنمای توسعه‌دهنده برای امنیت و عملکرد پویا

Next.js با معرفی قابلیت‌های آزمایشی جدید، امکان کنترل دقیق‌تر دسترسی و کش داده‌ها را فراهم کرده است. تابع unauthorized برای مدیریت خطای 401 و هدایت کاربران به صفحه ورود، unstable_cache برای کش هوشمند عملیات سنگین، updateTag برای بازسازی آنی داده‌ها، و useLinkStatus برای نمایش وضعیت ناوبری استفاده می‌شوند. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات مهم بررسی می‌کند.

ادامه

redirect و refresh در Next.js — ریدایرکت‌های هوشمند و تازه‌سازی مسیر در Server Actions

تابع redirect در Next.js برای هدایت کاربر به مسیر جدید استفاده می‌شود و بسته به نوع استفاده، پاسخ HTTP با وضعیت 307 یا 303 ارسال می‌کند. این تابع در Server Components، Client Components، Route Handlers و Server Actions قابل استفاده است. تابع refresh نیز برای تازه‌سازی مسیر کلاینت از درون Server Action استفاده می‌شود. این مقاله نحوه استفاده از هر دو تابع را با مثال‌های کاربردی و نکات مهم توضیح می‌دهد.

ادامه

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

ادامه

headers، ImageResponse، notFound و permanentRedirect در Next.js — مدیریت درخواست‌ها، تولید تصویر، خطا و ریدایرکت

Next.js ابزارهای قدرتمندی برای مدیریت درخواست‌ها و پاسخ‌ها در کامپوننت‌های سروری فراهم کرده است. تابع headers برای خواندن هدرهای HTTP ورودی، ImageResponse برای تولید تصاویر داینامیک، notFound برای نمایش صفحه خطای 404، و permanentRedirect برای ریدایرکت دائمی کاربران استفاده می‌شوند. این مقاله نحوه استفاده از هر یک را با مثال‌های کاربردی توضیح می‌دهد.

ادامه

راهنمای کامل استفاده از metadata و generateMetadata در Next.js

در نسخه‌های مدرن Next.js، مدیریت metadata صفحات بسیار قدرتمندتر و ساده‌تر شده است. metadata به‌صورت خودکار در تگ <head> صفحات تزریق می‌شود و نقش مهمی در SEO، اشتراک‌گذاری اجتماعی و تجربه کاربری دارد. این مقاله دو روش اصلی تعریف metadata را بررسی می‌کند: استفاده از آبجکت ثابت metadata و تابع داینامیک generateMetadata.

ادامه