快速入门

Hello World

下面让我们通过一段代码，快速的开启我们的学习之旅。让我们在 客户 对象的前端脚本中新建一个脚本。 选择这个脚本的运行时机为 新增或编辑。进入到脚本代码编辑器，让我们敲入下面的代码：

thisApp.formOnLoad = async(ctx) => {
   qiqi.ui.dialog.alert('Hello, world!');
}

保存代码，别忘了 发布 这个脚本哦 ^_^。

让我们进入到客户列表，新增一个客户，我们会看到进入新增客户表单后，它将在客户表单页面上展示一个 “Hello, world!” 的对话框。如下图：

tip

是不是还有点小激动呢？接下来让我们去了解一下 Client API 还有哪些能力吧！

脚本入口点

无论何时加载表单、更改或保存数据，都会在表单中发生事件。您可以通过将 JavaScript 代码与事件关联来执行它，以便在事件发生时执行它。 用户可以在表单中提供的下面的事件中编写自己的代码：

Script 入口点	描述
FormLoad	定义在页面完成加载或表单重置时执行的函数。 支持 async 异步函数。
FieldOnChanged	定义用户或客户端调用更改字段时执行的函数。
SubGridChanged	定义在子表新增行，插入行或者删除行后执行的函数。
SubGridRowOnInit	定义在子表行第一次初始化时候触发。
OnSave	定义保存记录时执行的函数（在按下“提交” 或者 "保存" 按钮之后，但在提交表单之前）。 支持 async 异步函数。

在 Hello World 中，我们看到了 formLoad 这个入口点的定义。其他的脚本入口点的定义方式也相同。比如：

thisApp.formOnLoad = async (ctx) => {
  ...
}
  
thisApp.fieldOnChanged = async(ctx) => {
  ...
}
  
  
thisApp.subGridOnChanged = async(ctx) => {
  ...
}
    
  
thisApp.subGridRowOnInit = async(ctx) => {
  ...
}
  
  
thisApp.onSave = async(ctx) => {
  ...
}