استخدام إيماءات اللمس
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تجربة طريقة ComposeAllowed
Jetpack Compose هي مجموعة أدوات واجهة المستخدم التي ننصح بها لنظام التشغيل Android. تعرَّف على كيفية استخدام اللمس والإدخال في ميزة "إنشاء".
يوضّح هذا المستند طريقة كتابة التطبيقات التي تتيح للمستخدمين التفاعل مع أحد التطبيقات باستخدام إيماءات اللمس. يوفّر Android مجموعة متنوعة من واجهات برمجة التطبيقات لمساعدتك في إنشاء الإيماءات واكتشافها.
على الرغم من أنّ تطبيقك يجب ألا يعتمد على إيماءات اللمس في السلوكيات الأساسية، لأنّ الإيماءات قد لا تكون متاحة لجميع المستخدمين في جميع السياقات، يمكن أن تؤدي إضافة تفاعل يعتمد على اللمس إلى تطبيقك إلى زيادة فائدته وجاذبيته بشكل كبير.
لتوفير تجربة متّسقة وسهلة للمستخدمين، يجب أن يتّبع تطبيقك اصطلاحات Android المقبولة لإيماءات اللمس. توضح لك مستند
إيماءات التصميم المتعدد الأبعاد
كيفية استخدام الإيماءات الشائعة في تطبيقات Android. اطّلِع أيضًا على Material Motion.
للمزيد من المعلومات عن هذا الموضوع، يُرجى قراءة الأدلة التالية ذات الصلة:
المواضيع
-
التعرّف على الإيماءات الشائعة
-
تعرَّف على طريقة رصد إيماءات اللمس الأساسية، مثل التمرير السريع والتنقّل والنقر مرّتين،
باستخدام
GestureDetector.
-
تتبُّع حركات اللمس والمؤشر
-
تعرَّف على كيفية تتبُّع الحركة.
-
إضفاء الحركة على إيماءة الانتقال
-
تعرَّف على طريقة
استخدام أشرطة التمرير،
Scroller
أو
OverScroller،
لإنشاء صورة متحركة قابلة للتمرير استجابةً لحدث لمس.
-
التعامل مع إيماءات اللمس المتعدد
-
تعرَّف على كيفية رصد الإيماءات متعددة المؤشرات (الأصابع).
-
السحب والتعديل
-
تعرَّف على كيفية تنفيذ السحب والتحجيم المستند إلى اللمس.
- إدارة أحداث اللمس في ViewGroup
- تعرَّف على كيفية إدارة أحداث اللمس في
ViewGroup لضمان نقل أحداث اللمس بشكل صحيح إلى طرق العرض المستهدَفة.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Use touch gestures\n\nTry the Compose way \nJetpack Compose is the recommended UI toolkit for Android. Learn how to use touch and input in Compose. \n[Gestures →](/jetpack/compose/touch-input/pointer-input) \n\nThis document describes how to write apps that let users interact with an app using touch\ngestures. Android provides a variety of APIs to help you create and detect gestures.\n\nAlthough your app must not depend on touch gestures for basic behaviors---since the gestures\nmight not be available to all users in all contexts---adding touch-based interaction to your app\ncan greatly increase its usefulness and appeal.\n\nTo provide users with a consistent, intuitive experience, your app must follow the accepted\nAndroid conventions for touch gestures. The\n[Material Design Gestures](https://material.io/design/interaction/gestures.html)\ndocument shows you how to use common gestures in Android apps. Also, see\n[Material Motion](https://material.io/guidelines/motion/material-motion.html).\n\nFor more information about this topic, read the following related guides:\n\n- [Input events overview](/guide/topics/ui/ui-events)\n- [Sensors overview](/guide/topics/sensors/sensors_overview)\n- [Make a custom view\n interactive](/training/custom-views/making-interactive)\n\nTopics\n------\n\n\n**[Detect common gestures](/develop/ui/views/touch-and-input/gestures/detector)**\n:\n Learn how to detect basic touch gestures, such as scrolling, flinging, and double-tapping,\n using\n [GestureDetector](/reference/android/view/GestureDetector).\n\n\n**[Track touch and pointer movements](/develop/ui/views/touch-and-input/gestures/movement)**\n:\n Learn how to track movement.\n\n\n**[Animate a scroll gesture](/develop/ui/views/touch-and-input/gestures/scroll)**\n:\n Learn how to use\n scrollers---[Scroller](/reference/android/widget/Scroller)\n or\n [OverScroller](/reference/android/widget/OverScroller)---to\n produce a scrolling animation in response to a touch event.\n\n\n**[Handle multi-touch gestures](/develop/ui/views/touch-and-input/gestures/multi)**\n:\n Learn how to detect multi-pointer (finger) gestures.\n\n\n**[Drag and scale](/develop/ui/views/touch-and-input/gestures/scale)**\n:\n Learn how to implement touch-based dragging and scaling.\n\n**[Manage touch events in a ViewGroup](/develop/ui/views/touch-and-input/gestures/viewgroup)**\n: Learn how to manage touch events in a\n [ViewGroup](/reference/android/view/ViewGroup) to ensure that\n touch events are correctly dispatched to their target views."]]
