فصل ۱ — شروع Vue
Vue چیست و چرا برای پروژههای فارسی محبوب است؟ پروژه با Vite: ساخت، ساختار فایل و اجرافصل ۲ — داده و رندر
ref، reactive و پیوند دوطرفه v-if، v-for و رندر لیستهافصل ۳ — کامپوننتها و پروژه
props، emit و ترکیب کامپوننتها Composables، watch و مدیریت وضعیت مشترک Router، فرمها و انتشار پروژهپروژه عملی پایان دوره
پروژه پایانی — فروشگاه SPA کامل با Vue و Routerپروژه پایانی — فروشگاه SPA کامل با Vue و Router
پروژه پایانی دوره: یک فروشگاه SPA — لیست محصولات با جستجو و فیلتر، صفحه محصول، سبد خرید سراسری با composable، فرم ثبت سفارش با اعتبارسنجی و صفحات با Router — همه در یک پروژه Vite واقعی.
راهحل قدمبهقدم پروژه
-
۱
هدف پروژه
ساخت SPA فروشگاه با Router، وضعیت سبد سراسری، فرم اعتبارسنجیشده و مصرف API محصولات.
-
۲
الزامات و موارد موردنیاز
Node و npm؛ API محصولات از jsonplaceholder یا فایل JSON محلی؛ آشنایی با درسهای دوره.
-
۳
قدم ۱ — پروژه و داده
npm create vue@latest (بدون Router اول، بعد اضافه). فایل src/data/products.json با ۸ محصول (نام، قیمت تومان، دسته، توضیح). composable useProducts که داده را میخواند و loading/error میدهد.
-
۴
قدم ۲ — لیست با فیلتر
صفحه فهرست: جستجو با useDebouncedSearch و فیلتر دسته با select؛ گرید کارتها با ProductCard (props + emit select). حالتهای loading/empty/error هر سه طراحیشده.
-
۵
قدم ۳ — Router و صفحه محصول
Router با / و /products/:id؛ صفحه تکی با جزئیات و دکمه «افزودن به سبد» که useCart را صدا میزند. مسیر ناموجود → پیام و دکمه بازگشت.
-
۶
قدم ۴ — سبد سراسری
useCart singleton با add/remove/total؛ هدر همیشه badge تعداد نشان میدهد. صفحه سبد با ویرایش qty و جمع کل با toLocaleString فارسی.
-
۷
قدم ۵ — فرم ثبت و انتشار
فرم نام/تلفن/آدرس با اعتبارسنجی inline و ذخیره سفارش در localStorage (تا API نداریم). build و دیپلوی dist با fallback nginx؛ تست رفرش روی /products/3.
نکات مهم
- ◆ قبل از خواندن راهحل، خودتان حداقل ۳۰ دقیقه تلاش کنید؛ یادگیری واقعی در همین تلاش اتفاق میافتد.
- ◆ راهحل را بعد از دیدن، عمداً تغییر دهید و دوباره اجرا کنید تا با هر خط آن آشنا شوید.
- ◆ اگر جایی گیر کردید، فقط بخش مشکل را جستجو کنید، نه کل پروژه را — دامنه جستجوی کوچک یادگیری را عمیقتر میکند.
کد کامل راهحل پروژه
// composables/useCart.js (singleton)
import { ref, computed } from "vue";
const items = ref([]);
export function useCart() {
const count = computed(() => items.value.reduce((s, i) => s + i.qty, 0));
const total = computed(() => items.value.reduce((s, i) => s + i.qty * i.price, 0));
function add(p) {
const f = items.value.find((i) => i.id === p.id);
f ? f.qty++ : items.value.push({ ...p, qty: 1 });
}
function remove(id) { items.value = items.value.filter((i) => i.id !== id); }
function setQty(id, qty) {
const f = items.value.find((i) => i.id === id);
if (f) f.qty = Math.max(1, Math.min(10, qty));
}
return { items, count, total, add, remove, setQty };
}
// views/Checkout.vue
<template>
<form @submit.prevent="submit" class="max-w-md mx-auto space-y-4">
<div>
<input v-model.trim="form.name" placeholder="نام و نام خانوادگی" class="w-full border rounded-lg p-2">
<p v-if="errors.name" class="text-xs text-rose-500 mt-1">{{ errors.name }}</p>
</div>
<div>
<input v-model.trim="form.phone" placeholder="موبایل" class="w-full border rounded-lg p-2">
<p v-if="errors.phone" class="text-xs text-rose-500 mt-1">{{ errors.phone }}</p>
</div>
<button class="w-full bg-indigo-600 text-white py-2.5 rounded-lg font-bold">ثبت سفارش</button>
<p v-if="done" class="text-emerald-600 text-sm">سفارش شما ثبت شد — کد: {{ orderId }}</p>
</form>
</template>
<script setup>
import { reactive, ref } from "vue";
import { useCart } from "../composables/useCart";
const { items, total } = useCart();
const form = reactive({ name: "", phone: "" });
const errors = reactive({});
const done = ref(false), orderId = ref("");
function submit() {
errors.name = form.name.length >= 3 ? "" : "نام حداقل ۳ نویسه است";
errors.phone = /^09\d{9}$/.test(form.phone) ? "" : "موبایل با ۰۹ و ۱۱ رقم";
if (errors.name || errors.phone || items.value.length === 0) return;
orderId.value = "ORD-" + Date.now();
const order = { id: orderId.value, items: items.value, total: total.value, ...form, at: new Date().toISOString() };
const prev = JSON.parse(localStorage.getItem("orders") || "[]");
localStorage.setItem("orders", JSON.stringify([...prev, order]));
done.value = true;
}
</script>
اجرای زنده کد JavaScript
کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همینجا رندر میشود؛ مثل آزمایشگاه w3schools.
خروجی مورد انتظار
نتایج مورد انتظار: فهرست محصولات با جستجوی زنده و فیلتر دسته کار میکند. صفحه /products/3 جزئیات را نشان میدهد؛ رفرش هم بدون 404 (با fallback). افزودن به سبد، badge هدر را بروز میکند؛ سبد جمع فارسی درست دارد. فرم با موبایل غلط خطای inline میدهد و سفارش معتبر را در localStorage ثبت میکند.
چالش اضافه (اختیاری)
localStorage را با watch سینک کنید و صفحه «سفارشهای من» با فهرست سفارشهای ذخیرهشده اضافه کنید.
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!