22 KiB

Raw Blame History

title

author

description

monikerRange

ms.author

ms.custom

ms.date

no-loc

uid

zone_pivot_groups

Build a Blazor todo list app

guardrex

Build a Blazor app step-by-step.

>= aspnetcore-3.1

riande

mvc

02/12/2021

Home

Privacy

Kestrel

appsettings.json

ASP.NET Core Identity

Blazor

Blazor Server

Blazor WebAssembly

Identity

Let's Encrypt

Razor

SignalR

tutorials/build-a-blazor-app

blazor-hosting-models

Build a Blazor todo list app

::: moniker range=">= aspnetcore-6.0"

This tutorial shows you how to build and modify a Blazor app. You learn how to:

[!div class="checklist"]

Create a todo list Blazor app project

Modify Razor components

Use event handling and data binding in components

Use routing in a Blazor app

At the end of this tutorial, you'll have a working todo list app.

Prerequisites

[!INCLUDE]

Create a Blazor app

Create a new Blazor app named TodoList in a command shell:

::: zone pivot="server"

dotnet new blazorserver -o TodoList

::: zone-end

::: zone pivot="webassembly"

dotnet new blazorwasm -o TodoList

::: zone-end

The preceding command creates a folder named TodoList with the -o|--output option to hold the app. The TodoList folder is the root folder of the project. Change directories to the TodoList folder with the following command:

cd TodoList

Build a todo list Blazor app

Add a new Todo Razor component to the app using the following command:
```
dotnet new razorcomponent -n Todo -o Pages
```
The -n|--name option in the preceding command specifies the name of the new Razor component. The new component is created in the project's Pages folder with the -o|--output option.

[!IMPORTANT] Razor component file names require a capitalized first letter. Open the Pages folder and confirm that the Todo component file name starts with a capital letter T. The file name should be Todo.razor.
Open the Todo component in any file editor and add an @page Razor directive to the top of the file with a relative URL of /todo.

Pages/Todo.razor:

[!code-razor]

Save the Pages/Todo.razor file.
Add the Todo component to the navigation bar.

The NavMenu component is used in the app's layout. Layouts are components that allow you to avoid duplication of content in an app. The NavLink component provides a cue in the app's UI when the component URL is loaded by the app.

In the navigation element content (<nav class="flex-column">) of the NavMenu component, add the following <div> element for the Todo component.

In Shared/NavMenu.razor:

[!code-razor]

Save the Shared/NavMenu.razor file.
Build and run the app by executing the dotnet watch run command in the command shell from the TodoList folder. After the app is running, visit the new Todo page by selecting the Todo link in the app's navigation bar, which loads the page at /todo.

Leave the app running the command shell. Each time a file is saved, the app is automatically rebuilt, and the page in the browser is automatically reloaded.
Add a TodoItem.cs file to the root of the project (the TodoList folder) to hold a class that represents a todo item. Use the following C# code for the TodoItem class.

TodoItem.cs:

[!code-csharp]
[!NOTE] If using Visual Studio to create the TodoItem.cs file and TodoItem class, use either of the following approaches:
- Remove the namespace that Visual Studio generates for the class.
- Use the Copy button in the preceding code block and replace the entire contents of the file that Visual Studio generates.
Return to the Todo component and perform the following tasks:
- Add a field for the todo items in the @code block. The Todo component uses this field to maintain the state of the todo list.
- Add unordered list markup and a foreach loop to render each todo item as a list item (<li>).
Pages/Todo.razor:

[!code-razor]
The app requires UI elements for adding todo items to the list. Add a text input (<input>) and a button (<button>) below the unordered list (<ul>...</ul>):

[!code-razor]
Save the TodoItem.cs file and the updated Pages/Todo.razor file. In the command shell, the app is automatically rebuilt when the files are saved. The browser reloads the page.
When the Add todo button is selected, nothing happens because an event handler isn't attached to the button.
Add an AddTodo method to the Todo component and register the method for the button using the @onclick attribute. The AddTodo C# method is called when the button is selected:

[!code-razor]
To get the title of the new todo item, add a newTodo string field at the top of the @code block:

