ساخت اپلیکیشن تک‌صفحه‌ای (SPA) با Next.js – رندر کلاینتی، ناوبری سریع، و واکشی داده پویا

Next.js به‌طور کامل از ساخت SPA پشتیبانی می‌کند — با رندر کلاینتی، ناوبری سریع، و واکشی داده پویا. این مقاله الگوهای رایج ساخت SPA با استفاده از context، SWR، React Query، Server Actions و shallow routing را بررسی می‌کند، در حالی که امکان افزودن تدریجی قابلیت‌های سرور نیز فراهم است.

Client RenderingSWRReact Query

~2 min read · Updated Oct 28, 2025

SPA چیست؟


اپلیکیشن تک‌صفحه‌ای (SPA) به اپی گفته می‌شود که تمام رندر، ناوبری، و واکشی داده‌ها در مرورگر انجام می‌شود. هیچ بارگذاری مجدد صفحه وجود ندارد و همه چیز با جاوااسکریپت مدیریت می‌شود.


چرا از Next.js برای SPA استفاده کنیم؟


  • تقسیم خودکار کد و کاهش حجم باندل
  • ناوبری سریع با next/link و prefetch
  • امکان شروع با SPA و افزودن تدریجی قابلیت‌های سرور

الگوی واکشی داده با context و use()


در layout ریشه، واکشی داده را آغاز کنید و Promise را به context منتقل کنید:

// app/layout.tsx
let userPromise = getUser()

<UserProvider userPromise={userPromise}>
  {children}
</UserProvider>

در کامپوننت کلاینتی:

// app/profile.tsx
const { userPromise } = useUser()
const user = use(userPromise)

این الگو باعث تعلیق کامپوننت و فعال‌سازی hydration جزئی می‌شود.


استفاده از SWR در SPA


با SWR می‌توانید داده را هم در کلاینت و هم در سرور واکشی کنید:

// app/layout.tsx
<SWRConfig value={{ fallback: { '/api/user': getUser() } }}>
  {children}
</SWRConfig>

// app/profile.tsx
const { data, error } = useSWR('/api/user', fetcher)

داده اولیه در HTML prerender می‌شود و سپس توسط SWR خوانده می‌شود.


استفاده از React Query


React Query نیز مانند SWR قابل استفاده در Next.js است و امکان واکشی داده در کلاینت و سرور را فراهم می‌کند.


رندر فقط در مرورگر


برای غیرفعال‌سازی prerender در کامپوننت کلاینتی:

const ClientOnlyComponent = dynamic(() => import('./component'), {
  ssr: false,
})

shallow routing در کلاینت


برای تغییر URL بدون بارگذاری مجدد:

window.history.pushState(null, '', `?sort=asc`)

سپس با useSearchParams مقدار را بخوانید.


استفاده از Server Actions در کلاینت


بدون نیاز به API route، می‌توانید از Server Action استفاده کنید:

// app/button.tsx
import { create } from './actions'

<button onClick={() => create()}>Create</button>

خروجی استاتیک (اختیاری)


Next.js امکان تولید سایت کاملاً استاتیک را نیز فراهم می‌کند که در برخی موارد عملکرد بهتری نسبت به SPA دارد.


جمع‌بندی


Next.js ابزاری قدرتمند برای ساخت SPA است — با رندر کلاینتی، ناوبری سریع، و امکان افزودن تدریجی قابلیت‌های سرور. با استفاده از context، SWR، React Query، و Server Actions می‌توانید اپلیکیشنی پویا، سریع و قابل توسعه بسازید.


Written & researched by Dr. Shahin Siami

Related Articles

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

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

Continue

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

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

Continue

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

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

Continue

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

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

Continue

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

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

Continue

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

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

Continue