Partajați prin


Eveniment OnChange coloană (referință API client)

Evenimentul OnChange are loc în următoarele situații:

  • Datele dintr-o coloană de formular s-au modificat și focalizarea se pierde. Există o excepție la acest comportament care se aplică coloanelor Da/Nu care sunt formatate pentru a utiliza butoane radio sau casete de selectare. În aceste cazuri, evenimentul are loc imediat.
  • Modificările de date de pe server sunt regăsite pentru a actualiza o coloană atunci când formularul este reîmprospătat, cum ar fi după ce se salvează o înregistrare.
  • Se utilizează metoda attribute.fireOnchange .

Toate coloanele acceptă OnChange evenimentul. Datele din coloană sunt validate înainte și după OnChange eveniment.

Evenimentul OnChange nu are loc dacă coloana se modifică programatic utilizând metoda attribute.setValue . Dacă doriți ca rutinele de tratare a evenimentelor OnChange să ruleze după ce setați valoarea, trebuie să utilizați formContext.data.entity attribute. metoda fireOnchange în cod. De OnChange asemenea, evenimentul nu are loc dacă coloana este modificată programatic atunci când se renunță la modificări dacă utilizatorul navighează departe de o formă murdară.

Notă

Deși coloana Stare acceptăOnChange evenimentul, coloana este doar în citire în formular, astfel încât evenimentul să nu poată apărea prin interacțiunea utilizatorului. Un alt script ar putea determina apariția acestui eveniment utilizând metoda fireOnchange din coloană.

Notă

OnChange evenimentele sunt sincrone. Nu trebuie să utilizați cod asincron într-o OnChange rutină de tratare eveniment care necesită o acțiune care să fie efectuată sau gestionată la rezoluția codului asincron. Acest lucru cauzează probleme dacă rutina de tratare a rezolvării așteaptă ca contextul aplicației să rămână la fel ca atunci când a început codul asincron. De asemenea, nu trebuie să efectuați solicitări de rețea sincronizate într-o rutină de tratare a evenimentelor OnChange. Acest lucru poate cauza o aplicație care nu răspunde.

Metode acceptate pentru acest eveniment

Există trei metode pe care le puteți utiliza pentru a lucra cu OnChange evenimentul pentru o coloană:

Coloane (Referință API client)
Evenimente (Referință API client)
Evenimente în formulare și grile în aplicații bazate pe model