Contrôles (référence de l’API client)
Un contrôle représente un élément HTML présent dans le formulaire. Certains contrôles sont liés à une colonne spécifique, pendant que d’autres peuvent représenter des contrôles non liés tels qu’un IFRAME, une ressource Web ou une sous-grille ayant été ajoutée au formulaire.
L’objet contrôle fournit des méthodes pour modifier la présentation ou le comportement d’un contrôle et identifier la colonne correspondante. Vous pouvez accéder aux contrôles à l’aide de l’une des collections suivantes :
- formContext.ui.controls
- formContext.ui Section.controls
- formContext.data.entity Attribute.controls
La méthode formContext.getControl est une méthode de raccourci pour accéder à formContext.ui.controls.get.
Les contrôles sont classés par type. Vous pouvez choisir le type d’un contrôle via la méthode getControlType. Certaines méthodes de contrôle sont uniquement disponibles pour des types de contrôles spécifiques.
Cet article fournit des informations sur les méthodes disponibles par type de contrôle.
Type de contrôle standard
Voici les méthodes disponibles pour un contrôle standard.
Les méthodes suivantes pour le contrôle standard sont déconseillées dans cette version : addOnKeyPress, fireOnKeyPress et removeOnKeyPress.
Type de contrôle iframe
Voici les méthodes disponibles pour un contrôle IFRAME.
Type de contrôle kbsearch (recherche dans la Base de connaissances)
Voici les méthodes disponibles pour le contrôle de recherche dans la Base de connaissances.
Notes
Lorsque le contrôle de recherche dans la Base de connaissances est ajouté au volet social, le nom du contrôle est « searchwidgetcontrol_notescontrol ». Ce nom ne peut pas être modifié.
Type de contrôle lookup
Voici les méthodes disponibles pour un contrôle de recherche.
Options et types de contrôles d’option
Les options et les contrôles d’option utilisent le même ensemble de méthodes.
Type de contrôle quickform
Voir formContext.ui.quickForms pour plus d’informations sur les méthodes prises en charge pour ce type de contrôle.
Type de contrôle subgrid
Voir Grilles et sous-grilles pour plus d’informations sur les méthodes prises en charge pour ce type de contrôle.
Type de contrôle timelinewall
Le contrôle Chronologie répertorie les publications, les activités et les notes dans une vue unifiée. Voici les méthodes disponibles pour ce type de contrôle.
Type de contrôle timer
Voici les méthodes disponibles pour le contrôle de minuterie.
Type de contrôle de ressource Web
Un contrôle de ressource Web a le même ensemble de méthodes disponibles que le contrôle iframe. Voir Type de contrôle iframe
La ressource Web Sliverlight présente ces méthodes supplémentaires :
Conseil
Si vous souhaitez modifier tous les contrôles liés à une colonne de formulaire, utilisez la collection de contrôles à l’intérieur du type de colonne. Par exemple, pour ajouter une notification à chaque contrôle lié à la colonne name, vous pouvez effectuer les opérations suivantes :
const notification = { messages: ['Sample Notification on Name Controls'], notificationLevel: 'RECOMMENDATION', uniqueId: 'my_unique_id'};
formContext.getAttribute("name").controls.forEach(control => control.addNotification(notification));
Type de contrôle du composant du formulaire
Un type de contrôle de composant de formulaire dispose du même ensemble de méthodes que la variable formContext d’un formulaire principal. Voir Comportement du composant de formulaire > API client
Articles associés
Notes
Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)
Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).