فصل ۱ — شروع React

React چیست و چطور فکر کنیم؟ قواعد کامل JSX کامپوننت‌های تابعی و ترکیب root، createRoot و StrictMode React Developer Tools و اشکال‌زدایی

فصل ۲ — داده و رویداد

Props: عبور داده به کامپوننت State و رویدادها: قلب تعامل رویدادها در عمق: e، preventDefault و پاس‌دادن آرگومان لیست‌ها، map و انتخاب key درست اعتبارسنجی props با PropTypes و مقدار پیش‌فرض

فصل ۳ — افکت‌ها و API

useEffect: کارهای بیرونی و چرخه زندگی رندر شرطی و استایل‌دهی useEffect در عمق: آرایه وابستگی و رندرهای اضافی گرفتن داده از API: لودینگ، خطا و رقابت درخواست‌ها جستجوی زنده با debounce و AbortController

فصل ۴ — فرم‌ها

فرم‌های کنترل‌شده چند فیلد با یک state و الگوی computed property textarea، select و radio در React submit فرم: ارسال، حالت‌ها و ریست اعتبارسنجی فرم‌ها در React

فصل ۵ — عمق state

آپدیت تابعی setState: setValue(prev => ...) مقداردهی تنبل state و نگه‌داشتن توابع بالابرندن state: اشتراک داده بین کامپوننت‌ها prop drilling: وقتی props از ده لایه عبور می‌کنند کجا state را نگه داریم؟ جای‌گذاری درست داده

فصل ۶ — هوک‌های پیشرفته

useContext: داده سراسری بدون drilling useRef: دسترسی به DOM و مقادیر پایدار useReducer: مدیریت stateهای پیچیده useMemo و useCallback: کش کردن محاسبات و توابع هوک سفارشی: بسته‌بندی منطق قابل استفاده مجدد

فصل ۷ — استایل‌دهی

روش‌های استایل‌دهی در React: نمای کلی CSS Modules: کلاس‌های بدون تداخل styled-components: استایل با CSS-in-JS Tailwind CSS با React تم تاریک با متغیرهای CSS و state

فصل ۸ — React Router

React Router: مسیریابی چندصفحه‌ای Link و NavLink و پارامترهای search مسیرهای داینامیک و useParams useNavigate و مسیرهای محافظت‌شده مسیرهای تودرتو و Outlet

فصل ۹ — الگوهای UI و دسترس‌پذیری

Fragment: گروه‌بندی بدون تگ اضافه Portal: رندر بیرون از درخت والد Error Boundary: مهار خطاهای رندر دسترس‌پذیری در React: label، aria و فوکوس ترکیب به‌جای تکرار: کامپوننت‌های چیدمان و slot

فصل ۱۰ — کارایی و چرخه زندگی

چرخه زندگی کامپوننت در دنیای هوک‌ها چه چیزی باعث رندر دوباره می‌شود؟ memo و جلوگیری از رندر بی‌دلیل Lazy Loading و Suspense چک‌لیست بهینه‌سازی اپ React

فصل ۱۱ — اکوسیستم و پروژه

شروع TypeScript در React تست React با Vitest و Testing Library دیپلوی اپ React: از build تا میزبانی ساختار پوشه و بهترین شیوه‌های پروژه ده اشتباه رایج مبتدی‌ها در React
React Tutorial فصل ۳ — افکت‌ها و API درس آموزشی

جستجوی زنده با debounce و AbortController

جعبه جستجویی که با هر کلید یک درخواست می‌فرستد، سرور را درو می‌کند و نتایج کهنه را می‌آورد. راه‌حل دو ابزار است: debounce یعنی صبر کردن تا کاربر تایپش تمام شود، و AbortController یعنی لغو درخواست قبلی هنگام شروع درخواست جدید. ترکیب این دو، الگوی استاندارد جستجوی زنده است.

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

  1. ۱

    debounce با setTimeout در cleanup

    داخل useEffect برای query یک setTimeout بگذارید و در cleanup آن را پاک کنید: return () => clearTimeout(t); — نتیجه: افکت فقط وقتی اجرا می‌شود که در فاصله زمانی مشخص (مثلاً ۴۰۰ میلی‌ثانیه) query دیگر عوض نشده باشد.

  2. ۲

    لغو درخواست با AbortController

    یک کنترلر بسازید و سیگنالش را به fetch بدهید: const ctrl = new AbortController(); fetch(url, { signal: ctrl.signal }); و در cleanup: ctrl.abort(); — درخواست قبلی با تغییر query واقعاً لغو می‌شود و خطای AbortError را در catch نادیده بگیرید.

  3. ۳

    حداقل طول عبارت

    برای حروف اول جستجو درخواست نفرستید: if (query.trim().length < 2) { setResults([]); return; } — هم ترافیک کم می‌شود، هم نتایج بی‌معنی برای یک حرف نمایش داده نمی‌شود.

نکات مهم

  • ◆ delay حدود ۳۰۰ تا ۵۰۰ میلی‌ثانیه برای تایپ فارسی و انگلیسی حس خوبی می‌دهد.
  • ◆ متن «در حال جستجو…» را جدا از «نتایجی یافت نشد» نشان دهید تا کاربر تفاوت را بفهمد.
  • ◆ خطای abort را با e.name === 'AbortError' چک کنید و به‌عنوان خطای واقعی گزارشش نکنید.

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

function Search() {
  const [query, setQuery] = useState("");
  const [results, setResults] = useState([]);
  const [status, setStatus] = useState("idle");

  useEffect(() => {
    if (query.trim().length < 2) { setResults([]); setStatus("idle"); return; }
    const ctrl = new AbortController();
    setStatus("loading");
    const t = setTimeout(async () => {
      try {
        const res = await fetch(`/api/search?q=${encodeURIComponent(query)}`, { signal: ctrl.signal });
        const json = await res.json();
        setResults(json); setStatus("done");
      } catch (e) {
        if (e.name !== "AbortError") setStatus("error");
      }
    }, 400);
    return () => { clearTimeout(t); ctrl.abort(); };
  }, [query]);

  return (
    <div>
      <input value={query} onChange={e => setQuery(e.target.value)} placeholder="جستجو…" />
      {status === "loading" && <p>در حال جستجو…</p>}
      {status === "done" && results.length === 0 && <p>نتیجه‌ای یافت نشد</p>}
      <ul>{results.map(r => <li key={r.id}>{r.title}</li>)}</ul>
    </div>
  );
}

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

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

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

کپچا

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