Coleção de controles (referência da API do cliente)

Use a controls coleção para aceder aos controlos associados às colunas.

Quando realiza ações em controlos ligados a uma coluna, considere que o controlo pode aparecer na página mais do que uma vez. Geralmente, deve realizar as mesmas ações para cada controlo da coluna. Podes percorrer a coleção de controlos de coluna e realizar as ações em cada controlo.

Por exemplo, para adicionar uma notificação a cada controlo atribuído à name coluna, use o seguinte código:

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

Como cada coluna pode aparecer mais do que uma vez na página, a coleção de controlos dá acesso a todos os controlos que representam essa coluna. Se a coluna for representada por apenas um controlo na página, o comprimento desta coleção é 1.

Quando usas o método controlo getName , o nome do primeiro controlo corresponde ao nome da coluna. A segunda instância de um controlo para essa coluna é <columnName>1. O padrão <columnName>+N continua para cada controlo adicional adicionado ao formulário para uma coluna específica.

Quando um formulário apresenta um controlo de fluxo de processos de negócio no cabeçalho, adiciona controlos para cada coluna que aparece no fluxo do processo de negócio. Estes controlos têm um nome único, como o seguinte: header_process_<column name>.

Artigos relacionados

Colunas (referência da API do cliente)