تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
حاوِل أن تجعل تطبيق Android الخاص بك سهل الاستخدام للجميع، بما في ذلك الأشخاص الذين لديهم
احتياجات سهولة الوصول.
الأشخاص الذين يعانون من ضعف البصر أو عمى الألوان أو ضعف السمع أو ضعف
إلى جانب عجز في مهاراتهم اليدوية، والإعاقات الإدراكية، والعديد من حالات العجز الأخرى التي يستخدمون Android
الأجهزة. عند تطوير التطبيقات باستخدام
إمكانية الوصول في الاعتبار، فإنك تجعل تجربة المستخدم أفضل للأشخاص الذين يعانون من
احتياجات سهولة الوصول.
تقدم هذه الصفحة إرشادات لتنفيذ العناصر الرئيسية لإمكانية الوصول
حتى يتمكّن الجميع من استخدام تطبيقك بسهولة أكبر للحصول على إرشادات أكثر تفصيلاً حول
كيفية تسهيل الوصول إلى تطبيقك، يُرجى الاطّلاع على مبادئ تحسين التطبيق
سهولة الاستخدام.
زيادة مستوى رؤية النص
لكل مجموعة من النصوص داخل تطبيقك، ننصح باستخدام تباين الألوان أو
الاختلاف في السطوع المُلاحظ بين لون النص واللون
الخلفية خلف النص - ليكون أعلى من حد معين. تشير رسالة الأشكال البيانية
يعتمد الحد الدقيق على حجم خط النص وما إذا كان النص سيظهر
غامق:
إذا كان النص أصغر من 18 نقطة، أو إذا كان النص غامقًا وأصغر من
14 نقطة، اضبط نسبة تباين الألوان على 4.5:1 على الأقل.
بالنسبة إلى كل النصوص الأخرى، اضبط نسبة تباين الألوان على 3:1 على الأقل.
توضح الصورة التالية مثالين لتباين الألوان من النص إلى الخلفية:
الشكل 1. أقل من اللون المقترَح (اليسار) واللون الكافي (اليمين)
والتباين.
للتحقق من تباين الألوان بين النص والخلفية في تطبيقك، استخدم لونًا على الإنترنت
وأداة التحقق من التباين أو أدوات تسهيل الاستخدام
ماسح ضوئي
التطبيق.
استخدام عناصر تحكّم كبيرة وبسيطة
ستكون واجهة المستخدم في تطبيقك أسهل في الاستخدام إذا كانت عناصر التحكم فيه أسهل من حيث الرؤية.
وانقر. لذا ننصح بأن يحتوي كل عنصر تفاعلي من عناصر واجهة المستخدم على منطقة يمكن التركيز عليها، أو
حجم ناحية اللمس المستهدفة، لا يقلّ عن 48dpx48dp كلما زاد حجم الشاشة، كان ذلك أفضل.
لكي يكون لعنصر واجهة المستخدم بحجم كبير يكفي لمساحات اللمس، يجب اتّباع الخطوات التالية:
يجب أن يكون كلا الشرطين صحيحين:
لكل عنصر من عناصر واجهة المستخدم في تطبيقك، ضمِّن وصفًا
يصف الغرض من العنصر. في معظم الحالات، تقوم بتضمين هذا الوصف في
سمة contentDescription للعنصر، كما هو موضح في الرمز التالي
snippet:
عند إضافة أوصاف إلى عناصر واجهة المستخدم في تطبيقك، يجب إبقاء ما يلي على أفضل وجه
الممارسات في الاعتبار:
لا تضمِّن نوع عنصر واجهة المستخدم في وصف المحتوى. الشاشة
القرّاء تلقائيًا عن نوع العنصر ووصفه. بالنسبة
على سبيل المثال، إذا أدى تحديد زر إلى ظهور الزر "submit" إجراء ما في تطبيقك،
جعل وصف الزر "Submit"، وليس "Submit button".
يجب أن يكون كل وصف فريدًا. بهذه الطريقة، عندما يفكر مستخدمو قارئ الشاشة
وصف عنصر متكرر، يدرك بشكل صحيح أن
يكون التركيز على عنصر كان قد تم التركيز عليه بالفعل. على وجه الخصوص، يأتي كل عنصر
ضمن مجموعة عرض، مثل
يجب أن يكون لدى RecyclerView
وصف مختلف. يجب أن يعكس كل وصف المحتوى الذي ينفرد به
إلى عنصر معين، مثل اسم مدينة في قائمة من المواقع.
إذا كانت قيمة minSdkVersion في تطبيقك تبلغ 16 أو أعلى، يمكنك ضبط
android:importantForAccessibility
إلى "no" للعناصر الرسومية التي تُستخدم فقط لأغراض الزخرفية
التأثير.
مصادر إضافية
لمزيد من المعلومات عن كيفية تسهيل استخدام تطبيقك، اطّلِع على ما يلي:
موارد إضافية وهي:
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Make apps more accessible\n\nTry to make your Android app usable for everyone, including people with\naccessibility needs.\n\nPeople with impaired vision, color blindness, impaired hearing, impaired\ndexterity, cognitive disabilities, and many other disabilities use Android\ndevices. When you develop apps with\naccessibility in mind, you make the user experience better for people with\naccessibility needs.\n\nThis page presents guidelines for implementing key elements of accessibility\nso that everyone can use your app more easily. For more in-depth guidance on\nhow to make your app more accessible, see [Principles for improving app\naccessibility](/guide/topics/ui/accessibility/principles).\n\nIncrease text visibility\n------------------------\n\nFor each set of text within your app, we recommend the *color contrast*---or\ndifference in perceived brightness between the color of the text and the color\nof the background behind the text---to be above a specific threshold. The\nexact threshold depends on the text's font size and whether the text appears in\nbold:\n\n- If the text is smaller than 18pt, or if the text is bold and smaller than 14pt, set the color contrast ratio to at least 4.5:1.\n- For all other text, set the color contrast ratio to at least 3:1.\n\nThe following image shows two examples of text-to-background color contrast: \n**Figure 1.** Lower than recommended (left) and sufficient (right) color contrast.\n\nTo check the text-to-background color contrast in your app, use an online color\ncontrast checker or the [Accessibility\nScanner](https://play.google.com/store/apps/details?id=com.google.android.apps.accessibility.auditor)\napp.\n\nUse large, simple controls\n--------------------------\n\nYour app's UI is easier to use if its controls are easier to see\nand tap. We recommend that each interactive UI element have a focusable area, or\n*touch target size*, of at least 48dpx48dp. Larger is even better.\n\nFor a given UI element to have a large enough touch target size, the following\nconditions should **both** be true:\n\n- The sum of the values of [`android:paddingLeft`](/reference/android/view/View#attr_android:paddingLeft), [`android:minWidth`](/reference/android/view/View#attr_android:minWidth), and [`android:paddingRight`](/reference/android/view/View#attr_android:paddingRight) is greater than or equal to 48dp.\n- The sum of the values of [`android:paddingTop`](/reference/android/view/View#attr_android:paddingTop), [`android:minHeight`](/reference/android/view/View#attr_android:minHeight), and [`android:paddingBottom`](/reference/android/view/View#attr_android:paddingBottom) is greater than or equal to 48dp.\n\nThe padding values allow an object's *visible* size to be less than 48dpx48dp\nwhile still having the recommended touch target size.\n\nThe following code snippet shows an element that has the recommended touch\ntarget size: \n\n```xml\n\u003cImageButton ...\n android:paddingLeft=\"4dp\"\n android:minWidth=\"40dp\"\n android:paddingRight=\"4dp\"\n\n android:paddingTop=\"8dp\"\n android:minHeight=\"32dp\"\n android:paddingBottom=\"8dp\" /\u003e\n```\n\nDescribe each UI element\n------------------------\n\nFor each UI element in your app, include a description that\ndescribes the element's purpose. In most cases, you include this description in\nthe element's `contentDescription` attribute, as shown in the following code\nsnippet: \n\n```xml\n\u003c!-- Use string resources for easier localization. --\u003e\n\u003c!-- The en-US value for the following string is \"Inspect\". --\u003e\n\u003cImageView\n ...\n android:contentDescription=\"@string/inspect\" /\u003e\n```\n| **Note:** Don't provide descriptions for [`TextView`](/reference/android/widget/TextView) elements. Android accessibility services automatically announce the text itself as the description.\n\nWhen adding descriptions to your app's UI elements, keep the following best\npractices in mind:\n\n- Don't include the type of UI element in the content description. Screen\n readers automatically announce both the element's type and description. For\n example, if selecting a button causes a \"submit\" action to occur in your app,\n make the button's description `\"Submit\"`, not `\"Submit button\"`.\n\n- Each description must be unique. That way, when screen reader users\n encounter a repeated element description, they correctly recognize that the\n focus is on an element that already had focus earlier. In particular, each item\n within a view group such as\n [`RecyclerView`](/reference/androidx/recyclerview/widget/RecyclerView) must have\n a different description. Each description must reflect the content that's unique\n to a given item, such as the name of a city in a list of locations.\n\n- If your app's `minSdkVersion` is `16` or higher, you can set the\n [`android:importantForAccessibility`](/reference/android/view/View#attr_android:importantForAccessibility)\n attribute to `\"no\"` for graphical elements that are only used for decorative\n effect.\n\nAdditional resources\n--------------------\n\nTo learn more about making your app more accessible, see the following\nadditional resources:\n\n### Codelabs\n\n- [Starting Android\n Accessibility](https://codelabs.developers.google.com/codelabs/starting-android-accessibility)\n\n### Blog posts\n\n- [Accessibility: Are You Serving All Your\n Users?](https://android-developers.googleblog.com/2012/04/accessibility-are-you-serving-all-your.html)"]]