عن المشروع

React Native Vector Icons هي مكتبة JavaScript/TypeScript لإضافة أيقونات متجهة قائمة على الخطوط إلى تطبيقات React Native. البنية الحالية تستخدم حزمًا منفصلة لكل مجموعة أيقونات بدلاً من الحزمة الواحدة القديمة، مع توفير وثائق ترحيل للمشاريع القائمة. تتضمن مجموعات مُدارة بنشاط مثل AntDesign وFeather وFontAwesome Free وFoundation وIonicons وMaterial Design Icons وOcticons وLucide. تتوفر مجموعات إضافية رغم أن مشاريعها الأصلية لم تعد مُدارة، بما في ذلك Entypo وEvilIcons وإصدارات FontAwesome الأقدم وFontisto وMaterial Icons وSimpleLineIcons وZocial. يمكن أيضًا نشر حزم أيقونات تابعة لجهات خارجية واكتشافها عبر NPM. مكوّن Icon الرئيسي يغلّف مكوّن Text الخاص بـ React Native ويقبل خصائص اسم الأيقونة والحجم واللون بالإضافة إلى خصائص نمط النص المعتادة مثل الهوامش والحشو والحدود ونصف قطر الحدود ولون الخلفية وحجم الخط. يمكن وضع الأيقونات داخل Text للاستخدام المضمّن. تدعم المكتبة أيضًا خطوطًا متعددة الأنماط ويمكن تحريكها باستخدام Animated API أو react-native-animatable. للمكونات التي تتطلب صورًا نقطية، يمكن تحويل الأيقونات بشكل متزامن أو غير متزامن إلى كائنات ImageResult تحتوي على URI والأبعاد والمقياس لاستخدامها كمصادر صور. هذه الميزة متاحة عبر دعم خطوط Expo أو حزمة get-image المخصصة. يمكن للمطورين تعريف مجموعات أيقونات مخصصة باستخدام createIconSet وخريطة رموز، أو تجميع خطوط TTF الخاصة بهم، أو استخدام مولّد المشروع لإنشاء حزمة خطوط قابلة لإعادة الاستخدام. يتم توثيق سير عمل Fontello وIcomoon، ويمكن تخصيص دليل الخطوط عبر إعدادات package.json. يمكن تضمين الخطوط في وقت البناء باستخدام استيراد ثابت أو تحميلها ديناميكيًا في وقت التشغيل، مع أدلة إعداد لـ Expo وReact Native والويب. يتضمن المستودع أيضًا مثال IconExplorer وإرشادات محاكاة Jest. المكتبة مرخصة بموجب MIT، بينما تحتفظ الخطوط المرفقة بتراخيصها الخاصة، عادةً MIT أو SIL OFL.