Choix multiple
Permet aux utilisateurs de sélectionner plusieurs éléments à la fois parmi une liste d'éléments.
Liaison de données
Vous pouvez définir ou modifier les liaisons de données pour la vue dans les propriétés Général. La vue peut être associée à un type TOUS (Liste).
Propriétés de configuration
Sous Configuration, définissez ou modifiez les propriétés d'apparence et de comportement de la vue.
- Taille de l'écran
- Une propriété de configuration comportant l'icône Tailles d'écran
en regard du nom de la propriété peut avoir des valeurs différentes pour chaque taille d'écran. Si vous ne définissez pas de valeur, la taille de l'écran hérite de la valeur de taille d'écran supérieure suivante comme valeur par défaut.
- Définitions de thème
- Les définitions de thème spécifient les couleurs et les styles d'une vue et déterminent son apparence. Vous pouvez prévisualiser l'apparence des vues dans l'éditeur de thème. Voir Thèmes.
Les propriétés de configuration de l'apparence de la vue Sélection multiple sont
répertoriées dans le tableau ci-dessous :
| Propriété de configuration de l'apparence | Description | Type de données |
|---|---|---|
| Largeur |
Largeur de la vue. Vous pouvez spécifier sa largeur en px (pixels), % (pourcentage), ou unités em. Par exemple, 50px, 20% ou 0.4em. Si aucun type d'unité n'est spécifié, px est utilisé. | String |
| Taille |
Taille du texte dans la vue, taille du texte du libellé et niveau de remplissage autour du texte. Par exemple, pour rendre le texte et le libellé plus lisibles sur les smartphones, vous pouvez définir cette option de configuration sur Large pour compenser la taille d'écran réduite. | String |
| Position du libellé |
Positions du libellé pour la vue. | String |
| Largeur du libellé |
Largeur de l'étiquette. Vous pouvez spécifier sa largeur en px (pixels), % (pourcentage), ou unités em. Par exemple, 50px, 20% ou 0.4em. Si aucun type d'unité n'est spécifié, px est utilisé. | String |
| Afficher le marqueur de validation | Affichez une icône de validation et une bordure lorsque la vue n'est pas valide. | Boolean |
Les propriétés de configuration du comportement de la vue Sélection multiple
sont répertoriées dans le tableau ci-dessous :
| Propriété de configuration du comportement | Description | Type de données |
|---|---|---|
| Index de tabulation | Index de séquence de tabulation. L'index de tabulation débute à la valeur 1 et peut être défini de manière éparse. Par exemple, vous pouvez utiliser 1, 5, 10. | Integer |
Les propriétés de configuration des éléments de la vue Sélection multiple
sont répertoriées dans le tableau ci-dessous :
| Propriété de configuration de l'élément | Description | Type de données |
|---|---|---|
| Mode de recherche d'élément | Méthode utilisée pour remplir la liste des éléments à partir de laquelle l'utilisateur peut effectuer une sélection. Remarque : Assurez-vous que l'option appropriée est sélectionnée, autrement la liste ne sera pas remplie correctement.
|
String |
| Service des éléments de liste | Service utilisé pour remplir la liste des éléments qui apparaissent dans la liste de sélection. Le service est utilisé lorsque le Mode de recherche d'élément est Eléments du service. Le service est un flux de services disposant de droits d'accès Ajax appropriés, qui fournissent la liste de sélection en fonction des données fournies par l'objet métier Données d'entrée du service. Vous pouvez utiliser cette option comme alternative pour associer la vue à un objet de liste. Astuce: Le service d'éléments de liste utilise deux variables: une variable d'entrée de type
string nommée dataet une variable de sortie de type list nommée results, qui génère le résultat sous forme de données liées à la vue. Si le nom de la variable de sortie n'est pas results (les "résultats" du service des éléments de liste), aucune valeur ne sera disponible. |
Flux de services |
| Données d'entrée du service | Objet métier fournissant les données d'entrée transmises au flux de services qui remplit la liste de sélection. Cette option est utilisée lorsque le Mode de recherche d'élément est Eléments du service. | N'IMPORTE LEQUEL |
| Ignorer les changements des données d'entrée | Désactive l'appel de service automatique lorsque les données d'entrée de service changent. Cette option est utilisée uniquement lorsque le Mode de recherche d'élément est Eléments du service. | Boolean |
| Données d'entrée d'élément | Liste d'objets métier qui remplit la liste de sélection. Cette propriété est utilisée uniquement si le mode de recherche d'élément est Eléments de l'option de configuration. | TOUS [ ] |
| Données de sélection d'article | Dans la zone Propriété d'affichage, définissez la propriété d'objet métier à afficher dans la liste de sélection. Si aucune valeur n'est spécifiée pour les propriétés de mappage des données, les valeurs par défaut sont le nom de la zone Propriété de valeur et la valeur de la zone Propriété d'affichage. | |
| Données métier de sortie | Lorsque la vue est liée à un type complexe, la propriété que l'utilisateur sélectionne est transmise à la propriété spécifiée dans propriété d'affichage et à la propriété liée à la vue. | |
| Liste statique | Liste d'éléments statique pour remplir la liste de sélection. Utilisez cette option uniquement pour une liste statique. Ne spécifiez par une variable pour cette option. Pour une liste de variables, utilisez le mode de recherche Eléments de l'option de configuration. | NameValuePair[] |
Exemple: éléments d'une liste statique
Vous disposez d'une vue Sélection multiple avec le libellé Grocery list et le mode de recherche d'élément que vous avez sélectionné est Eléments de la liste statique. Dans la Liste statique, vous avez défini les paires de valeurs de noms suivantes.
Le résultat suivant s'affiche:
| Nom | Valeur |
|---|---|
| 1 | Lait |
| 2 | Pain |
| 3 | Bananes |
| 4 | Riz |
Exemple : remplissage avec des éléments en utilisant un objet métier
Cet exemple utilise un objet métier Client pour remplir une liste de prénoms dans la liste de sélection. Lorsque l'utilisateur sélectionne plusieurs noms, l'enregistrement correspondant est affiché dans une table.
L'objet métier Client a la structure suivante :
- Paramètre de type String.
- Paramètre de type String.
- Paramètre de type String.
L'objet métier Client comporte les valeurs par défaut suivantes :
var autoObject = [];
autoObject[0] = {};
autoObject[0].ID = "000";
autoObject[0].firstName = "Pierre";
autoObject[0].lastName = "de Fermat";
autoObject[1] = {};
autoObject[1].ID = "001";
autoObject[1].firstName = "Isaac";
autoObject[1].lastName = "Newton";
autoObject[2] = {};
autoObject[2].ID = "002";
autoObject[2].firstName = "John";
autoObject[2].lastName = "Venn";
autoObjectLe service utilisateur côté client possède une variable privée outputList de type. Le type de sortie comporte deux paramètres de chaîne et. La vue Sélection multiple est liée à outputList, qui contient la sortie de données de la vue.
La page comporte une vue Sélection multiple avec les propriétés suivantes :
- Sous Général, définissez Liaison sur outputList.
- Sous , définissez Mode de recherche d'élément sur.
- Sous , définissez Données d'entrée d'élément sur.
- Sous :
- Pour Propriété de valeur, spécifiez.
- Pour Afficher la propriété, spécifiez.
- Sous :
- Pour Propriété de valeur, spécifiez.
- Pour Afficher la propriété, spécifiez.
La vue Table comporte les propriétés suivantes :
- Deux colonnes intitulées et
- Sous Général, Libellé est défini sur.
- Sous Général, Liaison est défini sur.
Astuce: Pour créer rapidement la table, faites glisser la variable outputList sur la page.
Il s'agit du résultat lors de l'exécution :
Voici le résultat après avoir effectué plusieurs sélections:Les valeurs que vous sélectionnez sont affichées dans la colonne Value2 , qui correspond à la propriété spécifiée dans l'option Afficher la propriété sous Données métier de sortie. La propriété est transmise par la valeur. Si vous entrez Propriété d'affichage, les noms que vous avez sélectionnés apparaissent dans la colonne Value1 .
Evénements
Vous pouvez définir ou modifier des gestionnaires d'événements pour la vue dans l'onglet Evénements. Vous pouvez définir des événements à déclencher par programmation ou lorsqu'un utilisateur interagit avec la vue. Pour plus d'informations sur la manière de définir et de coder des événements, voir Evénements définis par l'utilisateur.
La vue Sélection multiple comporte les types de gestionnaire d'événements suivants :
- : Activé lors du chargement de la page. Par exemple :
- : Activé lorsque les données liées sont modifiées. Par exemple :
- : Activé lorsque le flux de services renvoie une liste d'éléments. Activé uniquement si Mode de recherche d'élément est défini sur Eléments du service.
- : Activé lorsque le flux de services renvoie une erreur de service. Activé uniquement si Mode de recherche d'élément est défini sur Eléments du service
En fonction de l'événement spécifique, vous pouvez utiliser la logique JavaScript pour modifier les effets de la vue. Vous trouverez plus d'informations sur l'utilisation des événements avec des vues dans la rubrique Evénements définis par l'utilisateur.
Méthodes
Pour plus d'informations sur les méthodes disponibles pour l'option Sélection multiple, voir l'API Sélection multiple JavaScript .
Ressources supplémentaires
Pour plus d'informations sur la création d'un coach ou d'une page, voir Génération de coaches.
Pour plus d'informations sur les propriétés standard (Général, Configuration, Positionnement, Visibilitéet Attributs HTML), voir Afficher les propriétés.