Samling af kontrolelementer (klient-API-reference)

Brug samlingen controls til at få adgang til de kontrolelementer, der er knyttet til kolonner.

Når du udfører handlinger på kontrolelementer, der er knyttet til en kolonne, skal du overveje, at kontrolelementet kan vises på siden mere end én gang. Generelt skal du udføre de samme handlinger for hvert kontrolelement for kolonnen. Du kan gå gennem samlingen af kolonnekontrolelementer og udføre handlingerne på hvert kontrolelement.

Hvis du f.eks. vil føje en meddelelse til hvert kontrolelement, der er bundet til kolonnen name , skal du bruge følgende kode:

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

Da hver kolonne kan vises mere end én gang på siden, giver samlingen af kontrolelementer adgang til alle de kontrolelementer, der repræsenterer den pågældende kolonne. Hvis kolonnen kun repræsenteres af ét kontrolelement på siden, er længden af denne samling 1.

Når du bruger metoden getName for kontrolelementet, svarer navnet på det første kontrolelement til navnet på kolonnen. Den anden forekomst af et kontrolelement for den pågældende kolonne er <columnName>1. Mønsteret <columnName>+N fortsætter for hvert ekstra kontrolelement, der føjes til formularen for en bestemt kolonne.

Når en formular viser et kontrolelement af typen forretningsprocesforløb i overskriften, tilføjes der kontrolelementer for hver kolonne, der vises i forretningsprocesforløbet. Disse kontrolelementer har et entydigt navn som følgende: header_process_<column name>.

Relaterede artikler

Kolonner (klient-API-reference)