نحو 5 دقائق · React 16.8+ · React DOM

ابدأ

من التثبيت إلى الإيماءات وحركة الدخول والخروج في ست خطوات. كل خطوة مكوّن صغير يعمل.

  1. التثبيت

    ليس لـ Animated تبعيات وقت التشغيل. React 16.8+ تبعية نظيرة.

    نقطة دخول الحزمة معلَّمة بـ 'use client'. في App Router في Next.js يمكن لتخطيط الخادم أن يعرض AnimatedProvider؛ واستخدم الخطّافات وAnimated.<tag> داخل Client Components.

    npm install @kkwaenggwari/animated

    يُحَلّ الاستيراد @kkwaenggwari/animated في محرّرك.

  2. حرّك قيمتك الأولى

    يمتلك useAnimatedValue(1) رقمًا حيًا طوال عمر المكوّن. ضعه مباشرة في style: يصبح متغيّر CSS، فلا يعرض React أثناء تغيّره.

    يحرّكه timing(value, { toValue, duration }).start(). والضغط مجددًا في منتصف الطريق يبدأ من الشفافية الحالية.

    جارٍ تجهيز المثال…

    يتلاشى المربع ثم يعود، والضغطة الثانية في المنتصف تعكس الاتجاه من حيث هو.

  3. اشتق مخرجات كثيرة من قيمة واحدة

    يحوّل interpolate القيمة إلى أطوال أو زوايا أو أرقام. من دون easing يصبح calc() دقيقًا للمتغيّر نفسه، فتكلّف خمسة مسارات ما يكلّفه مسار واحد.

    نطاقات إدخال مختلفة للقيمة نفسها تصنع تتابعًا من دون خمس حركات منفصلة.

    جارٍ تجهيز المثال…

    ضغطة واحدة تحرّك خمسة مسارات بتتابع؛ وتغيير الانتشار لا يغيّر إلا النطاقات.

  4. صِف وجهة

    يعرض Animated.button زرًا عاديًا. seed هو الإطار الأول، وpose هو المكان الذي يجب أن يكون فيه الآن، وtempo هو طريقة وصوله.

    حين يتغيّر pose في منتصف الرحلة، يلتف العنصر من حيث هو على الشاشة، محتفظًا بسرعته مع النابض.

    جارٍ تجهيز المثال…

    النقر السريع على البطاقات لا يجعل أيًا منها يقفز أبدًا.

  5. اربط الإدخال

    يكتب input(ref, moveInput(...)) إحداثيات المؤشر في القيم. ويجعل follow(target, source) قيمة تتبع أخرى بنابض.

    كل ما يُعرَّف في دالة مصنع useAnimated يملكه المكوّن: تتوقف المستمعات والنوابض عند الإزالة أو حين تتغيّر تبعية.

    جارٍ تجهيز المثال…

    تميل البطاقة نحو المؤشر وتستقر حين يغادر.

  6. حرّك المغادرة

    إزالة ابن React تزيله عادةً فورًا. يحتفظ Animated.Keep بالأبناء ذوي key حتى تنتهي وضعية depart الخاصة بهم.

    لا يعرض wait الأبناء الجدد إلا بعد انتهاء كل المغادرات.

    جارٍ تجهيز المثال…

    تغادر الرسائل المرفوضة بالحركة المختارة قبل أن تختفي.

بحث

اكتب للبحث في التوثيق.