مشاركة عبر


حدث Column OnChange (مرجع واجهة برمجة تطبيقات العميل)

OnChange يقع الحدث في الحالات التالية:

  • تم تغيير البيانات الموجودة في عمود نموذج ويتم فقدان التركيز. هناك استثناء لهذا السلوك الذي ينطبق على أعمدة نعم/لا التي تم تنسيقها لاستخدام أزرار تبادلية أو خانات اختيار. في هذه الحالات يقع الحدث على الفور.
  • يتم استرداد تغييرات البيانات على الخادم لتحديث عمود عند تحديث النموذج، مثل بعد حفظ السجل.
  • يتم استخدام أسلوب attribute.fireOnchange .

تدعم كافة الأعمدة OnChange الحدث. يتم التحقق من صحة البيانات الموجودة في العمود قبل الحدث وبعده OnChange .

OnChange لا يحدث الحدث إذا تم تغيير العمود برمجيا باستخدام أسلوب attribute.setValue. إذا كنت تريد تشغيل معالجات الأحداث للحدث OnChange بعد تعيين القيمة، يجب استخدام formContext.data.entity attribute. أسلوب fireOnchange في التعليمات البرمجية الخاصة بك. OnChange لا يحدث الحدث أيضا إذا تم تغيير العمود برمجيا عند تجاهل التغييرات إذا كان المستخدم يتنقل بعيدا عن نموذج قذر.

Note

على الرغم من أن عمود الحالة يدعمOnChange الحدث، إلا أن العمود للقراءة فقط في النموذج بحيث لا يمكن حدوث الحدث من خلال تفاعل المستخدم. قد يتسبب برنامج نصي آخر في حدوث هذا الحدث باستخدام أسلوب fireOnchange في العمود.

Note

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

الأساليب المعتمدة لهذا الحدث

هناك ثلاث طرق يمكنك استخدامها للعمل مع OnChange الحدث لعمود:

الأعمدة (مرجع واجهة برمجة تطبيقات العميل)
الأحداث (مرجع واجهة برمجة تطبيقات العميل)
الأحداث في النماذج والشبكات في التطبيقات التي تستند إلى النموذج