Composants ASP.NET Core Razor rendus dynamiquement

Par Dave Brock

Utilisez le composant DynamicComponent intégré pour restituer les composants par type.

Composants dynamiques

Un DynamicComponent est utile pour le rendu des composants sans itérer par le biais de types possibles ou à l’aide d’une logique conditionnelle. Par exemple, DynamicComponent peut restituer un composant en fonction d’une sélection d’utilisateur dans une liste déroulante.

Dans l’exemple suivant :

• componentType spécifie le type.
• parameters spécifie les paramètres de composant à passer au composant componentType.

<DynamicComponent Type="componentType" Parameters="parameters" />

@code {
    private Type componentType = ...;
    private IDictionary<string, object> parameters = ...;
}

Pour plus d’informations sur la transmission de valeurs de paramètres, consultez la section Passer des paramètres plus loin dans cet article.

Utilisez la propriété Instance pour accéder à l’instance de composant créée dynamiquement :

<DynamicComponent Type="typeof({COMPONENT})" @ref="dc" />

<button @onclick="Refresh">Refresh</button>

@code {
    private DynamicComponent? dc;

    private Task Refresh()
    {
        return (dc?.Instance as IRefreshable)?.Refresh();
    }
}

Dans l'exemple précédent :

• L’espace réservé {COMPONENT} est le type de composant créé dynamiquement.
• IRefreshable est un exemple d’interface fourni par le développeur pour l’instance de composant dynamique.

Exemple

Dans l’exemple suivant, un composant Razor affiche un composant en fonction de la sélection de l’utilisateur dans une liste déroulante de quatre valeurs possibles.

Sélection de vaisseau utilisateur	Composant Razor partagé à restituer
Rocket Lab®	RocketLab.razor
SpaceX®	SpaceX.razor
ULA®	UnitedLaunchAlliance.razor
Virgin Galactic®	VirginGalactic.razor

RocketLab.razor:

<h2>Rocket Lab®</h2>

<p>
    Rocket Lab is a registered trademark of 
    <a href="https://www.rocketlabusa.com/">Rocket Lab USA Inc.</a>
</p>

SpaceX.razor:

<h2>SpaceX®</h2>

<p>
    SpaceX is a registered trademark of 
    <a href="https://www.spacex.com/">Space Exploration Technologies Corp.</a>
</p>

UnitedLaunchAlliance.razor:

<h2>United Launch Alliance®</h2>

<p>
    United Launch Alliance and ULA are registered trademarks of
    <a href="https://www.ulalaunch.com/">United Launch Alliance, LLC</a>.
</p>

VirginGalactic.razor:

<h2>Virgin Galactic®</h2>

<p>
    Virgin Galactic is a registered trademark of 
    <a href="https://www.virgingalactic.com/">Galactic Enterprises, LLC</a>.
</p>

DynamicComponent1.razor:

@page "/dynamic-component-1"

<PageTitle>Dynamic Component 1</PageTitle>

<h1>Dynamic Component Example 1</h1>

<p>
    <label>
        Select your transport:
        <select @onchange="OnDropdownChange">
            <option value="">Select a value</option>
            @foreach (var entry in components.Keys)
            {
                <option value="@entry">@entry</option>
            }
        </select>
    </label>
</p>

@if (selectedType is not null)
{
    <div class="border border-primary my-1 p-1">
        <DynamicComponent Type="selectedType" />
    </div>
}

@code {
    private readonly Dictionary<string, Type> components = new()
    {
        ["Rocket Lab"] = typeof(RocketLab),
        ["SpaceX"] = typeof(SpaceX),
        ["ULA"] = typeof(UnitedLaunchAlliance),
        ["Virgin Galactic"] = typeof(VirginGalactic)
    };
    private Type? selectedType;

    private void OnDropdownChange(ChangeEventArgs e)
    {
        if ((e.Value is string dropdownValue) && !String.IsNullOrWhiteSpace(dropdownValue))
        {
            selectedType = components[dropdownValue];
        }
        else
        {
            selectedType = null;
        }
    }
}

Dans l'exemple précédent :

• Il Dictionary<TKey,TValue> est utilisé pour gérer les composants à afficher.
• Les noms servent de clés de dictionnaire et sont fournis comme options de sélection.
• Les types de composants sont stockés en tant que valeurs de dictionnaire à l’aide de l’opérateur typeof.

Passer des paramètres

Si les composants rendus dynamiquement ont des paramètres de composant, passez-les dans le DynamicComponent en tant que IDictionary<string, object>. La string est le nom du paramètre et la object est la valeur du paramètre.

L’exemple suivant configure un objet de métadonnées de composant (ComponentMetadata) pour fournir des valeurs de paramètre aux composants rendus dynamiquement en fonction du nom de type. L’exemple n’est qu’une des nombreuses approches que vous pouvez adopter. Des données de paramètre peuvent également être fournies à partir d’une API web, d’une base de données ou d’une méthode. La seule exigence est que l’approche retourne un IDictionary<string, object>.

ComponentMetadata.cs:

namespace BlazorSample;

