Verzameling besturingselementen (client-API-verwijzing)

Gebruik de controls verzameling voor toegang tot besturingselementen die zijn gekoppeld aan kolommen.

Wanneer u acties uitvoert op besturingselementen die zijn gekoppeld aan een kolom, moet u er rekening mee houden dat het besturingselement meerdere keren op de pagina kan worden weergegeven. Over het algemeen moet u dezelfde acties uitvoeren voor elk besturingselement voor de kolom. U kunt de verzameling kolombesturingselementen doorlopen en de acties op elk besturingselement uitvoeren.

Als u bijvoorbeeld een melding wilt toevoegen aan elk besturingselement dat aan de name kolom is gebonden, gebruikt u de volgende code:

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

Omdat elke kolom meerdere keren op de pagina kan worden weergegeven, biedt de verzameling besturingselementen toegang tot alle besturingselementen die die kolom vertegenwoordigen. Als de kolom wordt weergegeven door slechts één besturingselement op de pagina, is de lengte van deze verzameling 1.

Wanneer u de methode getName van het besturingselement gebruikt, komt de naam van het eerste besturingselement overeen met de naam van de kolom. Het tweede exemplaar van een besturingselement voor die kolom is <columnName>1. Het patroon <columnName>+N wordt voortgezet voor elk extra besturingselement dat aan het formulier is toegevoegd voor een specifieke kolom.

Wanneer in een formulier een besturingselement voor bedrijfsprocesstroom in de koptekst wordt weergegeven, worden er besturingselementen toegevoegd voor elke kolom die wordt weergegeven in de bedrijfsprocesstroom. Deze besturingselementen hebben een unieke naam zoals de volgende: header_process_<column name>.

Verwante artikelen

Kolommen (client-API-verwijzing)