Title here
Summary here
Content
This guide introduces two Razor components specifically designed to integrate with Htmx for content rendering within ASP.NET applications. These components are RzPage and RzPartial. Both are used by Rizzy to render Blazor components as full pages or partial HTML fragments in response to requests, often initiated by HTMX.
Caution
It is not typical that you will need to invoke either of these two components directly. This documentation is provided simply to describe how they are intended to function.
RzPage
RzPage is a Razor component that acts as a page container. It cascades the RzViewContext value across the component tree it encompasses. RzPage is typically not used directly and is instead utilized by the RzController View<T> method or the RizzyService View<T> method.
Key Features
- Dynamically renders Razor components as full pages.
- Wraps a component of your choice inside the Rizzy-configured RootComponent.
- Supports dynamic layout selection based on attributes or Rizzy application configuration.
Usage
- Configuration involves specifying
ComponentType,ComponentParameters, and providing aViewContextfor the component being rendered. - If the component that is provided by ComponentType has a @layout attribute, that layout will be applied to the page. If it doesn’t, then the default layout specified in the Rizzy configuration will be applied. See Getting Started.
RzPartial
Similar to RzPage, RzPartial is designed for rendering Razor components as partial views. It follows the same dynamic rendering principles but defaults to using an EmptyLayout, making it ideal for embedding within other views or components without inheriting the parent’s layout.
Key Features
- Renders Razor components as partial views without a layout.
- Suitable for dynamic content loading and updating within existing pages.
Usage
- Like
RzPage,RzPartialis rendered through services or controllers, specifyingComponentTypeandComponentParameters. - Primarily used for injecting dynamic content into specific sections of a page, enhancing modularity and reusability of components.
Special Notes
Both RizzyService and RzController provide methods like View<T> and PartialView<T> which internally use RzPage or RzPartial to render Blazor components. They handle passing parameters, cascading ModelState (in RzController), and setting up the render context. They also provide helpers like CurrentActionUrl.