react-native-spotlight-tour

react-native-spotlight-tour هي مكتبة React Native لإنشاء جولات منتج إرشادية وعروض تعريفية باستخدام تأثير الإبراز. وهي متوافقة مع Android وiOS والويب، وتستخدم Floating UI لتحديد موضع محتوى التلميحات حول العناصر المبرزة. يعرّف المطورون خطوات الجولة كمصفوفة TourStep ويغلّفون محتوى التطبيق داخل SpotlightTourProvider. يربط مكوّن AttachStep عناصر واجهة المستخدم بفهارس الخطوات، بينما يكشف الخطاف useSpotlightTour عن عناصر تحكم مثل البدء والإيقاف والانتقال إلى الخطوة التالية والعودة إلى الخطوة السابقة. يمكن تكوين برمجيات Floating UI الوسيطة، بما في ذلك offset وshift وflip، عالميًا للجولة أو تجاوزها في خطوات فردية. تدعم المكتبة تخصيص لون وشفافية الطبقة العلوية، وحركة الإبراز مثل الارتداد والتلاشي والانزلاق، وسلوك الضغط على الخلفية. يوفر مكوّن TourBox المدمج حاوية تلميحات قابلة للتكوين مع عنوان وتسميات تنقل وخيارات تنسيق. يمكن للخطوات أيضًا تنفيذ إجراء قبل العرض واستخدام دوال عرض مخصصة بالكامل. يتوفر التثبيت عبر npm أو yarn. المتطلبات الموثقة هي React 16.8.0 أو أحدث، وReact Native 0.50.0 أو أحدث، وreact-native-svg 12.1.0 أو أحدث. أعاد الإصدار 3 تسمية الحزمة من @stackbuilders/react-native-spotlight-tour إلى react-native-spotlight-tour واستبدل خصائص تحديد الموضع الأقدم بتكوين Floating UI. المشروع مرخص بموجب MIT ويتضمن توثيق API وتطبيقًا نموذجيًا.