ربط عنصر تحكم مخصص بحقل

الهدف

استبدل المحرر الأصلي لحقل في نموذج مدفوع بالنموذج بعنصر تحكم مخصص مسجَّل، بحيث يعرض ذلك الحقل قيمته ويحرّرها عبر عنصر التحكم.

المتطلبات المسبقة

• أنت مسجّل الدخول بصفة مصمم يملك صلاحية تعديل الحل الذي ينتمي إليه النموذج.
• الحقل الذي تريد استخدام عنصر التحكم عليه موجود بالفعل في الكيان ومُدرَج في النموذج.
• عنصر التحكم المخصص مسجَّل ومثبَّت في البيئة التي تحرّرها (راجع تسجيل عنصر تحكم مخصص)، وقائمة «بديل عن» الخاصة به تتضمن نوع عنصر تحكم هذا الحقل.

الخطوات

1. افتح الحل، واختر الجداول، وافتح الجدول، واختر النماذج. افتح النموذج في مصمم النماذج.
2. اسحب الحقل من الحقول المتاحة إلى قسم، أو اختره إن كان على النموذج من قبل.
3. في الخصائص، افتح عنصر تحكم مخصص. تعرض القائمة عناصر التحكم المخصصة المثبتة في هذه البيئة التي يمكنها أن تحل محل نوع بيانات هذا الحقل (عنصر التحكم الذي يعلن النوع العام Custom يُعرض لأي حقل). بلا يُبقي محرر الحقل نفسه. أما إعداد عنصر التحكم فوقه فيختار بين المحررات المدمجة، وعنصر التحكم المخصص يحل محل المحرر الذي يحدده.
4. اختر عنصر التحكم، مثلًا Badge field.
5. اختر حفظ.

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

ما الذي يحدث خلف الكواليس

يسجّل النموذج الاسم المنطقي لعنصر التحكم مقابل ذلك الحقل. وعندما يفتح مستخدم النموذج في مشغّل التطبيقات المدفوعة بالنموذج، يحلّ المشغّل عنصر تحكم الحقل إلى عنصر التحكم المثبَّت في البيئة ويركّبه محل المحرر الأصلي، محمّلًا إياه كوحدة بعيدة عبر Module Federation من أصل مسموح به. ويتلقى عنصر التحكم المخصص القيمة الحالية للحقل ويُرجِع التغييرات عبر النموذج نفسه — ولذلك تُحفَظ القيمة التي يكتبها عنصر التحكم تمامًا كما تُحفَظ قيمة مكتوبة في حقل أصلي. وإذا لم يكن عنصر التحكم المشار إليه مثبَّتًا في البيئة، يعود الحقل إلى محرره الأصلي بدلًا من أن يتعطل النموذج.

حل المشكلات

• عنصر التحكم لا يظهر في المنتقي. — قد لا يكون عنصر التحكم مثبَّتًا في هذه البيئة، أو قد لا تتضمن قائمة «بديل عن» الخاصة به نوع عنصر تحكم هذا الحقل. سجّل عنصر التحكم أو أعد تهيئته، ثم أعد فتح النموذج.
• يعرض الحقل «This control's code is served from a blocked origin». — أصل رابط remoteEntry الخاص بعنصر التحكم ليس ضمن قائمة العناوين المصرّح بها للبيئة. اطلب من المسؤول إضافة الأصل إلى قائمة العناوين المصرّح بها للبيئة.
• يعرض الحقل محرره الأصلي بدلًا من عنصر التحكم بعد الاستيراد. — لم يكن عنصر التحكم مُضمَّنًا في الحل المستورَد أو أنه غير مثبَّت بعد في البيئة الهدف. استورد الحل الذي يحتوي على عنصر التحكم، ثم أعد فتح النموذج.
• يعمل زر عنصر التحكم نفسه كلما نقرت داخله (تُمسح لوحة التوقيع بمجرد تحرير زر الفأرة). — تم الإصلاح. كان النموذج يضع كل حقل داخل تسمية، والنقر في أي مكان داخل التسمية يُمرَّر إلى أول زر فيها. لم يعد الحقل الذي يستخدم عنصر تحكم مخصصًا يوضع بهذه الطريقة.

سيناريوهات ذات صلة

• تسجيل عنصر تحكم مخصص.
• إضافة حقل إلى نموذج.
• إنشاء نموذج.