[!code-razor]

Modify the text <input> element to bind newTodo with the @bind attribute:
```
<input placeholder="Something todo" @bind="newTodo" />
```
Update the AddTodo method to add the TodoItem with the specified title to the list. Clear the value of the text input by setting newTodo to an empty string:

[!code-razor]
Save the Pages/Todo.razor file. The app is automatically rebuilt in the command shell, and the page reloads in the browser.
The title text for each todo item can be made editable, and a checkbox can help the user keep track of completed items. Add a checkbox input for each todo item and bind its value to the IsDone property. Change @todo.Title to an <input> element bound to todo.Title with @bind:
```
<ul>
    @foreach (var todo in todos)
    {
        <li>
            <input type="checkbox" @bind="todo.IsDone" />
            <input @bind="todo.Title" />
        </li>
    }
</ul>
```
Update the <h1> header to show a count of the number of todo items that aren't complete (IsDone is false).
```
<h1>Todo (@todos.Count(todo => !todo.IsDone))</h1>
```
The completed Todo component (Pages/Todo.razor):

[!code-razor]
Save the Pages/Todo.razor file. The app is automatically rebuilt in the command shell, and the page reloads in the browser.
Add items, edit items, and mark todo items done to test the component.
When finished, shut down the app in the command shell. Many command shells accept the keyboard command Ctrl+c to stop an app.

Next steps

In this tutorial, you learned how to:

[!div class="checklist"]

Create a todo list Blazor app project

Modify Razor components

Use event handling and data binding in components

Use routing in a Blazor app

Learn about tooling for ASP.NET Core Blazor:

[!div class="nextstepaction"] xref:blazor/tooling

::: moniker-end

::: moniker range=">= aspnetcore-5.0 < aspnetcore-6.0"

This tutorial shows you how to build and modify a Blazor app. You learn how to:

[!div class="checklist"]

Create a todo list Blazor app project

Modify Razor components

Use event handling and data binding in components

Use routing in a Blazor app

At the end of this tutorial, you'll have a working todo list app.

Prerequisites

[!INCLUDE]

Create a Blazor app

Create a new Blazor app named TodoList in a command shell:

::: zone pivot="server"

dotnet new blazorserver -o TodoList

::: zone-end

::: zone pivot="webassembly"

dotnet new blazorwasm -o TodoList

::: zone-end

cd TodoList

Build a todo list Blazor app

Add a new Todo Razor component to the app using the following command:
```
dotnet new razorcomponent -n Todo -o Pages
```
The -n|--name option in the preceding command specifies the name of the new Razor component. The new component is created in the project's Pages folder with the -o|--output option.

[!IMPORTANT] Razor component file names require a capitalized first letter. Open the Pages folder and confirm that the Todo component file name starts with a capital letter T. The file name should be Todo.razor.
Open the Todo component in any file editor and add an @page Razor directive to the top of the file with a relative URL of /todo.

Pages/Todo.razor:

[!code-razor]

Save the Pages/Todo.razor file.
Add the Todo component to the navigation bar.

The NavMenu component is used in the app's layout. Layouts are components that allow you to avoid duplication of content in an app. The NavLink component provides a cue in the app's UI when the component URL is loaded by the app.

In the unordered list (<ul>...</ul>) of the NavMenu component, add the following list item (<li>...</li>) and NavLink component for the Todo component.

In Shared/NavMenu.razor:

[!code-razor]

Save the Shared/NavMenu.razor file.
Build and run the app by executing the dotnet watch run command in the command shell from the TodoList folder. After the app is running, visit the new Todo page by selecting the Todo link in the app's navigation bar, which loads the page at /todo.

Leave the app running the command shell. Each time a file is saved, the app is automatically rebuilt, and the page in the browser is automatically reloaded.
Add a TodoItem.cs file to the root of the project (the TodoList folder) to hold a class that represents a todo item. Use the following C# code for the TodoItem class.

TodoItem.cs:

