SteveSandersonMS
commented
1 year ago Also stuff in M.A.C.Web:
namespace Microsoft.AspNetCore.Components.Web
{
+ /// <summary>
+ /// Provides pre-constructed <see cref="IComponentRenderMode"/> instances that may be used during rendering.
+ /// </summary>
+ public static class RenderMode
+ {
+ /// <summary>
+ /// Gets an <see cref="IComponentRenderMode"/> that represents rendering interactively on the server via Blazor Server hosting
+ /// with server-side prerendering.
+ /// </summary>
+ public static ServerRenderMode Server { get; } = new();
+
+ /// <summary>
+ /// Gets an <see cref="IComponentRenderMode"/> that represents rendering interactively on the client via Blazor WebAssembly hosting
+ /// with server-side prerendering.
+ /// </summary>
+ public static WebAssemblyRenderMode WebAssembly { get; } = new();
+
+ /// <summary>
+ /// Gets an <see cref="IComponentRenderMode"/> that means the render mode will be determined automatically based on a policy.
+ /// </summary>
+ public static AutoRenderMode Auto { get; } = new();
+ }
+ /// <summary>
+ /// A <see cref="IComponentRenderMode"/> indicating that the component should be rendered interactively on the server using Blazor Server hosting.
+ /// </summary>
+ public class ServerRenderMode : IComponentRenderMode
+ {
+ /// <summary>
+ /// Constructs an instance of <see cref="ServerRenderMode"/>.
+ /// </summary>
+ public ServerRenderMode() : this(true) {}
+
+ /// <summary>
+ /// Constructs an instance of <see cref="ServerRenderMode"/>
+ /// </summary>
+ /// <param name="prerender">A flag indicating whether the component should first prerender on the server. The default value is true.</param>
+ public ServerRenderMode(bool prerender) {}
+
+ /// <summary>
+ /// A flag indicating whether the component should first prerender on the server. The default value is true.
+ /// </summary>
+ public bool Prerender { get; }
+ }
+
+ /// <summary>
+ /// A <see cref="IComponentRenderMode"/> indicating that the component should be rendered on the client using WebAssembly.
+ /// </summary>
+ public class WebAssemblyRenderMode : IComponentRenderMode
+ {
+ /// <summary>
+ /// Constructs an instance of <see cref="WebAssemblyRenderMode"/>.
+ /// </summary>
+ public WebAssemblyRenderMode() : this(true) {}
+
+ /// <summary>
+ /// Constructs an instance of <see cref="WebAssemblyRenderMode"/>
+ /// </summary>
+ /// <param name="prerender">A flag indicating whether the component should first prerender on the server. The default value is true.</param>
+ public WebAssemblyRenderMode(bool prerender) {}
+
+ /// <summary>
+ /// A flag indicating whether the component should first prerender on the server. The default value is true.
+ /// </summary>
+ public bool Prerender { get; }
+ }
+
+ /// <summary>
+ /// A <see cref="IComponentRenderMode"/> indicating that the component's render mode should be determined automatically based on a policy.
+ /// </summary>
+ public class AutoRenderMode : IComponentRenderMode
+ {
+ /// <summary>
+ /// Constructs an instance of <see cref="AutoRenderMode"/>.
+ /// </summary>
+ public AutoRenderMode() : this(true) {}
+
+ /// <summary>
+ /// Constructs an instance of <see cref="AutoRenderMode"/>
+ /// </summary>
+ /// <param name="prerender">A flag indicating whether the component should first prerender on the server. The default value is true.</param>
+ public AutoRenderMode(bool prerender) {}
+
+ /// <summary>
+ /// A flag indicating whether the component should first prerender on the server. The default value is true.
+ /// </summary>
+ public bool Prerender { get; }
+ }
+ // TEMPORARY
+ public class RenderModeServerAttribute : RenderModeAttribute
+ {
+ public RenderModeServerAttribute() : this(true)
+ public RenderModeServerAttribute(bool prerender) {}
+ public override IComponentRenderMode Mode { get; }
+ }
+
+ // TEMPORARY
+ public class RenderModeWebAssemblyAttribute : RenderModeAttribute
+ {
+ public RenderModeWebAssemblyAttribute() : this(true)
+ public RenderModeWebAssemblyAttribute(bool prerender) {}
+ public override IComponentRenderMode Mode { get; }
+ }
+
+ // TEMPORARY
+ public class RenderModeAutoAttribute : RenderModeAttribute
+ {
+ public RenderModeAutoAttribute() : this(true)
+ public RenderModeAutoAttribute(bool prerender) {}
+ public override IComponentRenderMode Mode { get; }
+ }
}
halter73
Background and Motivation
Server-side rendering for components in .NET 8. This is a pretty immense set of changes accounting for much of the work we've done for the release.
The team decided early on not to attempt to do API review for each piece as it was implemented, because there was too much churn as the designs evolved. As such it's now a huge review-bomb, but I think most of it should be quite understandable with a bit of explanation.
I'm trying to split up the API reviews into thematic areas and this one is meant to focus on rendermodes. However some other smaller, tangential bits have snuck in here too and that's probably fine.
Proposed API