One blank line appears between the directives and the first line of Razor markup.Įxample: IJSRuntime ILogger Loggerĭirective attributes: Change the way a component element is parsed or functions. No blank lines appear among the directives. Third-party API namespaces (alphabetical order).Microsoft namespaces (alphabetical order).

System namespaces (alphabetical order).You're free to use a custom ordering scheme and format in your own apps.ĭocumentation and sample app Razor directive order: For example, Blazor framework Identity components include blank lines between blocks of directives and blocks of directives. Components provided by a Blazor project template may differ from the following order and use a different format. The following order is adopted by Blazor sample apps and documentation. For repeated directives, directives are placed alphabetically by namespace or type, except directives, which have special second-level ordering. razor file) are placed in a consistent order. For example, the directive specifies a routable component with a route template and can be reached directly by a user's request in the browser at a specific URL.īy convention, a component's directives at the top of a component definition (. These are reserved keywords prefixed with that appear in Razor markup:ĭirectives: Change the way component markup is parsed or functions.

Two Razor features are extensively used by components, directives and directive attributes. Developer-built components that implement IComponent can take low-level control over rendering at the cost of having to manually trigger rendering with events and lifecycle methods that the developer must create and maintain. razor) or base their components on ComponentBase, but components can also be built by implementing IComponent.

For more information, see How to select a version tag of ASP.NET Core source code (dotnet/AspNetCore.Docs #26205).ĭevelopers typically create Razor components from Razor component files (. To select a tag for a specific release, use the Switch branches or tags dropdown list. NET reference source usually load the repository's default branch, which represents the current development for the next release of. However, keep in mind that the internal implementations of component features are subject to change at any time without notice.ĭocumentation links to. ComponentBase defines component properties and methods for basic functionality, for example, to process a set of built-in component lifecycle events.ĬomponentBase in dotnet/aspnetcore reference source: The reference source contains additional remarks on the built-in lifecycle events. ComponentBase implements the lowest abstraction of components, the IComponent interface. razor file extension.īy default, ComponentBase is the base class for components described by Razor component files. View components, which are for rendering chunks of content rather than whole responses in Razor Pages and MVC apps.Ĭomponents are implemented using a combination of C# and HTML markup in Razor component files with the.Razor views, which are Razor-based markup pages for MVC apps.Components can be nested, reused, shared among projects, and used in MVC and Razor Pages apps.Ĭomponents render into an in-memory representation of the browser's Document Object Model (DOM) called a render tree, which is used to update the UI in a flexible and efficient way.Īlthough 'Razor components' shares some naming with other ASP.NET Core content-rendering technologies, Razor components must be distinguished from the following different features in ASP.NET Core: A component is a self-contained portion of user interface (UI) with processing logic to enable dynamic behavior. Razor componentsīlazor apps are built using Razor components, informally known as Blazor components or only components. This article explains how to create and use Razor components in Blazor apps, including guidance on Razor syntax, component naming, namespaces, and component parameters. Microsoft makes no warranties, express or implied, with respect to the information provided here.įor the current release, see the. This information relates to a pre-release product that may be substantially modified before it's commercially released.

Fragments time out of mind