<On Scroll>
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُحدِّد هذه السياسة الإجراء الذي سيتم تنفيذه عندما يمرِّر المستخدم سريعًا على التنسيق. تبلغ سرعة
يتأثر تسلسل الحركة وحركة العرض المستهدف
سرعة التمرير واتجاهه، وفقًا للحدود التي تحدّدها باستخدام خيار
المعلَمات.
يمكن أن يكون هناك عدة عُقد <OnSwipe> في <Transition> واحد، مع كل عُقدة.
<OnSwipe> تحدِّد اتجاه التمرير سريعًا مختلفًا وإجراءًا مختلفًا
تنفيذها عند قيام المستخدم بالتمرير السريع.
بناء الجملة
<OnSwipe
motion:touchAnchorId="@id/target_view"
motion:touchAnchorSide="side"
[ motion:dragDirection="direction" ]
[ motion:dragScale="scale" ]
[ motion:maxVelocity="maxVelocity" ]
[ motion:maxAcceleration="maxAcceleration" ]
/>
السمات
motion:touchAnchorId- العرض الذي يتم نقله بالتمرير السريع
motion:touchAnchorSide- جانب العرض المستهدَف الذي ترتبط به التمرير السريع يحتفظ
MotionLayout
مسافة ثابتة بين علامة الارتساء وإصبع المستخدم. القيم المقبولة
"left" و"right" و"top" و"bottom".
motion:dragDirection- اتجاه حركة التمرير السريع للمستخدم. إذا تم تعيين هذه السمة، فإن هذه السمة
لا ينطبق
<OnSwipe> إلا على التمريرات السريعة في الاتجاه المحدّد. القيم المقبولة
"dragLeft" و"dragRight" و"dragUp" و"dragDown".
motion:dragScaleيتحكّم هذا الإعداد في المسافة التي تنتقل إليها طريقة العرض نسبةً إلى طول التمرير السريع. تشير رسالة الأشكال البيانية
القيمة الافتراضية هي 1، مما يشير إلى أن طريقة العرض تتحرك بقدر ما تتحرك التمرير السريع.
إذا كانت قيمة dragScale أقل من 1، ستتحرك طريقة العرض أقل من مسافة التمرير السريع.
على سبيل المثال، تعني dragScale بقيمة 0.5 أنّه إذا تحركت التمريرة السريعة لمسافة 4 سم، سيتم
نسبة العرض المستهدَف تتحرك 2 سم.
إذا كانت قيمة dragScale أكبر من 1، سيتم تحريك العرض بعيدًا عن التمرير السريع.
المسافة. على سبيل المثال، تعني القيمة dragScale للرقم 1.5 أنّه إذا تحريك التمرير السريع الرقم 4، يجب
، تتحرك الرؤية المستهدفة 6 سم.
motion:maxVelocityالسرعة القصوى للعرض المستهدَف.
motion:maxAccelerationالحد الأقصى لتسريع العرض المستهدَف.
موجود في
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# <OnSwipe>\n\nSpecifies the action to perform when the user swipes on the layout. The speed of\nthe motion sequence and the motion of the targeted view are affected by the\nspeed and direction of the swipe, subject to the limits you set with optional\nparameters.\n\nThere can be multiple `\u003cOnSwipe\u003e` nodes for a single `\u003cTransition\u003e`, with each\n`\u003cOnSwipe\u003e` specifying a different swipe direction and a different action to\nperform when the user performs that swipe.\n\nSyntax\n------\n\n```xml\n\u003cOnSwipe\n motion:touchAnchorId=\"@id/target_view\"\n motion:touchAnchorSide=\"side\"\n[ motion:dragDirection=\"direction\" ]\n[ motion:dragScale=\"scale\" ]\n[ motion:maxVelocity=\"maxVelocity\" ]\n[ motion:maxAcceleration=\"maxAcceleration\" ]\n /\u003e\n```\n\nAttributes\n----------\n\n`motion:touchAnchorId`\n: View that is being moved by the swipe.\n\n`motion:touchAnchorSide`\n: Side of the target view that the swipe is anchored to. `MotionLayout` keeps a\n constant distance between the anchor and the user's finger. Acceptable values\n are `\"left\"`, `\"right\"`, `\"top\"`, and `\"bottom\"`.\n\n`motion:dragDirection`\n: Direction of the user's swipe motion. If this attribute is set, this\n `\u003cOnSwipe\u003e` only applies to swipes in the specified direction. Acceptable values\n are `\"dragLeft\"`, `\"dragRight\"`, `\"dragUp\"`, and `\"dragDown\"`.\n\n`motion:dragScale`\n\n: Controls the distance the view moves relative to the length of the swipe. The\n default value is 1, indicating that the view moves as far as the swipe does.\n If `dragScale` is less than 1, the view moves less than the swipe distance.\n For example, a `dragScale` of 0.5 means that if the swipe moves 4 cm, the\n target view moves 2 cm.\n\n If `dragScale` is greater than 1, the view moves farther than the swipe\n distance. For example, a `dragScale` of 1.5 means that if the swipe moves 4\n cm, the target view moves 6 cm.\n\n`motion:maxVelocity`\n\n: Maximum velocity of the target view.\n\n`motion:maxAcceleration`\n\n: Maximum acceleration of the target view.\n\nContained in\n------------\n\n- [`\u003cTransition\u003e`](/training/constraint-layout/motionlayout/ref/transition)"]]
