تحميل البرَامج النصية
لاستخدَام البرمجة النصية للعميل فِي أحد النمَاذج، يجب أولاً تحميل البرنَامج النصي كمورد ويب لبرنَامج نصي. يمكنك استخدَام موارد ويب البرنَامج النصي للحفاظ على مكتبات دوال البرنَامج النصي للعميل المكتوبة بلغة JavaScript أو TypeScript، ويمكنك استخدَامهَا إمَا مِن دَاخل نموذج تطبيق يستند إلى نموذج أو مِن تحديد شريط الأوامر. إذَا كنت تستخدم TypeScript، فيجب عليك ترجمتهَا إلى JavaScript قبل تحميلهَا كمورد ويب.
لتحميل مورد ويب لبرنَامج نصي، قم بإنشَاء مكتبة نمَاذج جديدة مِن محرر النمَاذج.
ستظهر النَافذة المنبثقة إضَافَة مكتبة JavaScript. حدد + مورد ويب جديد أعلى اليمين. فِي جزء مورد ويب جديد، تأكد مِن تحديد JavaScript (JS) على أنه النوع.
لكي تكون بيَانَات عمود أحد الجدَاول متوفرة للتضمين فِي منطق البرنَامج النصي، تأكد مِن تكوين النموذج لعرض العمود. لاحظ أنه إذَا قَام شخص مَا لاحقًا بإزَالة العمود مِن النموذج، فسيؤدي ذلك إلى تعطل البرنَامج النصي الخَاص بك لأن العمود المشَار إليه لم يعُد متوفرًا. يمكنك إضَافَة العمود باعتباره تبعية للتأكد مِن أن بيَانَات العمود متَاحة دَائمًا لمنطق البرنَامج النصي الخَاص بك. توضح الصورة التَالية إضَافَة عمود نقَاط الفكرة مِن جدول الأفكار باعتباره تبعية.
تبعيَات موارد الويب
بالإضَافَة إلى تبعيَات البيَانَات، يمكنك أيضًا تكوين التبعيَات على موارد الويب الأخرى. توفر هذه التبعية الوقت وتبسط منطق التحميل لأن النموذج لا يحتَاج إلى تحميل موارد ويب تَابعة متعددة بشكل صريح عِندَ تسجيل برنَامج نصي لحدث نموذج أو أمر شريط أو قواعد تمكين الشريط. باستخدَام تكوين التبعية، يمكنك تسجيل البرنَامج النصي الأسَاسي والسمَاح لتكوين التبعية بتحميل الموارد الأخرى التي تحتَاج إليهَا التعليمة البرمجية الخَاصة بك.
من المهم ملاحظة أن تبعيَات موارد الويب لا تتحكم بأي شكل فِي الترتيب الذي يتم به تحميل موارد الويب. يتم تحميل جَمِيع موارد الويب بشكل غير متزَامن وبالتوازي. إذَا كان لديك مورد ويب JavaScript يعتمد على مورد ويب JavaScript آخر للتحميل والتهيئة قبل أن يتمكن مِن التهيئة، فستحتَاج إلى إدَارة هذه التبعية بطريقة أخرى.
استخدم مكتبات البرَامج النصية للعميل
فور تكوينهَا كمورد ويب لبرنَامج نصي، يمكن ربط مكتبات البرَامج النصية للعميل بأوامر الشريط وأحدَاث النمَاذج. لربط برنَامج نصي بنموذج، حدد مكتبات النمَاذج فِي شريط الأدوات ثم قم بإضَافَة مكتبة.
من مربع حوار إضَافَة مكتبة، يمكنك إمَا ربط مورد ويب نصي موجود تم تحميله أو إنشَاء مورد جديد.
لا يلزم إقرَان مكتبة البرَامج النصية بالنموذج إلا مرة واحدة لكل برنَامج نصي فِي كل نموذج، بغض النظر عن عدد معالجات الأحدَاث التي تسجلهَا فِي هَذا النموذج.
إذَا كنت بحَاجة إلى إجرَاء تغييرَات فِي أثنَاء إنشَاء منطق البرنَامج النصي للعميل بَعد التحميل الأوّلي، فستحتَاج إلى العودة إلى مورد الويب الخَاص بالبرنَامج النصي فِي الحل وتحميل الإصدَار الجديد مِن الملف. بعد التحميل، يجب عليك نشر مورد الويب النصي حتى يستخدم التطبيق أحدث التغييرَات.