تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يستخدم نظام الألوان Expressive في Wear Material 3 ثلاث طبقات تمييز
(أساسية وثانوية وثالثية) للمكونات الرئيسية وطبقتَي سطح متعافِلَين. يقدّم كل دور مجموعة من القيم ذات التباين المتّسق، ما يتيح استخدام مجموعات ألوان معبّرة وسهلة الاستخدام لتوفير تجربة موحّدة في أي موضوع.
مثال على نسق ألوان يتضمّن أدوارًا
ما هي أدوار الألوان؟
تشبه أدوار الألوان "الأرقام" في لوحة الطلاء حسب الأرقام. وهي تشكل
الرابط بين عناصر واجهة المستخدم والألوان التي تُستخدم في كل عنصر.
ربط أدوار الألوان بمكونات Material: ستستخدم أدوار
الألوان هذه سواء كنت تستخدم مخطّط الألوان الأساسي الثابت أو اللون الديناميكي. إذا كان
منتجك يحتوي على مكونات مخصّصة، يجب ربطها بشكلٍ سليم
بهذه المجموعة من أدوار الألوان.
أدوار الألوان توفّر سهولة الاستخدام: يستند نظام الألوان إلى مجموعات ألوان مناسبة لمزيد من المستخدمين. توفّر أزواج الألوان هذه نسبة تباين ألوان تبلغ 3:1 على الأقل.
تجزئة أدوار الألوان: يتم تنفيذ الأدوار في التصميم والرمز البرمجي
من خلال الرموز المميّزة. يمثّل رمز التصميم قرار تصميم صغيرًا قابلاً لإعادة الاستخدام
ويكون جزءًا من النمط المرئي لنظام التصميم.
العبارات الأساسية
في ما يلي المصطلحات الرئيسية التي ستظهر في أسماء أدوار الألوان:
السطح: دور يُستخدَم للخلفيات والمساحات الكبيرة ذات الأهمية المنخفضة
في الشاشة.
الأساسي والثانوي والثالثي: أدوار ألوان التركيز المستخدَمة لإبراز عناصر المقدّمة أو
تقليل تركيزها
الحاوية: الأدوار المستخدَمة كملون تعبئة لعناصر المقدّمة، مثل
الأزرار ولا يجب استخدامها للنص أو الرموز.
تفعيل: تشير الأدوار التي تبدأ بهذا المصطلح إلى لون للنص أو الرموز فوق لون العنصر الرئيسي المرتبط. على سبيل المثال، يتم استخدام اللون الأساسي للنص والرمزين بجانب لون التعبئة الأساسي.
الصيغة: تقدّم الأدوار التي تنتهي بهذه العبارة بديلاً أقلّ تركيزًا مقارنةً بمثيلها غير الصيغة. على سبيل المثال، يمثّل خيار المخطط التفصيلي بديلاً أقل وضوحًا
من لون المخطط.
الأدوار الأساسية
تُستخدَم الأدوار الأساسية للمكونات الرئيسية في واجهة المستخدم، مثل الأزرار التي تلتصق بالجانب
والأزرار البارزة والحالات النشطة والأيقونات في أنماط buttons
التونية.
أساسي
Primary
المرحلة الابتدائية
استخدِم الدور "أساسي" للإجراءات الأكثر أهمية في واجهة المستخدم، مثل buttons أو عبارات الحثّ على اتخاذ إجراء الأساسيين. يجب أن يكون هذا اللون بارزًا وقابلاً للتمّييز
على الفور لتوجيه المستخدِم نحو التفاعلات الرئيسية.
Primary-Dim
Primary-Dim
المرحلة الابتدائية
يتم استخدام الأدوار المموّهة عادةً للعناصر التي يجب أن تكون مختلفة بشكلٍ مرئي عن
الإجراء الأساسي، ولكنّها لا تتطلّب انتباه المستخدم أو تفاعله الفوري.
Primary-Container
Primary-Container
On-Primary-Container
يمكنك تطبيق "الحاوية الأساسية" على عناصر الخلفية، مثل البطاقات أو النوافذ المنبثقة، لشدّد الضوء على الأقسام أو الحالات المحدّدة. ويساعد ذلك في جذب الانتباه إلى المحتوى العميق أو الأنشطة الجارية ضمن واجهة المستخدم.
الأدوار الثانوية
تُستخدَم الأدوار الثانوية للمكونات الرئيسية في واجهة المستخدم، وهي ليست مهمة
بقدر الدور الأساسي، ولكن يجب أن تكون بارزة. يمكن استخدام العناصر الأساسية
والثانوية معًا في التنسيقات لإنشاء فرق بين العناصر والتركيز عليها.
ثانوي
ثانوي
مرحلة التعليم الثانوي
استخدِم الدور الثانوي لدعم الإجراءات في المناطق التي تتضمّن واجهة مستخدم كثيفة، مثل
الأزرار الثانوية أو الإجراءات التكميلية. ويحافظ على مستوى الرؤية بدون
تسليط الضوء على العناصر الأساسية في التنسيقات المعقّدة.
Secondary-Dim
السمة الثانوية
ثانوي
يقدّم دور "الإضاءة الثانوية" تباينًا منخفضًا للعناصر غير النشطة في مناطق كثيفة. ويكمل اللون الثانوي مع إضافة عمق خفيف، ما يحافظ على اتّساق واجهة المستخدِم ويساعد المستخدمين في التنقّل.
الحاوية الثانوية
Secondary-Container
On-Secondary-Container
طبِّق Secondary-Container لتنظيم العناصر الثانوية في التنسيقات الكثيفة. ويؤدي ذلك إلى
إنشاء بنية وفصل، ما يضمن تمييز المحتوى الثانوي ولكنه لا يضمن أن يكون مهيمنًا.
الأدوار الثانوية
تُستخدَم الأدوار الثانوية للتأكيد على العناصر من خلال استخدام ألوان متناقضة لموازنة الألوان الأساسية والثانوية، أو لجذب الانتباه إلى عنصر معيّن، مثل حقل إدخال.
يمكن أن تساعد الأدوار الثانوية أيضًا في الإشارة إلى الحالات التي يتغيّر فيها المحتوى أو التي يجب أن يبرز فيها،
مثل تحقيق هدف معيّن.
المستوى الثالث
Tertiary
On-Tertiary
يُستخدَم الدور الثانوي للفت الانتباه إلى العناصر الرئيسية. تكون الأدوار الثانوية
فعّالة بشكل خاص للمكونات التي يجب أن تبرز، مثل
الشارات أو الملصقات أو عناصر الإجراءات الخاصة.
Tertiary-Dim
Tertiary-Dim
Tertiary
استخدِم دور "التعتيم الثانوي" للزرّات أو الإجراءات المرتبطة بإجراءات
ثانوية، ولكنّها لا تتطلّب التركيز الفوري.
الحاوية الثانوية
حاوية تابعة
On-Tertiary-Container
طبِّق العنصر "حاوية ثانوية" على الخلفيات التي تُجمِّع المحتوى الثانوي،
مثل مجموعات الشارات أو الملصقات. ويُبرز العناصر الثانوية مع
الحفاظ على التوازن والبنية في واجهة المستخدم.
الأدوار الدلالية
يتم استخدام الخط الأحمر للإشارة إلى المشاكل الخطيرة، مثل الخطأ أو الحذف أو أي شيء مرتبط بالطوارئ. تم تصميمه لجذب الانتباه الفوري إلى المشاكل أو التحذيرات، ما يضمن للمستخدمين إمكانية تحديد الجوانب التي تحتاج إلى إجراء تصحيحي بسرعة.
يجب أن تحافظ درجة لون الخطأ الأحمر على تباين كافٍ مع الخلفيات لتلبية معايير تسهيل الاستخدام، ما يضمن ظهوره بوضوح وتمييزه عن ألوان الحالات الأخرى، مثل التحذيرات أو رسائل النجاح.
خطأ
خطأ
عند حدوث خطأ
لون أحمر دلالي، مع تلوّن طفيف بالموضوع، يشير إلى إجراءات الإزالة أو الحذف أو الإغلاق
أو الإغلاق، مثل التمرير السريع للكشف. تمت إضافته كبديل للحاويات
وهو أقل قلقًا وأقل إلحاحًا من اللون المنخفض لدرجة الخطأ.
Error-Dim
Error-Dim
عند حدوث خطأ
لون أحمر دلالي، مع تلوّن طفيف بالموضوع، يشير إلى الأخطاء ذات الأولوية العالية
أو إجراءات الطوارئ، مثل تنبيهات السلامة أو نوافذ الحوار التي تشير إلى تعذُّر إكمال الإجراءات أو أزرار التوقف
Error-Container
Error-Container
On-Error-Container
لون حاوية أقل بروزًا للمكوّنات التي تستخدم حالة الخطأ يمكن أن يشير أيضًا
إلى حالة خطأ نشطة تبدو أقل تفاعلية من الحالة الممتلئة،
مثل زر أو بطاقة مشاركة حالة الطوارئ النشطة، أو في مربّع حوار شاشة مثبّتة
تعذّر عرضها.
الحاويات السطحية والارتفاع
إنّ حاويات السطح هي مفتاح تحديد العمق والارتفاع في واجهة المستخدم،
وتوفّر بنية وتسلسلاً هرميًا من خلال اللون، ما يساعد في التمييز بين
المكوّنات استنادًا إلى أهميتها وتفاعلها.
Surface-Container-Low
سطح الحاوية - منخفض
على السطح
On-Surface-Variant
مثالية لحاوية موسّعة يجب أن تكون أسفل الحاوية المعروضة، مثل
بطاقة موسّعة في الإشعار. يمكن أيضًا استخدامها في
البطاقات غير التفاعلية، حيث يظل المحتوى يستفيد من الحصر.
الحاوية السطحية
سطح الحاوية
على السطح
On-Surface-Variant
لون الحاوية التلقائي لمعظم العناصر. يوفّر هذا المظهر مرتفعًا معتدلاً ومتوسطًا، ما يجعله مناسبًا لمكونات واجهة المستخدم العامة.
Surface-Container-High
سطح الحاوية-عالي
على السطح
On-Surface-Variant
مثالية للمكونات التي تُركّز على العناصر التي يجب وضعها فوق "حاوية السطح" أو معًا
معها. يساعد هذا اللون في التركيز على
المناطق المهمة في واجهة المستخدم وتحديد تسلسلها الهرمي.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ 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,["# Color roles and tokens\n\nThe Wear Material 3 Expressive color system employs three accent layers\n(primary, secondary, tertiary) for key components and two neutral surface\nlayers. Each role offers a range of values with consistent contrast, enabling\nexpressive yet accessible color combinations for a unified experience across any\ntheme.\nAn example of a color theme with roles.\n\nWhat are color roles?\n---------------------\n\nColor roles are like the \"numbers\" in a paint-by-number canvas. They're the\nconnective tissue between elements of the UI and what color goes where.\n\n- **Color roles are mapped to Material components:** You'll use these color roles whether you're using the static baseline scheme or dynamic color. If your product contains custom components, they'll need to be properly mapped to this set of color roles.\n- **Color roles support accessibility:** The color system is built on more accessible color pairings. These color pairs provide a minimum of 3:1 color contrast.\n- **Color roles are tokenized:** Roles are implemented in design and code through tokens. A design token represents a small, reusable design decision that's part of a design system's visual style.\n\nEssential terms\n---------------\n\nHere are key terms you'll see in the names of color roles:\n\n- **Surface:** A role used for backgrounds and large, low-emphasis areas of the screen.\n- **Primary, Secondary, Tertiary:** Accent color roles used to emphasize or de-emphasize foreground elements.\n- **Container:** Roles used as a fill color for foreground elements like buttons. They shouldn't be used for text or icons.\n- **On:** Roles starting with this term indicate a color for text or icons on top of its paired parent color. For example, on primary is used for text and icons against the primary fill color.\n- **Variant:** Roles ending with this term offer a lower-emphasis alternative to its non-variant pair. For example, outline variant is a less emphasized version of the outline color.\n\nPrimary roles\n-------------\n\n\nPrimary roles are used for key components across the UI, such as the Edge\nHugging buttons, prominent buttons, active states, and icons on the tonal button\nstyles. \n\n\u003cbr /\u003e\n\n\n**Primary**\n\n1. Primary\n2. On-Primary\n\nUse the Primary role for the most important actions in the UI, like primary\nbuttons or calls to action. This color should stand out and be instantly\nrecognizable to guide the user toward key interactions. \n\n**Primary-Dim**\n\n1. Primary-Dim\n2. On-Primary\n\nDim roles are typically used for elements that need to be visually distinct from\nthe primary action but don't require immediate user attention or interaction. \n\n**Primary-Container**\n\n1. Primary-Container\n2. On-Primary-Container\n\nApply Primary Container for background elements like cards or modals to\nhighlight sections or selected states. It helps draw attention to important\ncontent or ongoing activities within the UI.\n\n\u003cbr /\u003e\n\nSecondary roles\n---------------\n\n\nSecondary roles are used for key components across the UI, which are not as\nimportant as the primary role, but still need to stand out. Primary and\nsecondary can be used together in layouts to create differentiation and focus. \n\n\u003cbr /\u003e\n\n\n**Secondary**\n\n1. Secondary\n2. On-Secondary\n\nUse the Secondary role for supporting actions in areas with dense UI, such as\nsecondary buttons or complementary actions. It maintains visibility without\novershadowing primary elements in complex layouts. \n\n**Secondary-Dim**\n\n1. Secondary-Dim\n2. Secondary\n\nThe Secondary-Dim role offers a muted contrast for passive elements in dense\nareas. It complements the secondary color while adding subtle depth, keeping the\nUI clean and helping users navigate. \n\n**Secondary-Container**\n\n1. Secondary-Container\n2. On-Secondary-Container\n\nApply Secondary-Container for organizing secondary elements in dense layouts. It\ncreates structure and separation, ensuring secondary content is distinguishable\nbut not dominant.\n\n\u003cbr /\u003e\n\nTertiary roles\n--------------\n\n\nTertiary roles are used for contrasting accents to balance primary and secondary\ncolors or bring heightened attention to an element such as an input field.\nTertiary roles can also help indicate when content changes or should stand out,\nsuch as a goal being reached. \n\n\u003cbr /\u003e\n\n\n**Tertiary**\n\n1. Tertiary\n2. On-Tertiary\n\nThe Tertiary role is used for drawing attention to key elements. Tertiary roles\nare particularly effective for components that need to stand out, such as\nbadges, stickers, or special action elements. \n\n**Tertiary-Dim**\n\n1. Tertiary-Dim\n2. Tertiary\n\nUse the Tertiary Dim role for buttons or actions that are related to tertiary\nactions yet don't require immediate focus. \n\n**Tertiary-Container**\n\n1. Tertiary-Container\n2. On-Tertiary-Container\n\nApply Tertiary-Container for backgrounds that group tertiary-related content,\nlike collections of badges or stickers. It emphasizes tertiary elements while\nmaintaining balance and structure in the UI.\n\n\u003cbr /\u003e\n\nSemantic roles\n--------------\n\n\nError-Red is used to indicate critical issues as error, delete, and anything\nrelated to emergency. It is designed to draw immediate attention to problems or\nwarnings, ensuring users can quickly identify areas that need corrective action.\nThe tone of Error-Red should maintain sufficient contrast against backgrounds to\nmeet accessibility standards, ensuring it is clearly visible and is\ndistinguishable from other status colors like warnings or success messages. \n\n\u003cbr /\u003e\n\n\n**Error**\n\n1. Error\n2. On-Error\n\nA semantic, yet slightly theme-tinted red, which indicates remove, delete, close\nor dismiss actions, such as Swipe to Reveal. Added as a container alternative\nthat is slightly less alarming and urgent than the error-dim color. \n\n**Error-Dim**\n\n1. Error-Dim\n2. On-Error\n\nA semantic, yet slightly theme-tinted red, which indicates high priority errors\nor emergency actions, such as safety alerts, failed dialog overlays or stop\nbuttons. \n\n**Error-Container**\n\n1. Error-Container\n2. On-Error-Container\n\nLess prominent container color, for components using the error state. Can also\nindicate an active error state which feels less interactive than a filled state,\nsuch as an active emergency sharing button or card, or on a failed overlay\ndialog.\n\n\u003cbr /\u003e\n\nSurface containers and elevation\n--------------------------------\n\n\nSurface containers are key in defining depth and elevation within the UI,\nproviding structure and hierarchy through color, helping to differentiate\ncomponents based on their importance and interaction. \n\n\u003cbr /\u003e\n\n\n**Surface-Container-Low**\n\n1. Surface-Container-Low\n2. On-Surface\n3. On-Surface-Variant\n\nGreat for an expanded container that needs to sit below Surface-Container, such\nas an expanded card in the Notification. Can also be used for non-interactive\ncards, where content still benefits from containment. \n\n**Surface-Container**\n\n1. Surface-Container\n2. On-Surface\n3. On-Surface-Variant\n\nThe default container color for most elements. It provides a neutral, moderate\nelevation, making it suitable for general UI components. \n\n**Surface-Container-High**\n\n1. Surface-Container-High\n2. On-Surface\n3. On-Surface-Variant\n\nIdeal for high-emphasis components that need to sit on top of, or in combination\nwith Surface-Container. This color helps bring focus and hierarchy to critical\nareas in the UI.\n\n\u003cbr /\u003e"]]