Enhance Button docs and add rich enum metadata

- Improved Button component documentation: renamed and expanded sections, added enum documentation tables.
- Added [AddedVersion], [DefaultValue], and [Description] attributes to all Button parameters, methods, and enums for better API documentation.
- Updated XML comments for clarity and consistency; clarified default values.
- Made ChildContent, LoadingTemplate, and TooltipTitle nullable.
- Replaced buttons.jpg with updated buttons.png for documentation visuals.

Author: gvreddy04

BlazorBootstrap.Demo.RCL/Components/Pages/Docs/Buttons/Buttons_Doc_01_Documentation.razor

@@ -14,16 +14,40 @@
     <img src="@imageUrl" class="img-fluid" alt="@metaTitle" />
 </Section>
 
-<Section Class="p-0" Size="HeadingSize.H3" Name="Parameters" PageUrl="@pageUrl" Link="parameters">
+<Section Class="p-0" Size="HeadingSize.H3" Name="Button Parameters" PageUrl="@pageUrl" Link="button-parameters">
     <DocxTable TItem="Button" DocType="DocType.Parameters" />
 </Section>
 
-<Section Class="p-0" Size="HeadingSize.H3" Name="Methods" PageUrl="@pageUrl" Link="methods">
+<Section Class="p-0" Size="HeadingSize.H3" Name="Button Methods" PageUrl="@pageUrl" Link="button-methods">
     <DocxTable TItem="Button" DocType="DocType.Methods" />
 </Section>
 
