Kontrollsamling (klient-API-referanse)

controls Bruk samlingen til å få tilgang til kontroller som er knyttet til kolonner.

Når du utfører handlinger på kontroller som er knyttet til en kolonne, bør du vurdere at kontrollen kan vises på siden mer enn én gang. Vanligvis bør du utføre de samme handlingene for hver kontroll for kolonnen. Du kan gå gjennom kolonnekontrollsamlingen og utføre handlingene på hver kontroll.

Hvis du for eksempel vil legge til et varsel i hver kontroll som er bundet til name kolonnen, bruker du 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)
 );

Siden hver kolonne kan vises mer enn én gang på siden, gir kontrollsamlingen tilgang til alle kontroller som representerer denne kolonnen. Hvis kolonnen bare representeres av én kontroll på siden, er lengden på denne samlingen 1.

Når du bruker getName-metoden for kontrollen, samsvarer navnet på den første kontrollen med navnet på kolonnen. Den andre forekomsten av en kontroll for denne kolonnen er <columnName>1. Mønsteret <columnName>+N fortsetter for hver ekstra kontroll som legges til i skjemaet for en bestemt kolonne.

Når et skjema viser en kontroll for forretningsprosessflyt i toppteksten, legges det til kontroller for hver kolonne som vises i forretningsprosessflyten. Disse kontrollene har et unikt navn som følgende: header_process_<column name>.

Relaterte artikler

Kolonner (klient-API-referanse)