0Pricing
TypeScript Academy · درس

أنماط تحديد أنواع مخازن Zustand

عرّفوا مخازن Zustand محددة الأنواع باستخدام الواجهات والإجراءات

أنماط تحديد أنواع مخازن Zustand درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

لماذا نُنمّط Zustand؟

Zustand مكتبة مصغّرة لإدارة الحالة. ومع التكامل الصحيح مع TypeScript، تحصلون على قراءة آمنة من ناحية الأنواع للمخزن وإجراءاته ومحدداته، من دون تعليمات برمجية زائدة.

import { create } from "zustand";

مخزن مُنمّط أساسي

عرّفوا واجهة المخزن ومرّروها كمعامل عام إلى create.

interface CounterStore {
  count: number;
  increment: () => void;
  decrement: () => void;
}

const useCounter = create<CounterStore>((set) => ({
  count: 0,
  increment: () => set((s) => ({ count: s.count + 1 })),
  decrement: () => set((s) => ({ count: s.count - 1 })),
}));

قراءة حالة المخزن

استخدموا الخطاف مع محدد لقراءة أجزاء محددة من الحالة. يستنتج TypeScript نوع الإرجاع من المحدد.

function Counter() {
  const count = useCounter((s) => s.count);       // number
  const increment = useCounter((s) => s.increment); // () => void
  return <button onClick={increment}>{count}</button>;
}

فصل الحالة عن الإجراءات

يفصل نمط شائع خصائص الحالة عن أساليب الإجراءات في الواجهة، مما يجعل التنظيم أوضح.

interface State { count: number; }
interface Actions { increment: () => void; reset: () => void; }
type CounterStore = State & Actions;

الإجراءات غير المتزامنة في Zustand

يدعم Zustand الإجراءات غير المتزامنة أصلًا؛ ما عليكم سوى جعل دالة الإجراء غير متزامنة داخل المُنشئ.

interface UserStore {
  users: User[];
  fetchUsers: () => Promise<void>;
}

const useUserStore = create<UserStore>((set) => ({
  users: [],
  fetchUsers: async () => {
    const data = await api.getUsers();
    set({ users: data });
  },
}));

تنميط برمجية immer الوسيطة

استخدموا برمجية immer الوسيطة في Zustand لإجراء تحديثات بأسلوب قابل للتعديل. وينتقل نوع المخزن بصورة صحيحة.

import { immer } from "zustand/middleware/immer";

const useStore = create<CounterStore>()(
  immer((set) => ({
    count: 0,
    increment: () => set((state) => { state.count++; }),
  }))
);

برمجية devtools الوسيطة

اجمعوا devtools مع التنميط الصحيح لتفعيل دعم Redux DevTools مع الحفاظ على سلامة الأنواع.

import { devtools } from "zustand/middleware";

const useStore = create<CounterStore>()(
  devtools(
    (set) => ({ count: 0, increment: () => set({ count: 1 }) }),
    { name: "CounterStore" }
  )
);

تنميط المخزن المستمر

تُسلسل برمجية persist الوسيطة الحالة في localStorage. نمّطوها بشكل صحيح باستخدام واجهة الحالة الجزئية.

import { persist } from "zustand/middleware";

const useStore = create<CounterStore>()(
  persist(
    (set) => ({ count: 0, increment: () => set((s) => ({ count: s.count + 1 })) }),
    { name: "counter-storage" }
  )
);

نمط الأجزاء المُنمّطة

بالنسبة إلى المخازن الكبيرة، قسّموها إلى أجزاء مُنمّطة تُجمع في استدعاء create واحد.

type UserSlice = { users: User[]; setUsers: (u: User[]) => void; };
type UiSlice = { modal: boolean; openModal: () => void; };
type AppStore = UserSlice & UiSlice;

الاشتراك خارج React

يمكنكم الوصول إلى حالة المخزن والاشتراك في التغييرات خارج مكوّنات React باستخدام واجهة برمجة التطبيقات المُنمّطة للمخزن.

// Access current state outside React
const count = useCounter.getState().count;

// Subscribe to changes
useCounter.subscribe((state) => console.log(state.count));

مراجعة: تنميط Zustand

تنميط Zustand: عرّفوا واجهة للمخزن، ومرّروها إلى create، واستخدموا المحددات لقراءة الحالة بأمان من ناحية الأنواع، وأضيفوا البرمجيات الوسيطة (immer وdevtools وpersist) عبر النمط ذي الاستدعاء المتسلسل لضمان انتقال الأنواع بشكل صحيح.

تحقق سريع

كيف تقرؤون جزءًا محددًا من حالة Zustand داخل مكوّن من دون إعادة التصيير عند حدوث تغييرات لا تخصه؟

ما تعلمتموه

تُنمّط مخازن Zustand بتمرير معامل عام يمثل الواجهة إلى create. استخدموا دوال المحددات لقراءة الحالة بكفاءة وأمان من ناحية الأنواع. واجمعوا البرمجيات الوسيطة مثل immer وdevtools وpersist عبر نمط Zustand ذي الاستدعاء المتسلسل لضمان استنتاج TypeScript للأنواع بشكل صحيح.

الأسئلة الشائعة

هل درس «أنماط تحديد أنواع مخازن Zustand» مجاني؟

نعم — نص درس «أنماط تحديد أنواع مخازن Zustand» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

ماذا ستتعلم في «أنماط تحديد أنواع مخازن Zustand»؟

عرّفوا مخازن Zustand محددة الأنواع باستخدام الواجهات والإجراءات تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟

لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «أنماط تحديد أنواع مخازن Zustand»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟

نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. تحديد أنواع شرائح Redux Toolkit وThunks
  2. أنماط تحديد أنواع مخازن Zustand
  3. ‏XState: آلات حالات محددة الأنواع
  4. الحالة المشتقة والمنتقون مع الأنواع
← العودة إلى TypeScript Academy