Vue Tutorial فصل ۳ — کامپوننت‌ها و پروژه درس آموزشی

Composables، watch و مدیریت وضعیت مشترک

Composable تابعی است که منطق واکنش‌گرا را بسته‌بندی می‌کند (useFetch، useCart) و بین کامپوننت‌ها استفاده مجدد می‌شود — جایگزین mixin قدیمی. watch واکنش به تغییر داده است (لاگ، ذخیره، فراخوانی API) و برای وضعیت سراسری، Pinia یا composable تکی با ref ماژول‌سطحی.

مراحل قدم‌به‌قدم

  1. ۱

    composable بنویسید

    فایل useCounter.js: export function useCounter() { const n = ref(0); return { n, inc: () => n.value++ }; } — در هر کامپوننت const { n, inc } = useCounter(). استایل script setup تمیز می‌ماند و منطق تست‌پذیر می‌شود.

  2. ۲

    watch — واکنش به تغییر

    watch(query, (v) => search(v)) هر تغییر جستجو را می‌فرستد؛ watch با { debounce } دستی (setTimeout) یا کتابخانه، سرچ زنده‌ی تمیز می‌سازد. watchEffect خودکار همه وابستگی‌ها را می‌بیند؛ برای منطق کوچک.

  3. ۳

    وضعیت مشترک — Pinia یا singleton

    defineStore در Pinia: state، getters، actions با devtools و ماژول‌بندی. ساده‌تر: composable با ref ماژول‌سطحی — چون ماژول یک‌بار import می‌شود، همه کامپوننت‌ها همان ref را می‌بینند. برای پروژه‌های کوچک همین کافی است.

  4. ۴

    onMounted/onUnmounted و پاک‌سازی

    چرخه حیات: onMounted برای fetch و لیسنر، onUnmounted برای پاک‌سازی (interval، event listener). composable‌های با لیسنر، خودشان add/remove را می‌بندند — قاعده: هر چیز اضافه‌شده، جایی پاک می‌شود.

نکات مهم

  • ◆ منطق تکرارشونده را composable کنید؛ کپی‌پی در کامپوننت‌ها بدبو است.
  • ◆ لیسنر و interval در onUnmounted پاک می‌شوند — نشتی حافظه فرانت واقعی است.
  • ◆ برای وضعیت سراسری کوچک، ref ماژول‌سطحی؛ برای بزرگ، Pinia.

کد یا مسیر نمونه

// composables/useCart.js — وضعیت مشترک با singleton ref
import { ref, computed } from "vue";
const items = ref([]);

export function useCart() {
  const total = computed(() => items.value.reduce((s, i) => s + i.price * i.qty, 0));
  function add(product) {
    const found = items.value.find((i) => i.id === product.id);
    if (found) found.qty++;
    else items.value.push({ ...product, qty: 1 });
  }
  function remove(id) {
    items.value = items.value.filter((i) => i.id !== id);
  }
  return { items, total, add, remove };
}

// composables/useDebouncedSearch.js
import { ref, watch } from "vue";
export function useDebouncedSearch(delay = 300) {
  const query = ref(""), results = ref([]), loading = ref(false);
  let timer = null;
  watch(query, (q) => {
    clearTimeout(timer);
    timer = setTimeout(async () => {
      loading.value = true;
      try { results.value = await fetch(`/api/search?q=${encodeURIComponent(q)}`).then((r) => r.json()); }
      finally { loading.value = false; }
    }, delay);
  });
  return { query, results, loading };
}

اجرای زنده کد JavaScript

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.