Partager via


HorizontalBarChart - Stacked contrôle (version préliminaire)

[Cet article fait partie de la documentation préliminaire et peut faire l’objet de modifications.]

Graphique à barres empilées horizontalement affiche plusieurs séries de données sous forme de barres empilées, chaque barre représentant une catégorie. Les barres sont empilées les unes à côté des autres, la longueur de chaque barre représentant la valeur de la catégorie de la série.

HorizontalBarChart – Contrôle empilé.

Ce composant de code fournit un wrapper autour du contrôle HorizontalBarChart – empilé de l’interface utilisateur Fluent à utiliser dans canevas et les pages personnalisées.

Important

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.

Note

Pour une documentation complète et le code source, voir le Référentiel de composants de code GitHub.

Propriétés

Le contrôle accepte les propriétés suivantes :

  • HideLegend - Cette valeur indique s’il faut afficher ou masquer les légendes sur le graphique.

  • BarHeight - Cette valeur indique la hauteur de la barre présentée dans le graphique.

  • HideTooltip - Cette option contrôle si les info-bulles doivent être affichées ou masquées sur le graphique.

  • CustomColors - Cette option est utilisée pour afficher des couleurs personnalisées sur le graphique si elles sont fournies

  • Éléments - Les éléments d’action à restituer

    • ItemTitle - Le nom complet des données de graphique particulières (Item).
    • ItemKey - La clé à utiliser pour identifier l’élément. Les clés doivent être uniques.
    • ItemValue - Définissez la valeur des données de graphique particulières (Item).
    • ItemColor - Définissez le nom de la couleur ou la valeur HEX à afficher pour les données de graphique particulières (Item).
    • ItemCallout - Définissez la valeur à afficher dans une fenêtre contextuelle/info-bulle.

Note

La couleur de l’élément ne s’applique que si la CustomColors propriété est activée.

Accessibilité

  • Étiquette d’accessibilité - Écran Lecteur aria-label

Utilisation

Mappez les valeurs des données aux propriétés de graphique correspondantes dans la Items propriété du contrôle, comme démontré dans la formule ci-dessous. Le graphique ajuste automatiquement le visuel pour correspondre aux valeurs relatives.

Activez la CustomColors propriété pour définir des couleurs cohérentes.

Table(
    {
        ItemKey: "1",
        ItemTitle: "First",
        ItemCallout:"First item callout title",
        ItemValue: 40,
        ItemColor: "#00A892"
    },
    {
        ItemKey: "2",
        ItemTitle: "Second",
        ItemCallout:"Second item callout title",
        ItemValue: 20,
        ItemColor: "#9A44FC"
    },
    {
        ItemKey: "3",
        ItemTitle: "Third",
        ItemCallout:"Third item callout title",
        ItemValue: 120,
        ItemColor: "#3483FA"
    },
    {
        ItemKey: "4",
        ItemTitle: "Fourth",
        ItemCallout:"Fourth item callout title",
        ItemValue: 90,
        ItemColor: "#EBA800"
    }
)

Limitations

Ce composant de canevas ne peut être utilisé que dans les applications canevas et les pages personnalisées.