[!code-csharp]
[!NOTE] If using Visual Studio to create the TodoItem.cs file and TodoItem class, use either of the following approaches:
- Remove the namespace that Visual Studio generates for the class.
- Use the Copy button in the preceding code block and replace the entire contents of the file that Visual Studio generates.
Return to the Todo component and perform the following tasks:
- Add a field for the todo items in the @code block. The Todo component uses this field to maintain the state of the todo list.
- Add unordered list markup and a foreach loop to render each todo item as a list item (<li>).
Pages/Todo.razor:

[!code-razor]
The app requires UI elements for adding todo items to the list. Add a text input (<input>) and a button (<button>) below the unordered list (<ul>...</ul>):

[!code-razor]
Save the TodoItem.cs file and the updated Pages/Todo.razor file. In the command shell, the app is automatically rebuilt when the files are saved. The browser reloads the page.
When the Add todo button is selected, nothing happens because an event handler isn't attached to the button.
Add an AddTodo method to the Todo component and register the method for the button using the @onclick attribute. The AddTodo C# method is called when the button is selected:

[!code-razor]
To get the title of the new todo item, add a newTodo string field at the top of the @code block:

[!code-razor]

Modify the text <input> element to bind newTodo with the @bind attribute:
```
<input placeholder="Something todo" @bind="newTodo" />
```
Update the AddTodo method to add the TodoItem with the specified title to the list. Clear the value of the text input by setting newTodo to an empty string:

[!code-razor]
Save the Pages/Todo.razor file. The app is automatically rebuilt in the command shell, and the page reloads in the browser.
The title text for each todo item can be made editable, and a checkbox can help the user keep track of completed items. Add a checkbox input for each todo item and bind its value to the IsDone property. Change @todo.Title to an <input> element bound to todo.Title with @bind:
```
<ul>
    @foreach (var todo in todos)
    {
        <li>
            <input type="checkbox" @bind="todo.IsDone" />
            <input @bind="todo.Title" />
        </li>
    }
</ul>
```
Update the <h1> header to show a count of the number of todo items that aren't complete (IsDone is false).
```
<h1>Todo (@todos.Count(todo => !todo.IsDone))</h1>
```
The completed Todo component (Pages/Todo.razor):

[!code-razor]
Save the Pages/Todo.razor file. The app is automatically rebuilt in the command shell, and the page reloads in the browser.
Add items, edit items, and mark todo items done to test the component.
When finished, shut down the app in the command shell. Many command shells accept the keyboard command Ctrl+c to stop an app.

Next steps

In this tutorial, you learned how to:

[!div class="checklist"]

Create a todo list Blazor app project

Modify Razor components

Use event handling and data binding in components

Use routing in a Blazor app

Learn about tooling for ASP.NET Core Blazor:

[!div class="nextstepaction"] xref:blazor/tooling

::: moniker-end

::: moniker range="< aspnetcore-5.0"

This tutorial shows you how to build and modify a Blazor app. You learn how to:

[!div class="checklist"]

Create a todo list Blazor app project

Modify Razor components

Use event handling and data binding in components

Use routing in a Blazor app

At the end of this tutorial, you'll have a working todo list app.

Prerequisites

[!INCLUDE]

Create a Blazor app

Create a new Blazor app named TodoList in a command shell:

::: zone pivot="server"

dotnet new blazorserver -o TodoList

::: zone-end

::: zone pivot="webassembly"

dotnet new blazorwasm -o TodoList

::: zone-end

cd TodoList

Build a todo list Blazor app

Add a new Todo Razor component to the app using the following command:
```
dotnet new razorcomponent -n Todo -o Pages
```
The -n|--name option in the preceding command specifies the name of the new Razor component. The new component is created in the project's Pages folder with the -o|--output option.

[!IMPORTANT] Razor component file names require a capitalized first letter. Open the Pages folder and confirm that the Todo component file name starts with a capital letter T. The file name should be Todo.razor.
Open the Todo component in any file editor and add an @page Razor directive to the top of the file with a relative URL of /todo.

Pages/Todo.razor:

[!code-razor]

Save the Pages/Todo.razor file.
Add the Todo component to the navigation bar.

