مطوّر React مبتدئ؟ 4 طرق لمنح مشروعك مظهرًا أكثر احترافية وتأثيرًا
تعلّم كيف تحسّن تجربة التطوير لديك، وتجعل شيفرتك أسهل صيانةً وأبسط في العمل المشترك عليها مع الآخرين.
تابع القراءة إن أردتَ أن:
- ترفع تجربة التطوير لديك بشكل كبير،
- تجعل شيفرتك أسهل صيانةً وأبسط في العمل المشترك عليها مع الآخرين،
- تبهر المهندسين المسؤولين عن التوظيف بالمشاريع الموجودة على GitHub،
لأن هذه المقالة كُتبت من أجلك!
1. استخدم Volta
هل تبدو لك أي من هذه المواقف مألوفة؟
- تستنسخ مستودعًا جديدًا وتشغّل npm install أو yarn، فتمتلئ الطرفية برسائل أخطاء غامضة – ثم تكتشف لاحقًا في ملف readme أن التطبيق يعمل فقط مع إصدارات Node من 13.9.0 إلى 14.4.0.
- في مرحلة ما أثناء انضمامك إلى الفريق، يذكر زميل عرَضًا «بالمناسبة، البناء يحتاج إلى Node 12».
- كلما أخبرك أحدهم أنه لا يستطيع تشغيل مشروعك، يكون سؤالك الأول دائمًا «ما إصدارا Node وnpm لديك حاليًا؟».
- تعمل على عدة مشاريع بالتوازي، ويحتاج كل منها إلى إصدارات مختلفة من أدوات معينة.
Volta يحل كل هذه المشكلات، ويفعل ذلك بشكل رائع. وهذا كل ما تحتاجه للبدء.
- ثبّته باستخدام
curl https://get.volta.sh | bashأو، على Windows، اتبع التعليمات الموجودة على موقعهم. - في المجلد الجذر لمشروعك، شغّل الأمر
volta pinلتثبيت إصدارات أدوات محددة في package.json. فمثلًا، بعد تشغيل هذه الأوامر:
volta pin node@12.20
volta pin yarn@1.19
سيحصل ملف package.json لديك على الأسطر التالية:
"volta": {
"node": "12.20.2",
"yarn": "1.19.2"
}
وبذلك، فإن أي شخص لديه Volta مثبّت ويشغّل أمرًا يعتمد على Node أو Yarn سيحصل تلقائيًا على الإصدارات نفسها تمامًا. وإذا كانت هذه الإصدارات مفقودة، يثبّتها Volta أولًا ثم ينفّذ الأمر.
ما يميز Volta هو سهولة استخدامه الفائقة – فبمجرد أن تعتمده، ستتساءل كيف كنتَ تتدبر أمرك بدونه.
2. استخدم Storybook
لا أستطيع أن أتخيل العمل بكفاءة على أي شيء أكبر من تطبيق قائمة مهام بدون Storybook.
بجدية. صحيح أنني، مثل معظمنا، عملتُ على مشاريع كبيرة بدونه في الماضي، لكن منذ أن بدأتُ إدخال Storybook في سير عملي ارتفعت إنتاجيتي كثيرًا. أتذكر مثلًا أنني لبناء مكوّن صغير كان عليّ التنقل داخل التطبيق حتى شاشة معينة فقط ليظهر. وإذا تسببت تعديلاتي في إعادة تحميل التطبيق، كان عليّ البحث عن المكوّن من جديد.
يلاحظ بعض المطورين ذلك أيضًا، فينتهي بهم الأمر إلى بناء صفحة فرعية من نوع /playground تعرض كل المكونات النقية لتسهيل التطوير والاختبار البصري. وهذا هو Storybook تقريبًا – لكن بإمكانات أقل بكثير!
مع Storybook، تكتب ملفات *.stories.tsx بجوار مكوناتك، وتعرض فيها تلك المكونات بخصائص (props) مختلفة بحيث تظهر حالاتها المختلفة جنبًا إلى جنب. ولأن ملفات القصص تستورد مكوناتك، فإن كل تغيير تجريه ينعكس في Storybook في الوقت الفعلي.
وجود Storybook في مشروعك يدفعك نحو التطوير القائم على المكونات – أي بناء واجهة المستخدم بالبدء بمكونات أساسية نقية ثم دمجها في شاشات أكبر.
وكما هي الحال مع الدوال النقية، تتمتع المكونات النقية بثلاث خصائص جوهرية:
- اختبارها أسهل. لأن المكونات النقية لا آثار جانبية لها، يمكنك اختبارها بشكل حتمي ببساطة عبر تزويدها بمجموعات مختلفة من الخصائص والتحقق من أنها تعرض المخرجات المتوقعة. لا حاجة إلى محاكاة طلبات الشبكة أو اعتراضها.
- إعادة استخدامها أسهل. لأن المكونات النقية لا تعتمد على أي حالة خفية، ينبغي أن تستطيع وضعها في عروض مختلفة من تطبيقك، أو حتى إعادة استخدامها في مشاريع أخرى، وأن تعمل ببساطة.
- تركيبها معًا أسهل. بدلًا من بناء كل شاشة أو عرض أو تخطيط بكتابة CSS لكل عنصر من الصفر في كل مرة، يمكنك تجميع شاشتك ببساطة بوضع مكونات نقية في حاوية وضبط التخطيط بخصائص تنسيق خاصة بذلك التركيب. ولا تضطر إلى إنشاء عدد كبير من المكونات «لمرة واحدة» مثل
TrendingPostsBottomButtonالتي لا يمكن إعادة استخدامها أبدًا بسبب تنسيقها الداخلي شديد التخصيص.
هذا مجرد جزء يسير من نموذج التطوير القائم على المكونات المذكور أعلاه. وإذا أردتَ أن تتطور كمهندس واجهات وتجنّب الكثير من الإحباط الناتج عن أنظمة التصميم سيئة التصميم، فأنصحك بإلقاء نظرة على هذه المواقع:
- https://www.componentdriven.org/
- منهجية atomic web design
- https://storybook.js.org/tutorials/intro-to-storybook/
3. ضع منطق العمل في خطافات (hooks) مخصصة
لنفترض أننا نبني شاشة يجب أن تعرض للمستخدم كل المنشورات المتاحة في مدونتنا. بعد أن أنجزنا واجبنا من القسم السابق، أصبحت مكوناتنا النقية – PostsStast وPost – مكتوبة ومختبرة في Storybook. وكل ما ينقصنا مكوّن يجلب بيانات المنشورات ويمررها إلى أبنائه.
إليك ما قد نتوصل إليه:
export const AllPosts = () => {
const [posts, setPosts] = useState<null | PostData[]>(null);
const [postsCount, setPostsCount] = useState(-1);
const [viewedPostsIds, setViewedPostsIds] = useState<number[]>([]);
const [isError, setIsError] = useState(false);
useEffect(() => {
fetch("http://localhost:1337/posts")
.then((res) => res.json())
.then((data) => setPosts(data))
.catch(() => setIsError(true));
}, []);
useEffect(() => {
fetch("http://localhost:1337/posts/count")
.then((res) => res.json())
.then((data) => setPostsCount(data))
.catch(() => setIsError(true));
}, []);
if (isError) {
return <div>Error...</div>;
}
if (postsCount === -1 || !posts) {
return <div>Loading...</div>;
}
const transformedPosts = posts.map((post) => ({
...post,
isViewed: viewedPostsIds.includes(post.id),
}));
return (
<div>
<h1>All Posts</h1>
<PostsStats postsCount={postsCount} />
{transformedPosts.map((post) => (
<Post
key={post.id}
post={post}
isViewed={post.isViewed}
onClick={() =>
setViewedPostsIds((posts) => {
if (posts.includes(post.id)) {
return posts;
}
return [...posts, post.id];
})
}
/>
))}
</div>
);
};
يتولى هذا المكوّن… الكثير فعلًا.
أولًا، ينشئ 4 أجزاء منفصلة من الحالة، يعتمد بعضها على بعض.
ثم نجلب البيانات، ولأنه يجب استدعاء نقطتي نهاية، نحتاج إلى useEffects اثنين.
بعد ذلك نجري بعض الفحوصات لنقرر هل تُعرض حالة خطأ أم حالة تحميل.
وبعد أن تُحمَّل البيانات بنجاح، لا يزال علينا دمج البيانات الخارجية مع حالتنا المحلية التي تتتبع المقالات التي نُقر عليها.
وعندها فقط يمكننا عرض الشاشة بالبيانات الصحيحة.
وللإنصاف، هذا المثال ليس سيئًا إلى ذلك الحد. المشكلة أنك إذا واصلت البرمجة بهذه الطريقة، فستحصل على مكونات تتجاوز 300 سطر من الشيفرة قبل أن تصل حتى إلى عبارة return. مكونات كهذه يصعب قراءتها وصيانتها، ويمكن أن تُخفي بسهولة حالات تسابق (race conditions) بين قيم الحالة والتأثيرات المختلفة.
كيف تتجنب ذلك؟ انظر:
export const AllPosts = () => {
const { posts, postsCount, isLoading, isError, view } = usePosts();
if (isLoading) {
return <div>Loading...</div>;
}
if (isError) {
return <div>Error...</div>;
}
return (
<div>
<h1>All Posts</h1>
<PostsStats postsCount={postsCount} />
{posts.map((post) => (
<Post
key={post.id}
post={post}
isViewed={post.isViewed}
onClick={() => view(post.id)}
/>
))}
</div>
);
};
لهذا النهج فوائد عدة:
- يستطيع أي شخص أن يعرف فورًا ما الغرض من المكوّن.
- ما دامت واجهته البرمجية ثابتة، يمكننا إعادة هيكلة
usePostsالمخصص وتحسينه واختباره دون المساس بهذا المكوّن أو أي مكوّن آخر يستخدمه. - تجعل الأعلام
isLoadingوisErrorمن السهل تحديد الواجهة التي تُعرض. - هل يطلب منك متطلب عمل جديد عرض المنشورات في مكان آخر من التطبيق؟ لا مشكلة! كل المنطق موجود بشكل مرتب داخل الخطاف
usePosts. - كما أن الخطافات المخصصة تتركّب معًا بشكل جيد جدًا. هل تحتاج إلى عرض المنشورات التي شوهدت فقط؟ اكتب ببساطة
useViewedPostsالذي يستدعيusePostsداخليًا ويعيد النتائج المصفّاة.
للحصول على دليل معمّق حول كتابة الخطافات المخصصة، راجع وثائق React الرسمية (النسخة التجريبية).
4. اكتب شيفرة بسيطة
هذه النصيحة الأخيرة هي على الأرجح الأهم، وهي أيضًا الأصعب إتقانًا.
افترض أن عليك جلب بعض البيانات وعرضها للمستخدم في جدول. لا حاجة إلى بناء تجريد غامض موجّه للكائنات مثقل بالشيفرة التمهيدية لعملية الجلب، ثم تكديس طبقة تجريد أخرى فوقه لتتمكن من استخدامه في مكوّن React الوظيفي. يمكنك ببساطة استخدام خطاف react-query لجلب البيانات وتحويلها إلى جدول داخل مكوّنك. يبقى كل شيء في مكوّن واحد، دون تجريدات غامضة أو طبقات وسيطة.
تأتي الشيفرة البسيطة من مزيج من اختيار أسماء متغيرات دقيقة، وتصميم واجهات برمجية معقولة لدوالك، وكتابة شيفرة نظيفة، واختيار الأدوات المناسبة للمهمة.
طرق لتحسين مهارتك في ذلك:
- اكتب الكثير من الشيفرة. نفّذ الشيء نفسه مرة أخرى بمكتبات أو أنماط أو معماريات مختلفة. هكذا تتعلم أي النهج يناسب أي المشكلات أكثر.
- اقضِ وقتًا في قراءة الشيفرة والتفكير هل كان يمكن بناء مقطع أو دالة أو حتى ميزة كاملة بطريقة أبسط.
- تابع (إلى حد ما على الأقل) مجتمعات البرمجة التي يتشارك فيها الناس معارفهم ومكتبات وتقنيات قد لا تكون سمعت بها. من الأمثلة مجتمعات Reddit البرمجية مثل r/react وr/typescript، أو متابعة أشخاص مثل Matt Pocock وJosh W. Comeau، أو أنا :)
شكرًا لقراءتك 😊. هل كانت إحدى هذه النصائح مفيدة لك بشكل خاص؟ أو ربما تودّ إضافة شيء؟ لا تتردد في ترك تعليق أو إرسال بريد إلكتروني إلينا.