هوک‌های سفارشی در React – ساخت useStorageState برای همگام‌سازی وضعیت با localStorage

در React، هوک‌های useState و useEffect برای مدیریت وضعیت و ساید افکت‌ها بسیار کاربردی هستند. این مقاله نحوهٔ ساخت یک هوک سفارشی به نام useStorageState را آموزش می‌دهد که وضعیت کامپوننت را با localStorage مرورگر همگام می‌کند. همچنین با اصول نام‌گذاری، بازگشت آرایه‌ای، و قابلیت استفاده مجدد در هوک‌های سفارشی آشنا می‌شویم.

custom hookuseStorageStatelocalStoragestate synchronization

~2 دقیقه مطالعه · آخرین به‌روزرسانی ۳۰ مهر ۱۴۰۴

مقدمه


در React، هوک‌های useState و useEffect برای مدیریت داده‌های پویا و ساید افکت‌ها استفاده می‌شوند. اما گاهی نیاز داریم منطق پیچیده‌تری را در قالب یک هوک سفارشی استخراج کنیم تا قابل استفاده مجدد و قابل نگهداری باشد.


ساخت هوک useStorageState


هدف این هوک سفارشی، همگام‌سازی وضعیت کامپوننت با localStorage مرورگر است. استفاده از آن مانند useState خواهد بود:


const [searchTerm, setSearchTerm] = useStorageState('search', 'React');

درون هوک، از useState برای مقداردهی اولیه و از useEffect برای ذخیره‌سازی مقدار جدید استفاده می‌کنیم:


const useStorageState = (key, initialState) => {
  const [value, setValue] = React.useState(
    localStorage.getItem(key) || initialState
  );

  React.useEffect(() => {
    localStorage.setItem(key, value);
  }, [value, key]);

  return [value, setValue];
};

اصول طراحی هوک سفارشی


  • نام هوک باید با use شروع شود.
  • مقدار بازگشتی معمولاً یک آرایه شامل مقدار فعلی و تابع به‌روزرسانی است.
  • هوک باید قابل استفاده مجدد و مستقل از دامنه خاص باشد.
  • پارامتر key باید یکتا باشد تا از تداخل در localStorage جلوگیری شود.

مزایای استفاده از هوک سفارشی


  • جدا کردن منطق پیچیده از کامپوننت‌ها
  • قابلیت استفاده مجدد در چند کامپوننت
  • ترکیب چند هوک داخلی یا سفارشی
  • امکان انتشار به‌عنوان کتابخانه خارجی

جمع‌بندی


هوک‌های سفارشی در React ابزاری قدرتمند برای مدیریت منطق مشترک و پیچیده هستند. با ساخت هوک useStorageState، توانستیم وضعیت کامپوننت را با localStorage همگام کنیم و کد را خواناتر و قابل نگهداری‌تر کنیم. این تکنیک‌ها پایه‌ای برای توسعه حرفه‌ای با React هستند.


نوشته و پژوهش‌شده توسط دکتر شاهین صیامی

مقالات مرتبط

فرم‌ها در React – ارسال داده با onSubmit و action در فرم‌های جستجو

فرم‌ها بخش جدایی‌ناپذیر هر اپلیکیشن مدرن هستند. در این مقاله، نحوهٔ ساخت فرم جستجو در React را بررسی می‌کنیم. ابتدا از onSubmit برای مدیریت ارسال فرم استفاده می‌کنیم و سپس با معرفی ویژگی action، فرم را به رفتار بومی HTML نزدیک‌تر می‌کنیم. این ساختار باعث افزایش خوانایی، قابلیت استفاده با صفحه‌کلید، و آمادگی برای نسخه‌های آیندهٔ React می‌شود.

ادامه

کتابخانه‌های شخص ثالث در React – استفاده از axios و async/await برای دریافت داده‌ها

در این مقاله، نحوهٔ جایگزینی fetch با کتابخانهٔ axios برای دریافت داده‌ها از API در React را بررسی می‌کنیم. سپس با استفاده از async/await و بلوک try/catch، کد دریافت داده‌ها را خواناتر و قابل مدیریت‌تر می‌کنیم. این روش‌ها باعث افزایش سازگاری با مرورگرهای قدیمی، بهبود تست‌پذیری، و کاهش پیچیدگی کد می‌شوند.

ادامه

دریافت صریح داده‌ها در React – کنترل درخواست‌های API با دکمه تأیید

در پیاده‌سازی اولیه، هر بار که کاربر در فیلد جستجو تایپ می‌کرد، درخواست جدیدی به API ارسال می‌شد. این مقاله نحوهٔ تغییر این رفتار به دریافت صریح داده‌ها را آموزش می‌دهد؛ به‌طوری‌که فقط با کلیک روی دکمهٔ تأیید، درخواست به API ارسال شود. با تعریف دو وضعیت مجزا برای searchTerm و url، و استفاده از useCallback و useEffect، کنترل کامل بر زمان ارسال درخواست فراهم می‌شود.

ادامه

وضعیت‌های غیرممکن در React – مدیریت پیش‌بینی‌پذیر وضعیت با useReducer

استفاده هم‌زمان از چند useState برای مدیریت وضعیت‌های مرتبط می‌تواند منجر به وضعیت‌های غیرممکن و باگ‌های پنهان شود. این مقاله نشان می‌دهد چگونه با ترکیب وضعیت‌های مرتبط در یک useReducer واحد، می‌توان از بروز چنین مشکلاتی جلوگیری کرد. با تعریف یک ساختار وضعیت پیچیده شامل داده، بارگذاری و خطا، و استفاده از اکشن‌های مشخص، مدیریت وضعیت در React پیش‌بینی‌پذیرتر و قابل اطمینان‌تر می‌شود.

ادامه

مدیریت پیشرفته وضعیت در React – استفاده از useReducer برای انتقال‌های پیچیده

در حالی که useState برای مدیریت وضعیت‌های ساده مناسب است، هوک useReducer در React راه‌حلی مقیاس‌پذیر برای مدیریت وضعیت‌های پیچیده و وابسته ارائه می‌دهد. این مقاله نحوهٔ مهاجرت وضعیت لیست داستان‌ها از useState به useReducer را بررسی می‌کند، و نشان می‌دهد چگونه با تعریف اکشن‌هایی مانند SET_STORIES و REMOVE_STORY می‌توان منطق وضعیت را به‌صورت متمرکز و خوانا مدیریت کرد.

ادامه

رندر شرطی در React – نمایش وضعیت بارگذاری و خطا هنگام دریافت داده‌های غیرهمزمان

در React، رندر شرطی ابزاری قدرتمند برای کنترل نمایش رابط کاربری بر اساس وضعیت‌های مختلف است. این مقاله نحوهٔ نمایش پیام «در حال بارگذاری…» هنگام دریافت داده‌های غیرهمزمان، و پیام خطا در صورت شکست دریافت داده را بررسی می‌کند. با استفاده از useState و useEffect، وضعیت‌های isLoading و isError را مدیریت کرده و با استفاده از عملگرهای منطقی و ternary، رندر شرطی را پیاده‌سازی می‌کنیم.

ادامه