public class ComponentMetadata
{
    public required Type Type { get; init; }
    public required string Name { get; init; }
    public Dictionary<string, object> Parameters { get; } = [];
}

Le composant RocketLabWithWindowSeat suivant (RocketLabWithWindowSeat.razor) a été mis à jour à partir de l’exemple précédent pour inclure un paramètre de composant nommé WindowSeat pour spécifier si le passager préfère un siège côté fenêtre sur son vol :

RocketLabWithWindowSeat.razor:

<h2>Rocket Lab®</h2>

<p>
    User selected a window seat: @WindowSeat
</p>

<p>
    Rocket Lab is a trademark of 
    <a href="https://www.rocketlabusa.com/">Rocket Lab USA Inc.</a>
</p>

@code {
    [Parameter]
    public bool WindowSeat { get; set; }
}

Dans l’exemple suivant :

• Seul le paramètre du composant RocketLabWithWindowSeat pour un siège côté fenêtre (WindowSeat) reçoit la valeur de la case Window Seat.
• Les noms de composant sont utilisés comme valeurs d’option à l’aide de l’opérateur nameof, qui retourne les noms de composant sous forme de chaînes constantes.
• Les composants rendus dynamiquement sont des composants partagés :
  • Illustré dans cette section de l’article : RocketLabWithWindowSeat (RocketLabWithWindowSeat.razor)
  • Composants présentés dans la section Exemple plus haut dans cet article :
    • SpaceX (SpaceX.razor)
    • UnitedLaunchAlliance (UnitedLaunchAlliance.razor)
    • VirginGalactic (VirginGalactic.razor)

DynamicComponent2.razor:

@page "/dynamic-component-2"

<PageTitle>Dynamic Component 2</PageTitle>

<h1>Dynamic Component Example 2</h1>

<p>
    <label>
        <input type="checkbox" @bind="windowSeat" @bind:after="HandleWindowSeatChanged" />
        Window Seat (Rocket Lab only)
    </label>
</p>

<p>
    <label>
        Select your transport:
        <select @onchange="OnDropdownChange">
            <option value="">Select a value</option>
            @foreach (var c in components)
            {
                <option value="@c.Key">@c.Value.Name</option>
            }
        </select>
    </label>
</p>

@if (selectedComponent is not null)
{
    <div class="border border-primary my-1 p-1">
        <DynamicComponent Type="selectedComponent.Type"
            Parameters="selectedComponent.Parameters" />
    </div>
}

@code {
    private Dictionary<string, ComponentMetadata> components =
        new()
        {
            [nameof(RocketLabWithWindowSeat)] = new ComponentMetadata()
            {
                Type = typeof(RocketLabWithWindowSeat),
                Name = "Rocket Lab with Window Seat",
                Parameters = { [nameof(RocketLabWithWindowSeat.WindowSeat)] = false }
            },
            [nameof(VirginGalactic)] = new ComponentMetadata()
            {
                Type = typeof(VirginGalactic),
                Name = "Virgin Galactic"
            },
            [nameof(UnitedLaunchAlliance)] = new ComponentMetadata()
            {
                Type = typeof(UnitedLaunchAlliance),
                Name = "ULA"
            },
            [nameof(SpaceX)] = new ComponentMetadata()
            {
                Type = typeof(SpaceX),
                Name = "SpaceX"
            }
        };
    private ComponentMetadata? selectedComponent;
    private bool windowSeat;

    private void HandleWindowSeatChanged()
    {
        components[nameof(RocketLabWithWindowSeat)]
            .Parameters[nameof(RocketLabWithWindowSeat.WindowSeat)] = windowSeat;
    }

    private void OnDropdownChange(ChangeEventArgs e)
    {
        if ((e.Value is string dropdownValue) && !String.IsNullOrWhiteSpace(dropdownValue))
        {
            selectedComponent = components[dropdownValue];
        }
        else
        {
            selectedComponent = null;
        }
    }
}

Rappels d’événements (EventCallback)

Les rappels d’événements (EventCallback) peuvent être passés à un DynamicComponent dans son dictionnaire de paramètres.

ComponentMetadata.cs:

namespace BlazorSample;

public class ComponentMetadata
{
    public required Type Type { get; init; }
    public required string Name { get; init; }
    public Dictionary<string, object> Parameters { get; } = [];
}

Implémentez un paramètre de rappel d’événement (EventCallback) dans chaque composant rendu dynamiquement.

RocketLab2.razor:

<h2>Rocket Lab®</h2>

<p>
    Rocket Lab is a registered trademark of
    <a href="https://www.rocketlabusa.com/">Rocket Lab USA Inc.</a>
</p>

<button @onclick="OnClickCallback">
    Trigger a Parent component method
</button>

@code {
    [Parameter]
    public EventCallback<MouseEventArgs> OnClickCallback { get; set; }
}

SpaceX2.razor:

<h2>SpaceX®</h2>

<p>
    SpaceX is a registered trademark of
    <a href="https://www.spacex.com/">Space Exploration Technologies Corp.</a>
</p>

<button @onclick="OnClickCallback">
    Trigger a Parent component method
</button>

@code {
    [Parameter]
    public EventCallback<MouseEventArgs> OnClickCallback { get; set; }
}

