控件集合 (客户端 API 参考)

使用 controls 集合访问与列关联的控件。

对绑定到列的控件执行操作时,请考虑该控件可能多次出现在页面上。 通常,应对列的每个控件执行相同的操作。 可以循环访问列控件集合,并在每个控件上执行操作。

例如,若要向绑定到 name 列的每个控件添加通知,请使用以下代码:

const notification = {
    messages: ['Sample Notification on Name Controls'],
    notificationLevel: 'RECOMMENDATION',
    uniqueId: 'my_unique_id'
 };
 
formContext.getAttribute("name").controls.forEach(control =>
    control.addNotification(notification)
 );

由于每个列可以多次显示在页面上,因此控件集合提供对表示该列的所有控件的访问权限。 如果该列只由页面上的一个控件表示,则此集合的长度为 1。

使用控件 getName 方法时,第一个控件的名称与列的名称匹配。 该列的控件的第二个实例为 <columnName>1。 为特定列添加到窗体的每个附加控件继续该模式 <columnName>+N 。

当窗体在标头中显示业务流程控件时,它会为业务流程中显示的每一列添加控件。 这些控件具有如下所示的唯一名称: header_process_<column name>

列(客户端 API 参考)