列 OnChange 事件 (客户端 API 参考)

事件发生 OnChange 在以下情况下:

  • 窗体列中的数据已更改,焦点丢失。 此行为例外,这些行为适用于“是/否”列,这些列的格式设置为使用单选按钮或复选框。 在这些情况下,事件会立即发生。
  • 检索服务器上的数据更改,以便在刷新窗体时更新列,例如保存记录之后。
  • 使用 attribute.fireOnchange 方法。

所有列都支持该 OnChange 事件。 在事件前后 OnChange 验证列中的数据。

如果使用 attribute.setValue 方法以编程方式更改列,则不会发生该OnChange事件。 如果希望在设置值后运行事件的事件处理程序 OnChange ,则必须在代码中使用 formContext.data.entity attribute.fireOnchange 方法。 OnChange如果用户在离开脏窗体时以编程方式更改列,则也不会发生该事件。

注释

尽管 “状态 ”列支持该OnChange 事件,但该列在窗体上是只读的,因此无法通过用户交互来发生该事件。 另一个脚本可能通过使用列上的 fireOnchange 方法来发生此事件。

注释

OnChange 事件是同步的。 不应在OnChange需要对异步代码的解析执行或处理作的事件处理程序中使用异步代码。 如果解析处理程序要求应用上下文与启动异步代码时保持相同,则会导致问题。 不应在 OnChange 事件处理程序中发出同步网络请求。 这可能会导致无响应的应用。

此事件支持的方法

有三种方法可用于处理 OnChange 列的事件:

列(客户端 API 参考)
事件(客户端 API 参考)
模型驱动应用内窗体和网格中的事件