Valeurs d’affichage

Blocs de construction en lecture seule pour les pages d’enregistrement : un badge de statut, une adresse postale, et un moyen de lire la valeur d’une colonne dans le code sans décoder le format du câble.

Lecture de la valeur d’une colonne

Pour faire une branche sur une valeur (colorer un statut, afficher un drapeau, comparer une date), lisez la valeur brute de la colonne au lieu de son étiquette, qui est localisée. Dans React, useColumnValue(columnName) il retourne la valeur d’une colonne de l’environnant RecordContext comme un type JavaScript simple, avec la chaîne formatée et les métadonnées de la colonne à côté. Dans Blazor, lisez la valeur tapée de l’enregistrement avec GetValueOrDefault<T>. Dans tous les cas, une colonne vide ou retenue par la sécurité de la colonne se lit comme null; CanReadColumn distingue les deux.

React Blazor

En dehors d’un RecordContext, comme dans un moteur de rendu de cellules de grille ou une infobulle de graphique, appelez readColumnRawValue(record, columnName) depuis @powerportalspro/core sur l’enregistrement que vous détenez.

Insigne de statut

ColumnStatusBadge indique la raison de statut du disque (statuscode) et prend sa couleur de l’état (statecode) : une teinte de marque pendant qu’elle est active, sinon un contour neutre. La couleur provient de la valeur de l’État, pas de son étiquette, donc elle tient dans toutes les langues. Rien ne s’affiche lorsque l’étiquette est vide ou retenue.

Exemple de réaction Exemple de Blazor React TypeScript Razor
Contoso Ltd Active
Fabrikam, Inc. Inactive

Tonalités personnalisées

Pour une table avec plus de deux états, passez une Tone fonction qui associe la valeur de l’état à une couleur et une apparence d’insigne. Elle reçoit null lorsque l’état est vide ou retenu.

React Blazor

Adresse

AddressDisplayValue rend l’une des adresses d’une table (address1, address2, ...) dans un <address> élément, portant la même étiquette que ColumnDisplayValue. Il affiche la colonne Dataverse _composite lorsque l’utilisateur peut la lire. Sinon, il compose les lignes de rues, puis la ville, la région et le code postal, puis le pays, qu’il omet lorsqu’il correspond HomeCountryà .

Exemple de réaction Exemple de Blazor React TypeScript Razor
1 Microsoft Way
Building 92
Redmond, WA 98052
70 Wilson Street
London, EC2A 2DB
United Kingdom
Réagir Blazor

ColumnStatusBadge Classe

Paramètres

Nom
Type
Par défaut
Description
IsVisiblebool
True
Le badge est-il visible ?
LabelColumnstring
statuscode
Colonne dont la valeur formatée est le texte du badge. Par défaut le statut code, le statut raison ; utiliser le code d’état pour une table dont la raison de statut n’est pas lisible.
SizeBadgeSize?
Taille du badge. Par défaut, c’est celui de Fluent.
StateColumnstring
statecode
Colonne dont la valeur détermine le tonalité. Par défaut, le code d’état est attribué.
ToneFunc<int?, StatusBadgeTone>?
Choisit le ton à partir de la valeur de la colonne d’état — null lorsqu’elle est vide ou retenu. Par défaut : Nullable{System.Int32})une teinte de marque pour actif (0), un contour neutre sinon. Fournir un pour un tableau avec plus de deux états.
Nom: IsVisible
Type: bool
Par défaut: True
Description: Le badge est-il visible ?
Nom: LabelColumn
Type: string
Par défaut: statuscode
Description: Colonne dont la valeur formatée est le texte du badge. Par défaut le statut code, le statut raison ; utiliser le code d’état pour une table dont la raison de statut n’est pas lisible.
Nom: Size
Type: BadgeSize?
Description: Taille du badge. Par défaut, c’est celui de Fluent.
Nom: StateColumn
Type: string
Par défaut: statecode
Description: Colonne dont la valeur détermine le tonalité. Par défaut, le code d’état est attribué.
Nom: Tone
Type: Func<int?, StatusBadgeTone>?
Description: Choisit le ton à partir de la valeur de la colonne d’état — null lorsqu’elle est vide ou retenu. Par défaut : Nullable{System.Int32})une teinte de marque pour actif (0), un contour neutre sinon. Fournir un pour un tableau avec plus de deux états.
Réagir Blazor

AddressDisplayValue Classe

Paramètres

Nom
Type
Par défaut
Description
Descriptionstring?
Description affichée dans l’infobulle. Revient au {Prefix}_composite description de la colonne.
DisplayLabelWhenAvailablebool
True
Précise s’il faut afficher une étiquette si disponible.
DisplayTooltipWhenAvailablebool
True
Précise s’il faut afficher une infobulle si disponible.
EmptyPlaceholderstring
—
Texte affiché lorsque l’adresse est vide. Par défaut un tiret em ; passer une chaîne vide à Réprimer.
HomeCountrystring?
Le pays à omettre une adresse composée, par exemple « États-Unis » pour un portail dont Les adresses sont presque toutes domestiques. Comparé à l’ignorance des cases et des accents. Cela ne s’applique pas quand l’adresse est le composite propre à Dataverse, qui est affiché au formatage Dataverse.
IsVisiblebool
True
L’adresse est-elle visible ?
Labelstring?
Le texte doit être affiché sous forme d’étiquette. Revient à l’étiquette de la colonne {Prefix}_composite , par exemple « Adresse 1 ».
Prefixstring
address1
Le préfixe de colonne de l’adresse — address1, address2, ou une adresse personnalisée préfixe. Les parties sont lues à partir de {Préfixe}_line1... 3, _city, _stateorprovince, _postalcode, _country et _composite. Par défaut, adresse 1.
Nom: Description
Type: string?
Description: Description affichée dans l’infobulle. Revient au {Prefix}_composite description de la colonne.
Nom: DisplayLabelWhenAvailable
Type: bool
Par défaut: True
Description: Précise s’il faut afficher une étiquette si disponible.
Nom: DisplayTooltipWhenAvailable
Type: bool
Par défaut: True
Description: Précise s’il faut afficher une infobulle si disponible.
Nom: EmptyPlaceholder
Type: string
Par défaut: —
Description: Texte affiché lorsque l’adresse est vide. Par défaut un tiret em ; passer une chaîne vide à Réprimer.
Nom: HomeCountry
Type: string?
Description: Le pays à omettre une adresse composée, par exemple « États-Unis » pour un portail dont Les adresses sont presque toutes domestiques. Comparé à l’ignorance des cases et des accents. Cela ne s’applique pas quand l’adresse est le composite propre à Dataverse, qui est affiché au formatage Dataverse.
Nom: IsVisible
Type: bool
Par défaut: True
Description: L’adresse est-elle visible ?
Nom: Label
Type: string?
Description: Le texte doit être affiché sous forme d’étiquette. Revient à l’étiquette de la colonne {Prefix}_composite , par exemple « Adresse 1 ».
Nom: Prefix
Type: string
Par défaut: address1
Description: Le préfixe de colonne de l’adresse — address1, address2, ou une adresse personnalisée préfixe. Les parties sont lues à partir de {Préfixe}_line1... 3, _city, _stateorprovince, _postalcode, _country et _composite. Par défaut, adresse 1.