Sdílet prostřednictvím

Událost OnChange sloupce (reference k rozhraní API klienta)

K OnChange události dochází v následujících situacích:

  • Data ve sloupci formuláře se změnila a fokus se ztratil. Toto chování se týká sloupců Typu Ano/Ne, které jsou formátované tak, aby používaly přepínače nebo zaškrtávací políčka. V těchto případech dojde k události okamžitě.
  • Změny dat na serveru se načtou, aby se při aktualizaci formuláře aktualizoval sloupec, například po uložení záznamu.
  • Používá se metoda attribute.fireOnchange .

Všechny sloupce podporují OnChange událost. Data ve sloupci se ověřují před a po OnChange události.

K OnChange události nedojde, pokud je sloupec změněn programově pomocí attribute.setValue metoda. Chcete-li obslužné rutiny událostí události OnChange spustit po nastavení hodnoty, musíte použít formContext.data.entity attribute.fireOnchange metoda v kódu. Událost OnChange také nenastane, pokud se sloupec změní programově při zahození změn, pokud uživatel přejde mimo nezašpiněný formulář.

Poznámka:

I když sloupec Status podporujeOnChange událost, sloupec je ve formuláři jen pro čtení, takže událost nemůže probíhat prostřednictvím interakce uživatele. Jiný skript může způsobit výskyt této události pomocí metody fireOnchange ve sloupci.

Poznámka:

OnChange události jsou synchronní. V obslužné rutině OnChange události byste neměli používat asynchronní kód, který vyžaduje provedení nebo zpracování akce při řešení asynchronního kódu. To způsobí problémy, pokud obslužná rutina řešení očekává, že kontext aplikace zůstane stejný jako při spuštění asynchronního kódu. V obslužné rutině události OnChange byste také neměli provádět synchronní síťové požadavky. To může způsobit nereagující aplikaci.

Podporované metody pro tuto událost

Existují tři metody, které můžete použít k práci s událostí OnChange pro sloupec:

Sloupce (referenční dokumentace k rozhraní API klienta)
Události (reference k rozhraní API klienta)
Události ve formulářích a mřížkách v modelem řízených aplikacích

  • Last updated on