«در 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' استفاده کن تا فقط صفحات پرطرفدار اول ساخته شوند.