خصائص مكوّن Figma

يتعرف Relay على خصائص مكونات Figma المحددة على المكونات المغلفة. من الناحية النظرية، تتشابه خصائص مكون Figma مع معلمات الإرسال، على الرغم من وجود بعض الاختلافات.

مخطط - طبقات المتجه إلى VectorDrawable إلى صورة

بشكل عام، لا تتطلب خصائص مكونات Figma توفر المكون الإضافي Relay للتكوين والاستخدام، لذلك يُفضل استخدامها في معلمات الإرسال عندما يكون هناك تداخل. ومع ذلك، لاحظ أن معلمات Relay تسمح بتعليق وصفي، والذي يتم نقله إلى التعليمات البرمجية التي تم إنشاؤها؛ وخصائص مكونات Figma لا تفعل ذلك.

انظر أدناه للاطّلاع على مزيد من التفاصيل حول أنواع خصائص المكوّنات المختلفة وكيفية تفسير ميزة "الإرسال" لها.

الخصائص المنطقية

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

يراعي Relay المَعلمات المنطقية في المكوّنات المجمَّعة، وينشئ توقيع الدالة @Composable المناسب.

خصائص النص

تتشابه خصائص النص تقريبًا مع معلمات المحتوى النصي للإرسال؛ والفرق الوحيد هو دعم تعليقات الوثائق. إذا تم تعريف كل من معلمات الإرسال وخصائص النص في نفس الطبقة، يستخدم Relay تعريف المعلمة للسماح بالتعليقات. ومع ذلك، يجب توخي الحذر في هذه الحالة لتجنب الالتباس باستخدام تسمية متسقة.

إذا لم تكن التعليقات مطلوبة لمعلمة معينة، فإننا نوصي باستخدام خاصية نصية Figma للتبسيط.

خصائص تبديل المثيل

تسمح خصائص تبديل المثيل لعملاء أحد المكوّنات بتبديل المثيلات داخل عنصر تابع. من الناحية النظرية، يتشابه هذا مع معلمات Relay الثانوية، ولكن هناك بعض الاختلافات المهمة:

قابلية التطبيق: لا يمكن تطبيق خصائص تبديل المثيل إلا على طبقات النسخة الافتراضية. ومع ذلك، يمكن تطبيق معلمات ترحيل العناصر الثانوية على المثيلات أو الإطارات أو المجموعات. ونتيجة لذلك، يتطلب استخدام خصائص تبديل المثيل أن يكون المحتوى الذي تم تبديله مكونًا في حد ذاته، في حين يسمح Relay للمحتوى بأن يكون أي تسلسل هرمي فرعي للطبقات.

تحديد النطاق: لا يمكن تحديد قيم خصائص تبديل المثيل إلّا في مكوّن المستوى الأعلى في تدرج هرمي للمكوِّن. وعلى النقيض من ذلك، يتم تعيين معلمات الترحيل الثانوية على أي مستوى في التسلسل الهرمي لا تظهر فيه المعلمة بالمستوى الأصلي.

يتعرّف Relay على خصائص تبديل المثيل المُعلَن عنها في المكونات المجمّعة، ويتعامل معها قدر الإمكان بطريقة مماثلة للمعلَمات الثانوية (على سبيل المثال، إصدار توقيع الدالة نفسه في الرمز الذي تم إنشاؤه). إذا تم تعريف معلَمة Relay الثانوية في طبقة المثيل، تكون الأولوية لتعريفها على خاصية تبديل المثيل (إن توفَّرت) المُعلَن عنها في هذه الطبقة.

كما هو الحال مع الخصائص النصية، يمكن أن يتسبب استخدام كل من خاصية مكون Figma ومعلمة Relay على نفس الطبقة في حدوث ارتباك إذا كان التسمية غير متسق. ومع ذلك، نظرًا لأن المعلَمات الثانوية لها فروق كبيرة في إمكانية مثيل خاصية التبديل، فليس لدينا اقتراح عام حول استخدامات هذه السمات وأين يمكن استخدامها. كلاهما احتمالات. سيفيد الاستخدام المقصود للمكون في هذا القرار.

خصائص خيار المنتج

يتم إنشاء سمات خيار المنتج بشكل ضمني عندما تحتوي المكوّنات على أكثر من صيغة واحدة. يدعم Relay خصائص الصيغ من خلال ترجمتها إلى قيم التعداد في الرمز الذي تم إنشاؤه.

يمكن للمصممين أيضًا الإعلان عن مَعلمات الإرسال التي تعرض خصائص المتغيّر لطبقات مثيل في مكوِّن مجمّع.