Udostępnij przez

Zdarzenie OnChange kolumny (dokumentacja interfejsu API klienta)

Zdarzenie OnChange występuje w następujących sytuacjach:

  • Dane w kolumnie formularza uległy zmianie i utracono fokus. Istnieje wyjątek od tego zachowania, który ma zastosowanie do kolumn Tak/Nie sformatowanych do używania przycisków radiowych lub pól wyboru. W takich przypadkach zdarzenie występuje natychmiast.
  • Zmiany danych na serwerze są pobierane w celu zaktualizowania kolumny po odświeżeniu formularza, na przykład po zapisaniu rekordu.
  • Używana jest metoda attribute.fireOnchange .

Wszystkie kolumny obsługują OnChange zdarzenie. Dane w kolumnie są weryfikowane przed zdarzeniem i po nim OnChange .

Zdarzenie nie występuje, jeśli kolumna OnChange jest zmieniana programowo przy użyciu metody attribute.setValue . Jeśli chcesz, aby programy obsługi zdarzeń uruchamiane OnChange po ustawieniu wartości, należy użyć formContext.data.entity attribute. metody fireOnchange w kodzie. Zdarzenie nie występuje również, jeśli kolumna OnChange jest zmieniana programowo podczas odrzucania zmian, jeśli użytkownik przechodzi z dala od zanieczyszczonego formularza.

Uwaga / Notatka

Mimo że kolumna Stan obsługujeOnChange zdarzenie, kolumna jest tylko do odczytu w formularzu, więc zdarzenie nie może wystąpić za pośrednictwem interakcji użytkownika. Inny skrypt może spowodować wystąpienie tego zdarzenia przy użyciu metody fireOnchange w kolumnie.

Uwaga / Notatka

OnChange zdarzenia są synchroniczne. Nie należy używać kodu asynchronicznego w procedurze OnChange obsługi zdarzeń, która wymaga wykonania lub obsługi akcji w zakresie rozpoznawania kodu asynchronicznego. Powoduje to problemy, jeśli program obsługi rozwiązywania oczekuje, że kontekst aplikacji pozostanie taki sam, jak w przypadku uruchomienia kodu asynchronicznego. Nie należy również wykonywać synchronicznych żądań sieciowych w procedurze obsługi zdarzeń OnChange. Może to spowodować brak odpowiedzi aplikacji.

Metody obsługiwane dla tego zdarzenia

Istnieją trzy metody, których można użyć do pracy ze OnChange zdarzeniem dla kolumny:

Kolumny (dokumentacja interfejsu API klienta)
Zdarzenia (dokumentacja interfejsu API klienta)
Zdarzenia w formularzach i siatkach w aplikacjach opartych na modelu

  • Last updated on