-<Section Class="p-0" Size="HeadingSize.H3" Name="Events" PageUrl="@pageUrl" Link="events">
-    <DocxTable TItem="Button" DocType="DocType.Events" />
+<Section Class="p-0" Size="HeadingSize.H3" Name="ButtonColor Enum" PageUrl="@pageUrl" Link="button-color-enum">
+    <DocxTable TItem="ButtonColor" DocType="DocType.Enum" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="ButtonSize Enum" PageUrl="@pageUrl" Link="button-size-enum">
+    <DocxTable TItem="ButtonSize" DocType="DocType.Enum" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="ButtonType Enum" PageUrl="@pageUrl" Link="button-type-enum">
+    <DocxTable TItem="ButtonType" DocType="DocType.Enum" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="Position Enum" PageUrl="@pageUrl" Link="position-enum">
+    <DocxTable TItem="Position" DocType="DocType.Enum" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="Target Enum" PageUrl="@pageUrl" Link="target-enum">
+    <DocxTable TItem="Target" DocType="DocType.Enum" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="TooltipColor Enum" PageUrl="@pageUrl" Link="tooltip-color-enum">
+    <DocxTable TItem="TooltipColor" DocType="DocType.Enum" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="TooltipPlacement Enum" PageUrl="@pageUrl" Link="tooltip-placement-enum">
+    <DocxTable TItem="TooltipPlacement" DocType="DocType.Enum" />
 </Section>
 
 @code {

…L/wwwroot/images/screenshots/buttons.jpg …L/wwwroot/images/screenshots/buttons.pngBlazorBootstrap.Demo.RCL/wwwroot/images/screenshots/buttons.jpg renamed to BlazorBootstrap.Demo.RCL/wwwroot/images/screenshots/buttons.png BlazorBootstrap.Demo.RCL/wwwroot/images/screenshots/buttons.jpg renamed to BlazorBootstrap.Demo.RCL/wwwroot/images/screenshots/buttons.png

@@ -143,6 +143,8 @@ protected override async Task OnParametersSetAsync()
     /// <summary>
     /// Hides the loading state and enables the button.
     /// </summary>
+    [AddedVersion("1.0.0")]
+    [Description("Hides the loading state and enables the button.")]
     public void HideLoading()
     {
         Loading = false;
@@ -154,6 +156,8 @@ public void HideLoading()
     /// Shows the loading state and disables the button.
     /// </summary>
     /// <param name="text"></param>
+    [AddedVersion("1.0.0")]
+    [Description("Shows the loading state and disables the button.")]
     public void ShowLoading(string text = "")
     {
         LoadingText = text;
@@ -296,167 +300,226 @@ private void SetAttributes()
 
     /// <summary>
     /// Gets or sets the button active state.
+    /// <para>
+    /// Default value is <see langword="false"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is false.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(false)]
+    [Description("Gets or sets the button active state.")]
     [Parameter]
     public bool Active { get; set; }
 
     /// <summary>
     /// Gets or sets the block level button.
+    /// <para>
+    /// Default value is <see langword="false"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is false.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(false)]
+    [Description("Gets or sets the block level button.")]
     [Parameter]
     public bool Block { get; set; }
 
     private string buttonTypeString => Type.ToButtonTypeString()!;
 
     /// <summary>
     /// Gets or sets the content to be rendered within the component.
+    /// <para>
+    /// Default value is <see langword="null"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is null.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the content to be rendered within the component.")]
+    [ParameterTypeName("RenderFragment?")]
     [Parameter]
-    public RenderFragment ChildContent { get; set; } = default!;
+    public RenderFragment? ChildContent { get; set; }
 
     /// <summary>
     /// Gets or sets the button color.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see cref="ButtonColor.None" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(ButtonColor.None)]
+    [Description("Gets or sets the button color.")]
     [Parameter]
     public ButtonColor Color { get; set; } = ButtonColor.None;
 
     /// <summary>
     /// Gets or sets the button disabled state.
+    /// <para>
+    /// Default value is <see langword="false"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is false.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(false)]
+    [Description("Gets or sets the button disabled state.")]
     [Parameter]
     public bool Disabled { get; set; }
 
     /// <summary>
     /// If <see langword="true" />, shows the loading spinner or a <see cref="LoadingTemplate" />.
+    /// <para>
+    /// Default value is <see langword="false"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is false.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(false)]
+    [Description("If <b>true</b>, shows the loading spinner or a <b>LoadingTemplate</b>.")]
     [Parameter]
     public bool Loading { get; set; }
 
     /// <summary>
     /// Gets or sets the button loading template.
+    /// <para>
+    /// Default value is <see langword="null"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is null.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the button loading template.")]
+    [ParameterTypeName("RenderFragment?")]
     [Parameter]
-    public RenderFragment LoadingTemplate { get; set; } = default!;
+    public RenderFragment? LoadingTemplate { get; set; }
 
     /// <summary>
-    /// Gets or sets the loading text.
-    /// <see cref="LoadingTemplate" /> takes precedence.
-    /// </summary>
-    /// <remarks>
+    /// Gets or sets the loading text. <see cref="LoadingTemplate" /> takes precedence.
+    /// <para>
     /// Default value is 'Loading...'.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue("Loading...")]
+    [Description("Gets or sets the loading text. <b>LoadingTemplate</b> takes precedence.")]
+    [ParameterTypeName("")]
     [Parameter]
     public string LoadingText { get; set; } = "Loading...";
 
     /// <summary>
     /// Gets or sets the button outline.
+    /// <para>
+    /// Default value is <see langword="false"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is false.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(false)]
+    [Description("Gets or sets the button outline.")]
     [Parameter]
     public bool Outline { get; set; }
 
     /// <summary>
     /// Gets or sets the position.
     /// Use <see cref="Position" /> to modify a <see cref="Badge" /> and position it in the corner of a link or button.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see cref="Position.None" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(Position.None)]
+    [Description("Gets or sets the position. Use <b>Position</b> to modify a <b>Badge</b> and position it in the corner of a link or button.")]
     [Parameter]
     public Position Position { get; set; } = Position.None;
 
     /// <summary>
     /// Gets or sets the button size.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see cref="ButtonSize.None" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(ButtonSize.None)]
+    [Description("Gets or sets the button size.")]
     [Parameter]
     public ButtonSize Size { get; set; } = ButtonSize.None;
 
     /// <summary>
     /// Gets or sets the button tab index.
+    /// <para>
+    /// Default value is <see langword="null"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is null.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the button tab index.")]
+    [ParameterTypeName("int?")]
     [Parameter]
     public int? TabIndex { get; set; }
 
     /// <summary>
     /// Gets or sets the link button target.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see cref="Target.None" />
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(Target.None)]
+    [Description("Gets or sets the link button target.")]
     [Parameter]
     public Target Target { get; set; } = Target.None;
 
     /// <summary>
     /// Gets or sets the link button href attribute.
+    /// <para>
+    /// Default value is <see langword="null"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is null.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the link button href attribute.")]
+    [ParameterTypeName("string?")]
     [Parameter]
     public string? To { get; set; }
 
     /// <summary>
     /// Gets or sets the button tooltip color.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see cref="TooltipColor.None" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.10.0")]
+    [DefaultValue(TooltipColor.None)]
+    [Description("Gets or sets the button tooltip color.")]
     [Parameter]
     public TooltipColor TooltipColor { get; set; } = TooltipColor.None;
 
     /// <summary>
     /// Gets or sets the button tooltip placement.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see cref="TooltipPlacement.Top" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(TooltipPlacement.Top)]
+    [Description("Gets or sets the button tooltip placement.")]
     [Parameter]
     public TooltipPlacement TooltipPlacement { get; set; } = TooltipPlacement.Top;
 
     /// <summary>
     /// Gets or sets the button tooltip title.
+    /// <para>
+    /// Default value is <see langword="null"/>.
+    /// </para>
     /// </summary>
-    /// <remarks>
-    /// Default value is null.
-    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the button tooltip title.")]
+    [ParameterTypeName("string?")]
     [Parameter]
-    public string TooltipTitle { get; set; } = default!;
+    public string? TooltipTitle { get; set; }
 
     /// <summary>
     /// Gets or sets the button type.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see cref="ButtonType.Button" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(ButtonType.Button)]
+    [Description("Gets or sets the button type.")]
     [Parameter]
     public ButtonType Type { get; set; } = ButtonType.Button;
 

blazorbootstrap/Components/Button/Button.razor.cs

@@ -1,11 +1,49 @@
 namespace BlazorBootstrap;
 
+/// <summary>
+/// Defines the supported size options for a BlazorBootstrap button.
+/// </summary>
 public enum ButtonSize
 {
+    /// <summary>
+    /// Indicates that the default size is used.
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [Description("Indicates that the default size is used.")]
     None,
+
+    /// <summary>
+    /// Indicates an extra-small size option.
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [Description("Indicates an extra-small size option.")]
     ExtraSmall,
+
+    /// <summary>
+    /// Indicates a small size option.
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [Description("Indicates a small size option.")]
     Small,
+
+    /// <summary>
+    /// Indicates a medium size option.
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [Description("Indicates a medium size option.")]
     Medium,
+
+    /// <summary>
+    /// Indicates a large size option.
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [Description("Indicates a large size option.")]
     Large,
+
+    /// <summary>
+    /// Indicates an extra-large size option.
+    /// </summary>
+    [AddedVersion("1.0.0")]
+    [Description("Indicates an extra-large size option.")]
     ExtraLarge
 }