The NavMenu component is used in the app's layout. Layouts are components that allow you to avoid duplication of content in an app. The NavLink component provides a cue in the app's UI when the component URL is loaded by the app.

In the unordered list (<ul>...</ul>) of the NavMenu component, add the following list item (<li>...</li>) and NavLink component for the Todo component.

In Shared/NavMenu.razor:

[!code-razor]

Save the Shared/NavMenu.razor file.
Build and run the app by executing the dotnet watch run command in the command shell from the TodoList folder. After the app is running, visit the new Todo page by selecting the Todo link in the app's navigation bar, which loads the page at /todo.

Leave the app running the command shell. Each time a file is saved, the app is automatically rebuilt, and the page in the browser is automatically reloaded.
Add a TodoItem.cs file to the root of the project (the TodoList folder) to hold a class that represents a todo item. Use the following C# code for the TodoItem class.

TodoItem.cs:

[!code-csharp]
[!NOTE] If using Visual Studio to create the TodoItem.cs file and TodoItem class, use either of the following approaches:
- Remove the namespace that Visual Studio generates for the class.
- Use the Copy button in the preceding code block and replace the entire contents of the file that Visual Studio generates.
Return to the Todo component and perform the following tasks:
- Add a field for the todo items in the @code block. The Todo component uses this field to maintain the state of the todo list.
- Add unordered list markup and a foreach loop to render each todo item as a list item (<li>).
Pages/Todo.razor:

[!code-razor]
The app requires UI elements for adding todo items to the list. Add a text input (<input>) and a button (<button>) below the unordered list (<ul>...</ul>):

[!code-razor]
Save the TodoItem.cs file and the updated Pages/Todo.razor file. In the command shell, the app is automatically rebuilt when the files are saved. The browser reloads the page.
When the Add todo button is selected, nothing happens because an event handler isn't attached to the button.
Add an AddTodo method to the Todo component and register the method for the button using the @onclick attribute. The AddTodo C# method is called when the button is selected:

[!code-razor]
To get the title of the new todo item, add a newTodo string field at the top of the @code block:

[!code-razor]

Modify the text <input> element to bind newTodo with the @bind attribute:
```
<input placeholder="Something todo" @bind="newTodo" />
```
Update the AddTodo method to add the TodoItem with the specified title to the list. Clear the value of the text input by setting newTodo to an empty string:

[!code-razor]
Save the Pages/Todo.razor file. The app is automatically rebuilt in the command shell, and the page reloads in the browser.
The title text for each todo item can be made editable, and a checkbox can help the user keep track of completed items. Add a checkbox input for each todo item and bind its value to the IsDone property. Change @todo.Title to an <input> element bound to todo.Title with @bind:
```
<ul>
    @foreach (var todo in todos)
    {
        <li>
            <input type="checkbox" @bind="todo.IsDone" />
            <input @bind="todo.Title" />
        </li>
    }
</ul>
```
Update the <h1> header to show a count of the number of todo items that aren't complete (IsDone is false).
```
<h1>Todo (@todos.Count(todo => !todo.IsDone))</h1>
```
The completed Todo component (Pages/Todo.razor):

[!code-razor]
Save the Pages/Todo.razor file. The app is automatically rebuilt in the command shell, and the page reloads in the browser.
Add items, edit items, and mark todo items done to test the component.
When finished, shut down the app in the command shell. Many command shells accept the keyboard command Ctrl+c to stop an app.

Next steps

In this tutorial, you learned how to:

[!div class="checklist"]

Create a todo list Blazor app project

Modify Razor components

Use event handling and data binding in components

Use routing in a Blazor app

Learn about tooling for ASP.NET Core Blazor:

[!div class="nextstepaction"] xref:blazor/tooling

::: moniker-end

22 KiB Raw Blame History

Build a Blazor todo list app

Prerequisites

Create a Blazor app

Build a todo list Blazor app

Next steps

Prerequisites

Create a Blazor app

Build a todo list Blazor app

Next steps

Prerequisites

Create a Blazor app

Build a todo list Blazor app

Next steps

22 KiB

Raw Blame History