• 10 minutes

Dans cet exercice, vous utilisez tout ce que vous avez appris jusqu’à présent pour ajouter une page de liste de tâches de base à votre application Blazor.

Créer la page de liste de tâches

1. Créez un projet d’application web Blazor.

2. Ajouter un fichier Todo.razor au dossier Components/Pages

   Dans Visual Studio et Visual Studio Code, vous pouvez ajouter le fichier Razor en cliquant avec le bouton droit sur le dossier Components/Pages dans l’Explorateur de solutions et en sélectionnant l’option appropriée pour ajouter un nouveau fichier.

   Vous pouvez également créer le fichier Razor à l’aide de l’interface CLI .NET avec cette commande :

   dotnet new razorcomponent -n Todo -o Components/Pages
   

   L’option -n|--name de la commande précédente spécifie le nom du nouveau composant Razor. Le nouveau composant est créé dans le dossier Components/Pages du projet avec l’option -o|--output.

   Important

   Les noms de fichier des composants Razor doivent avoir leur première lettre en majuscule afin de pouvoir les distinguer facilement des autres éléments HTML.

3. Ouvrez le composant Todo et ajoutez une directive Razor @page en haut du fichier avec l’URL relative de /todo et définissez le mode de rendu sur InteractiveServer pour que le composant puisse gérer les événements de l’interface utilisateur.

   @page "/todo"
   @rendermode InteractiveServer
   
   <h3>Todo</h3>
   
   @code {
   
   }
   

4. Appliquez les modifications à l’application et essayez d’accéder à « /todo » pour voir votre nouvelle page.

Ajouter la page de tâches au menu de navigation

La nouvelle page de liste de tâches n’apparaît pas encore dans le menu de navigation avec les autres pages existantes. Le menu de navigation est défini dans le composant NavMenu, qui fait partie de la disposition de l’application. Nous allons mettre à jour le composant NavMenu pour ajouter un lien vers la page de liste des tâches.

1. Ouvrez Components/Layout/NavMenu.razor.

2. Recherchez l’élément nav dans le composant NavMenu et ajoutez l’élément div suivant sous l’élément de navigation existant de la page météo.

   <div class="nav-item px-3">
       <NavLink class="nav-link" href="todo">
           <span class="bi bi-list-nested-nav-menu" aria-hidden="true"></span> Todo
       </NavLink>
   </div>
   

   Le composant NavLink est un composant Blazor intégré qui affiche une balise d’ancrage. Si l’adresse actuelle du navigateur correspond au href du NavLink, elle affiche également une classe CSS active que vous pouvez utiliser pour le style du lien.

   Après avoir appliqué cette modification, vous devriez maintenant voir la page Todo apparaître dans le menu de navigation.

   

Créer une liste d’éléments de tâche

1. Créez un fichier TodoItem.cs à la racine du projet (niveau identique à Program.cs) et ajoutez-y la classe C# suivante.

   public class TodoItem
   {
       public string? Title { get; set; }
       public bool IsDone { get; set; } = false;
   }
   

2. Dans Todo.razor, ajoutez un champ pour la liste des éléments de tâche dans le bloc @code.

   @code {
       private List<TodoItem> todos = new();
   }
   

3. Affichez une liste non ordonnée de toutes les tâches à l’aide d’une boucle foreach.

   <ul>
       @foreach (var todo in todos)
       {
           <li>@todo.Title</li>
       }
   </ul>
   

   Vous ne voyez pas encore quoi que ce soit d’affiché dans la liste de tâches parce que celle-ci est vide. Vous avez besoin d’un moyen d’ajouter des éléments de tâche.

Ajouter une tâche

Ajoutons quelques éléments d’interface utilisateur pour ajouter des éléments de tâche à notre liste.

1. Dans Todo.razor, ajoutez une balise input et un button sous la liste non ordonnée.

   <input />
   <button>Add todo</button>
   

2. Créez un champ de chaîne newTodo et liez-le à input en utilisant l’attribut de directive @bind.

   <input @bind="newTodo" />
   <button>Add todo</button>
   
   @code {
       private List<TodoItem> todos = new();
       string newTodo = "";
   }
   

3. Ajoutez un gestionnaire @onclick au button qui ajoute un nouveau TodoItem à la liste todos en fonction de la valeur de newTodo, puis réinitialise la valeur de newTodo avec une chaîne vide.

   <input @bind="newTodo" />
   <button @onclick="AddTodo">Add todo</button>
   
   @code {
       private List<TodoItem> todos = new();
       string newTodo = "";
   
       void AddTodo()
       {
           if (!string.IsNullOrWhiteSpace(newTodo))
           {
               todos.Add(new TodoItem { Title = newTodo });
               newTodo = string.Empty;
           }
       }
   }
   

4. Vérifiez que vous pouvez maintenant ajouter des éléments de tâche et qu’ils apparaissent dans la liste. La valeur input doit également être réinitialisée après l’ajout de chaque élément de tâche.

Ajouter des cases à cocher et compter les éléments de tâches non traités

Vous avez besoin d’un moyen de marquer les éléments de tâche comme traités, de modifier les tâches existantes et de compter le nombre d’éléments qu’il reste à traiter.

1. Mettez à jour le contenu de l’élément li pour afficher un input de type checkbox qui est lié à todo.IsDone et un texte input qui est lié à todo.Title.

   <ul>
       @foreach (var todo in todos)
       {
           <li>
               <input type="checkbox" @bind="todo.IsDone" />
               <input @bind="todo.Title" />
           </li>
       }
   </ul>    
   

2. Mettez à jour l’en-tête <h3> pour afficher le nombre d’éléments todo qui ne sont pas terminés (IsDone est false).

   <h3>Todo (@todos.Count(todo => !todo.IsDone))</h3>
   

3. Après avoir appliqué les modifications à l’application, essayez d’ajouter des éléments, de modifier des éléments et de marquer des éléments de tâche comme étant traités pour tester le composant.

   

Votre liste de tâches Blazor est maintenant terminée ✅.