Update grid docs, metadata, and add new screenshots (#1235)

* Update grid docs, metadata, and add new screenshots

Standardize XML docs for Blazor grid parameters, add API metadata attributes, and improve type safety by making parameters nullable where appropriate. Remove obsolete PaginationAlignment parameter. Update demo screenshot references and add new image files for grid features, nested grids, and translations. No functional changes; all updates are documentation, API surface, or demo assets.

* Update AdditionalAttributes to nullable; fix docs section order

Changed AdditionalAttributes to nullable in base components for Blazor convention compliance. Cleaned up Grid documentation by removing duplicate and misplaced "GridColumn Parameters" sections and improving order.

* Add API metadata attributes and improve null-safety

Added [AddedVersion], [DefaultValue], and [Description] attributes to public properties and methods in Grid-related components for enhanced documentation and tooling support. Updated several RenderFragment properties to be nullable and removed default initializations for better null-safety. Annotated new public methods and events with version and description metadata. These changes improve API discoverability and maintainability.

Author: gvreddy04

BlazorBootstrap.Demo.RCL/Components/Pages/Docs/Grid/Grid_Doc_01_Documentation.razor

@@ -15,43 +15,55 @@
 </Section>
 
 <Section Class="p-0" Size="HeadingSize.H3" Name="Grid Parameters" PageUrl="@pageUrl" Link="grid-parameters">
-    <DocxTable TItem="Grid<object>" DocType="DocType.Parameters" />
+    <DocxTable TItem="Grid<TItem>" DocType="DocType.Parameters" />
 </Section>
 
 <Section Class="p-0" Size="HeadingSize.H3" Name="Grid Methods" PageUrl="@pageUrl" Link="grid-methods">
-    <DocxTable TItem="Grid<object>" DocType="DocType.Methods" />
+    <DocxTable TItem="Grid<TItem>" DocType="DocType.Methods" />
 </Section>
 
 <Section Class="p-0" Size="HeadingSize.H3" Name="Grid Events" PageUrl="@pageUrl" Link="grid-events">
-    <DocxTable TItem="Grid<object>" DocType="DocType.Events" />
+    <DocxTable TItem="Grid<TItem>" DocType="DocType.Events" />
 </Section>
 
-<Section Class="p-0" Size="HeadingSize.H3" Name="GridColumn Parameters" PageUrl="@pageUrl" Link="grid-column-parameters">
-    <DocxTable TItem="GridColumn<object>" DocType="DocType.Parameters" />
+<Section Class="p-0" Size="HeadingSize.H3" Name="GridSettings Properties" PageUrl="@pageUrl" Link="grid-settings-properties">
+    <DocxTable TItem="GridSettings" DocType="DocType.Properties" />
 </Section>
 
 <Section Class="p-0" Size="HeadingSize.H3" Name="GridColumns Parameters" PageUrl="@pageUrl" Link="grid-columns-parameters">
     <DocxTable TItem="GridColumns" DocType="DocType.Parameters" />
 </Section>
 
 <Section Class="p-0" Size="HeadingSize.H3" Name="GridColumn Parameters" PageUrl="@pageUrl" Link="grid-column-parameters">
-    <DocxTable TItem="GridColumn<object>" DocType="DocType.Parameters" />
+    <DocxTable TItem="GridColumn<TItem>" DocType="DocType.Parameters" />
 </Section>
 
 <Section Class="p-0" Size="HeadingSize.H3" Name="GridDetailView Parameters" PageUrl="@pageUrl" Link="grid-detailview-parameters">
-    <DocxTable TItem="GridDetailView<object>" DocType="DocType.Parameters" />
+    <DocxTable TItem="GridDetailView<TItem>" DocType="DocType.Parameters" />
 </Section>
 
-<Section Class="p-0" Size="HeadingSize.H3" Name="GridSettings Properties" PageUrl="@pageUrl" Link="grid-settings-properties">
-    <DocxTable TItem="GridSettings" DocType="DocType.Properties" />
+<Section Class="p-0" Size="HeadingSize.H3" Name="GridTemplates Parameters" PageUrl="@pageUrl" Link="grid-templates-parameters">
+    <DocxTable TItem="GridTemplates" DocType="DocType.Parameters" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="GridEmptyDataTemplate Parameters" PageUrl="@pageUrl" Link="grid-empty-data-templates-parameters">
+    <DocxTable TItem="GridEmptyDataTemplate<TItem>" DocType="DocType.Parameters" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="GridLoadingTemplate Parameters" PageUrl="@pageUrl" Link="grid-loading-template-parameters">
+    <DocxTable TItem="GridLoadingTemplate<TItem>" DocType="DocType.Parameters" />
 </Section>
 
 @code {
-    private const string componentName = nameof(Grid<object>);
+    private const string componentName = nameof(Grid<TItem>);
     private const string pageUrl = DemoRouteConstants.Docs_URL_Grid;
     private const string pageTitle = componentName;
     private const string pageDescription = $"This documentation provides a comprehensive reference for the <code>{componentName}</code> component, guiding you through its configuration options.";
     private const string metaTitle = $"Blazor {componentName} Component";
     private const string metaDescription = $"This documentation provides a comprehensive reference for the {componentName} component, guiding you through its configuration options.";
     private const string imageUrl = DemoScreenshotSrcConstants.Demos_URL_Grid_Overview;
+
+    public class TItem : object
+    {
+    }
 }

BlazorBootstrap.Demo.RCL/Constants/DemoScreenshotSrcConstants.cs

@@ -50,15 +50,15 @@ public class DemoScreenshotSrcConstants
 
     #region Grid
     public const string Demos_URL_Grid_Prefix = DemoScreenshotSrcPrefix + "grid.png";
-    public const string Demos_URL_Grid_Overview = DemoScreenshotSrcPrefix + "home.png";
+    public const string Demos_URL_Grid_Overview = DemoScreenshotSrcPrefix + "grid_fixed_header_freeze_columns.png";
     public const string Demos_URL_Grid_Alignment = DemoScreenshotSrcPrefix + "home.png";
     public const string Demos_URL_Grid_CustomCSSClass = DemoScreenshotSrcPrefix + "home.png";
     public const string Demos_URL_Grid_DataBinding = DemoScreenshotSrcPrefix + "home.png";
     public const string Demos_URL_Grid_DetailView = DemoScreenshotSrcPrefix + "home.png";
     public const string Demos_URL_Grid_Events = DemoScreenshotSrcPrefix + "home.png";
     public const string Demos_URL_Grid_Filters = DemoScreenshotSrcPrefix + "home.png";
-    public const string Demos_URL_Grid_FixedHeader = DemoScreenshotSrcPrefix + "home.png";
-    public const string Demos_URL_Grid_FreezeColumns = DemoScreenshotSrcPrefix + "home.png";
+    public const string Demos_URL_Grid_FixedHeader = DemoScreenshotSrcPrefix + "grid_fixed_header_freeze_columns.png";
+    public const string Demos_URL_Grid_FreezeColumns = DemoScreenshotSrcPrefix + "grid_fixed_header_freeze_columns.png";
     public const string Demos_URL_Grid_Settings = DemoScreenshotSrcPrefix + "home.png";
     public const string Demos_URL_Grid_NestedGrid = DemoScreenshotSrcPrefix + "home.png";
     public const string Demos_URL_Grid_Paging = DemoScreenshotSrcPrefix + "home.png";

BlazorBootstrap.Demo.RCL/wwwroot/images/screenshots/grid_detail_view.png

@@ -148,7 +148,7 @@ protected virtual ValueTask DisposeAsyncCore(bool disposing)
     [Description("Gets or sets additional attributes that will be applied to the component.")]
     [ParameterTypeName("Dictionary<string, object>")]
     [Parameter(CaptureUnmatchedValues = true)]
-    public Dictionary<string, object> AdditionalAttributes { get; set; } = default!;
+    public Dictionary<string, object>? AdditionalAttributes { get; set; }
 
     /// <summary>
     /// Gets or sets the CSS class name(s) to apply to the component.

BlazorBootstrap.Demo.RCL/wwwroot/images/screenshots/grid_fixed_header_freeze_columns.png

@@ -141,7 +141,7 @@ protected virtual ValueTask DisposeAsyncCore(bool disposing)
     [Description("Gets or sets additional attributes that will be applied to the component.")]
     [Parameter(CaptureUnmatchedValues = true)]
     [ParameterTypeName("Dictionary<string, object>")]
-    public Dictionary<string, object> AdditionalAttributes { get; set; } = default!;
+    public Dictionary<string, object>? AdditionalAttributes { get; set; }
 
     /// <summary>
     /// Gets or sets the CSS class name(s) to apply to the component.