Utilisation des widgets > 2D > Liste
  
Liste
A quoi sert ce widget ?
Le widget Liste vous permet d'afficher n'importe quel ensemble de données dans une liste à une seule colonne.
Quand faut-il utiliser ce widget ?
Utilisez une liste lorsque vous souhaitez afficher les valeurs d'une propriété particulière dans un jeu de données. Par exemple, si vous souhaitez afficher les niveaux d'huile de tous les véhicules de votre parc de camions, vous pouviez utiliser le widget Liste et lier la propriété OilLevel de l'objet qui est partagé par tous les camions du parc.
Comporte-t-il des propriétés, services, événements ou actions spéciaux ?
Pour afficher la liste des propriétés, services et événements communs des widgets, consultez la rubrique Propriétés, services et événements communs à plusieurs widgets.
Le tableau suivant comporte une liste des propriétés spécifiques à ce widget.
Propriété
JavaScript
Type
Description
Activer mise en forme basée sur l'état
enableStateFormatting
boolean
Permet de mettre en forme le widget en fonction des définitions d'état qui ont été définies dans ThingWorx.
Si la case à cocher est sélectionnée, les propriétés suivantes s'affichent :
Champ dépendant
Définition d'état
Par exemple, si la définition d'état d'une étiquette a la valeur error, l'étiquette devient rouge.
Pour plus d'informations sur les définitions des styles et des états dans ThingWorx, consultez la rubrique Définitions des styles et des états dans le Centre d'aide ThingWorx.
Champ dépendant
* 
Visible lorsque l'option Activer formatage basé sur l'état est activée.
stateFormatValue
string
Cette propriété est visible si la case Activer formatage basé sur l'état est cochée. Pour plus d'informations sur les définitions des styles et des états dans ThingWorx, consultez la rubrique Définitions des styles et des états dans le Centre d'aide ThingWorx.
Définition d'état
* 
Visible lorsque l'option Activer formatage basé sur l'état est activée.
stateFormat
boolean
Cette propriété est visible si la case Activer formatage basé sur l'état est cochée. Pour plus d'informations sur les définitions des styles et des états dans ThingWorx, consultez la rubrique Définitions des styles et des états dans le Centre d'aide ThingWorx.
Champ d'affichage
label
string
Spécifie le champ qui s'affiche dans le widget Liste. En règle générale, il est identique au champ Valeur, mais il peut également être différent.
Des options sont automatiquement renseignées dans ce champ lorsque le widget est lié à des données ThingWorx.
Remplissage d'élément de liste
itempadding
string
Espace entre le contenu et le bord. Entrez un nombre suivi de l'un des formats pris en charge (par exemple, 10px) :
px
%
in
mm
cm
ex
em
pt
pc
Fonctionnement du widget
Voici un exemple de ce à quoi peut ressembler votre widget !
Etapes minimales requise pour l'utilisation
Apparence
1. Faites glisser et déposez un widget Liste sur le canevas.
2. Dans le volet Données, ajoutez un service à partir de l'entité que vous souhaitez utiliser pour récupérer les données.
3. Une fois le service ajouté, faites glisser et déposez Tous les éléments sur le widget et sélectionnez Liste dans la fenêtre Sélectionner une cible de liaison.
4. Sous Champ d'affichage dans le volet DETAILS, sélectionnez la propriété que vous souhaitez afficher dans la liste.
Champs de configuration assistée après la liaison de données ThingWorx
Une fois des données ThingWorx liées au widget, certains champs sont renseignés au moyen d'options dans une liste déroulante. Par exemple, si vous liez Tous les éléments au widget Liste et que vous sélectionnez Liste dans la fenêtre Sélectionner une cible de liaison, la propriété Champ d'affichage présente les options disponibles.