UnitedLaunchAlliance2.razor:

<h2>United Launch Alliance®</h2>

<p>
    United Launch Alliance and ULA are registered trademarks of
    <a href="https://www.ulalaunch.com/">United Launch Alliance, LLC</a>.
</p>

<button @onclick="OnClickCallback">
    Trigger a Parent component method
</button>

@code {
    [Parameter]
    public EventCallback<MouseEventArgs> OnClickCallback { get; set; }
}

VirginGalactic2.razor:

<h2>Virgin Galactic®</h2>

<p>
    Virgin Galactic is a registered trademark of
    <a href="https://www.virgingalactic.com/">Galactic Enterprises, LLC</a>.
</p>

<button @onclick="OnClickCallback">
    Trigger a Parent component method
</button>

@code {
    [Parameter]
    public EventCallback<MouseEventArgs> OnClickCallback { get; set; }
}

Dans l’exemple de composant parent suivant, la méthode ShowDTMessage affecte une chaîne avec l’heure actuelle à message, et la valeur de message est rendue.

Le composant parent transmet la méthode de rappel, ShowDTMessage, dans le dictionnaire de paramètres :

• La clé string est le nom de la méthode de rappel, OnClickCallback.
• La valeur object est créée par EventCallbackFactory.Create pour la méthode de rappel parent, ShowDTMessage. Notez que le mot clé this n’est pas pris en charge dans les champs C#. Par conséquent, une propriété C# est utilisée pour le dictionnaire de paramètres.

DynamicComponent3.razor:

@page "/dynamic-component-3"

<PageTitle>Dynamic Component 3</PageTitle>

<h1>Dynamic Component Example 3</h1>

<p>
    <label>
        Select your transport:
        <select @onchange="OnDropdownChange">
            <option value="">Select a value</option>
            @foreach (var c in Components)
            {
                <option value="@c.Key">@c.Value.Name</option>
            }
        </select>
    </label>
</p>

@if (selectedComponent is not null)
{
    <div class="border border-primary my-1 p-1">
        <DynamicComponent Type="selectedComponent.Type"
            Parameters="selectedComponent.Parameters" />
    </div>
}

<p>
    @message
</p>

@code {
    private ComponentMetadata? selectedComponent;
    private string? message;

    private Dictionary<string, ComponentMetadata> Components =>
        new()
        {
            [nameof(RocketLab2)] = new ComponentMetadata()
            {
                Type = typeof(RocketLab2),
                Name = "Rocket Lab",
                Parameters = { [nameof(RocketLab2.OnClickCallback)] =
                    EventCallback.Factory.Create<MouseEventArgs>(this, ShowDTMessage) }
            },
            [nameof(VirginGalactic2)] = new ComponentMetadata()
            {
                Type = typeof(VirginGalactic2),
                Name = "Virgin Galactic",
                Parameters = { [nameof(VirginGalactic2.OnClickCallback)] =
                    EventCallback.Factory.Create<MouseEventArgs>(this, ShowDTMessage) }
            },
            [nameof(UnitedLaunchAlliance2)] = new ComponentMetadata()
            {
                Type = typeof(UnitedLaunchAlliance2),
                Name = "ULA",
                Parameters = { [nameof(UnitedLaunchAlliance2.OnClickCallback)] =
                    EventCallback.Factory.Create<MouseEventArgs>(this, ShowDTMessage) }
            },
            [nameof(SpaceX2)] = new ComponentMetadata()
            {
                Type = typeof(SpaceX2),
                Name = "SpaceX",
                Parameters = { [nameof(SpaceX2.OnClickCallback)] =
                    EventCallback.Factory.Create<MouseEventArgs>(this, ShowDTMessage) }
            }
        };

    private void OnDropdownChange(ChangeEventArgs e)
    {
        if ((e.Value is string dropdownValue) && !String.IsNullOrWhiteSpace(dropdownValue))
        {
            selectedComponent = Components[dropdownValue];
        }
        else
        {
            selectedComponent = null;
        }
    }

    private void ShowDTMessage(MouseEventArgs e) =>
        message = $"The current DT is: {DateTime.Now}.";
}

Éviter les paramètres fourre-tout

Évitez l’utilisation de paramètres fourre-tout. Si des paramètres fourre-tout sont utilisés, chaque paramètre explicite sur DynamicComponent est effectivement un mot réservé que vous ne pouvez pas passer à un enfant dynamique. Tous les nouveaux paramètres passés à DynamicComponent sont un changement cassant, car ils commencent à remplacer les paramètres de composant enfant qui portent le même nom. Il est peu probable que l’appelant connaisse toujours un ensemble fixe de noms de paramètres à passer à tous les enfants dynamiques possibles.

Marques déposées

Rocket Lab est une marque déposée de Rocket Lab USA Inc. SpaceX est une marque déposée de Space Exploration Technologies Corp. United Launch Alliance et ULA sont des marques déposées de United Launch Alliance, LLC. Virgin Galactic est une marque déposée de Galactic Enterprises, LLC.

Ressources supplémentaires

• Gestion des événements ASP.NET Core Blazor
• DynamicComponent