ویرگول
ورودثبت نام
مصطفی رستگار
مصطفی رستگاربرنامه نویس کامپیوتر و ازین جور مسخره بازی ها!
مصطفی رستگار
مصطفی رستگار
خواندن ۲ دقیقه·۴ ماه پیش

16- Dynamic Routes و Catch-all Routes (تأثیر بر getStaticPaths)

«در App Router جدید Next.js، ساختار فولدرها مستقیماً تبدیل به آدرس‌های URL می‌شوند. برای ساخت صفحات پویا (Dynamic)، از نام فولدر یا فایل با کروشه استفاده می‌کنیم. مثلاً فولدری به نام [id] یعنی هر مقداری که در آدرس بیاید، به عنوان پارامتر id در اختیار صفحه قرار می‌گیرد.

حالا تفاوت Dynamic با Catch-all در این است که Dynamic فقط یک بخش از آدرس را می‌گیرد، اما Catch-all با سه نقطه (...) نوشته می‌شود و می‌تواند یک یا چند بخش از آدرس را پوشش دهد. مثلاً فولدر [...slug] یعنی هر تعداد بخش که بعد از آدرس اصلی بیاید، به صورت یک آرایه در پارامتر slug ذخیره می‌شود.

تأثیر اصلی این دو بر روی getStaticPaths در زمان Build است. چون اگر می‌خواهیم این صفحات را به صورت استاتیک (Static) از پیش رندر کنیم، باید در تابع generateStaticParams (که معادل جدید getStaticPaths است) دقیقاً مشخص کنیم که چه مقادیری قرار است تولید شوند.

برای Dynamic معمولی، لیستی از اشیاء با همان کلید (مثلاً { id: '1' }) برمی‌گردانیم. اما برای Catch-all، مقدار را به صورت یک آرایه در همان کلید (slug) تحویل می‌دهیم. مثلاً { slug: ['products', 'shoes', 'nike'] } یعنی آدرس /products/shoes/nike تولید می‌شود.

نکته مهم این است که اگر از generateStaticParams استفاده نکنیم، Next.js این صفحات را در زمان درخواست (SSR یا ISR) رندر می‌کند و دیگر تأثیری روی Build ندارد. همچنین اگر پارامتری در generateStaticParams تعریف نشود، با استفاده از fallback: true یا 'blocking' می‌توانیم صفحات جدید را موقع بازدید کاربر بسازیم.

به طور خلاصه، App Router مسیرها را ساده‌تر کرده، اما برای رندر استاتیک، ما موظفیم در generateStaticParams تمام حالت‌های ممکن Dynamic و Catch-all را مشخص کنیم تا Next.js بتواند هنگام Build، فایل‌های HTML متناظر با آن‌ها را تولید کند.»


نکات کلیدی برای تسلط بیشتر (برای خودت):

۱. تفاوت نحوه نوشتن:

  • [id] → فقط یک بخش: page/[id] → آدرس: /page/5

  • [...slug] → یک یا چند بخش: page/[...slug] → آدرس: /page/a/b/c (خواهد شد slug: ['a','b','c'])

۲. نحوه نوشتن در generateStaticParams (معادل getStaticPaths):

js

// برای Dynamic ساده: generateStaticParams() { return [{ id: '1' }, { id: '2' }]; } // برای Catch-all: generateStaticParams() { return [ { slug: ['products', 'shoes'] }, { slug: ['blog', 'nextjs', 'tutorial'] } ]; }

۳. نکته فنی:

  • در App Router، دیگر از getStaticProps و getStaticPaths استفاده نمی‌کنیم، بلکه به جای آن‌ها از generateStaticParams و داخل خود کامپوننت از fetch یا کش استفاده می‌کنیم.

۴. جمع‌بندی کاربردی:

  • اگر تعداد صفحات محدود و مشخص است، حتماً از generateStaticParams استفاده کن تا سایتت سریع‌تر شود.

  • اگر تعداد صفحات نامحدود یا خیلی زیاد است، از fallback: 'blocking' استفاده کن تا فقط صفحات پرطرفدار اول ساخته شوند.

مصاحبه فنیreact
۰
۰
مصطفی رستگار
مصطفی رستگار
برنامه نویس کامپیوتر و ازین جور مسخره بازی ها!
شاید از این پست‌ها خوشتان بیاید