doc(Comments): support auto generate attribute table component in extensions (#7524)

* Initial plan

* Replace AttributeTable Items with Name parameter in all sample files

Co-authored-by: ArgoZhang <22001478+ArgoZhang@users.noreply.github.com>

* Clean up orphaned XML comments after GetAttributes removal

Co-authored-by: ArgoZhang <22001478+ArgoZhang@users.noreply.github.com>

* refactor: 移除不使用的私有变量

* refactor: 更改参数为可为空

* refactor: 增加 BootstrapBlazor 注释文档变量

* refactor: 移除默认值

* refactor: 支持扩展组件包参数

* refactor: 临时提交

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ArgoZhang <22001478+ArgoZhang@users.noreply.github.com>
Co-authored-by: Argo Zhang <argo@live.ca>

Author: Copilot

src/BootstrapBlazor.Server/Components/Samples/Ajaxs.razor.cs

@@ -63,11 +63,6 @@ class User
     private Task Goto() => AjaxService.Goto("/introduction");
 
     private Task GotoSelf() => AjaxService.Goto("/ajax");
-
-    /// <summary>
-    /// 获得属性方法
-    /// </summary>
-    /// <returns></returns>
     private List<MethodItem> GetMethods() =>
     [
         new()

src/BootstrapBlazor.Server/Components/Samples/CheckboxLists.razor.cs

@@ -18,7 +18,6 @@ public partial class CheckboxLists
         EnumEducation.Middle, EnumEducation.Primary
     };
 
-
     [NotNull]
     private IEnumerable<SelectedItem>? Items1 { get; set; }
 

src/BootstrapBlazor.Server/Components/Samples/EmbedPdfs.razor.cs

@@ -13,7 +13,6 @@ public partial class EmbedPdfs
     private EmbedPDFTheme _theme = EmbedPDFTheme.System;
     private EmbedPDFScrollStrategy _strategy = EmbedPDFScrollStrategy.Vertical;
     private string _url = "./samples/sample.pdf";
-    private string _streamFileName = "";
     private string _language = "";
 
     private List<SelectedItem> _languages = new List<SelectedItem>() {

src/BootstrapBlazor.Server/Components/Samples/FlipClocks.razor.cs

@@ -34,7 +34,6 @@ public partial class FlipClocks
 
     private string CardGroupMarginValueString => $"{CardGroupMarginValue}px";
 
-
     private bool _isCompleted;
     private bool _showYear = false;
     private bool _showMonth = false;

src/BootstrapBlazor.Server/Components/Samples/Translators.razor.cs

@@ -48,11 +48,6 @@ private static string FormatResult(TranslationText translation)
         var culture = new CultureInfo(translation.TargetLanguage);
         return $"{culture.NativeName}: {translation.Text}";
     }
-
-    /// <summary>
-    /// 获得属性方法
-    /// </summary>
-    /// <returns></returns>
     protected MethodItem[] GetMethods() =>
     [
         new()

src/BootstrapBlazor.Server/Data/AttributeItem.cs

@@ -13,32 +13,32 @@ public class AttributeItem
     /// <summary>
     /// 获得/设置 参数
     /// </summary>
-    public string Name { get; set; } = "";
+    public string? Name { get; set; }
 
     /// <summary>
     /// 获得/设置 说明
     /// </summary>
-    public string Description { get; set; } = "";
+    public string? Description { get; set; }
 
     /// <summary>
     /// 获得/设置 类型
     /// </summary>
-    public string Type { get; set; } = "";
+    public string? Type { get; set; }
 
     /// <summary>
     /// 获得/设置 可选值
     /// </summary>
-    public string ValueList { get; set; } = "";
+    public string? ValueList { get; set; }
 
     /// <summary>
     /// 获得/设置 版本
     /// </summary>
-    public string Version { get; set; } = "10.2.2";
+    public string? Version { get; set; }
 
     /// <summary>
     /// 获得/设置 默认值
     /// </summary>
-    public string DefaultValue { get; set; } = "";
+    public string? DefaultValue { get; set; }
 
     /// <summary>
     /// 获得/设置 是否已弃用

src/BootstrapBlazor.Server/Services/ComponentAttributeCacheService.cs

@@ -18,6 +18,8 @@ public static class ComponentAttributeCacheService
 {
     private static readonly ConcurrentDictionary<string, List<AttributeItem>> _cache = new();
 
+    private static XDocument? _xmlDoc;
+
     /// <summary>
     /// 通过组件类型获取组件的 AttributeItem 列表
     /// </summary>
@@ -43,13 +45,21 @@ private static List<AttributeItem> GetAttributeCore(Type type)
                 .ToArray();
         }
 
-        var xmlDoc = GetXmlDocumentation(type.Assembly);
+        // 获得 BootstrapBlazor 程序集 xml 文档
+        _xmlDoc ??= GetXmlDocumentation(typeof(BootstrapBlazorRoot).Assembly);
+        XDocument? xmlDoc = null;
+        if (type.Assembly.GetName().Name != "BootstrapBlazor")
+        {
+            // 扩展组件包
+            xmlDoc = GetXmlDocumentation(type.Assembly);
+        }
+
         return properties.Select(property => new AttributeItem
         {
             Name = property.Name,
             Type = GetFriendlyTypeName(property.PropertyType),
             Description = GetSummary(xmlDoc, property) ?? "",
-            Version = GetVersion(xmlDoc, property) ?? "10.0.0",
+            Version = GetVersion(xmlDoc, property),
             IsObsolete = property.GetCustomAttribute<ObsoleteAttribute>() != null
         }).OrderBy(i => i.Name).ToList();
     }
@@ -59,18 +69,19 @@ private static List<AttributeItem> GetAttributeCore(Type type)
     /// </summary>
     private static string? GetSummary(XDocument? xmlDoc, PropertyInfo property)
     {
-        if (xmlDoc == null) return null;
-
         var type = property.DeclaringType ?? property.PropertyType;
-        var typeName = type.FullName ?? $"BootstrapBlazor.Components.{type.Name}";
+        var typeName = $"BootstrapBlazor.Components.{type.Name}";
         var memberName = $"P:{typeName}.{property.Name}";
         var summaryElement = FindSummaryElement(xmlDoc, memberName);
         return summaryElement == null ? null : GetLocalizedSummary(summaryElement);
     }
 
-    private static XElement? FindSummaryElement(XDocument xmlDoc, string memberName)
+    private static XElement? FindSummaryElement(XDocument? xmlDoc, string memberName)
     {
-        var memberElement = xmlDoc.Descendants("member")
+        // 如果 xmlDoc 为空表示为 BootstrapBlazor 组件
+        var memberElement = xmlDoc?.Descendants("member")
+            .FirstOrDefault(x => x.Attribute("name")?.Value == memberName)
+            ?? _xmlDoc?.Descendants("member")
             .FirstOrDefault(x => x.Attribute("name")?.Value == memberName);
 
         var summaryElement = memberElement?.Element("summary");
@@ -79,8 +90,8 @@ private static List<AttributeItem> GetAttributeCore(Type type)
             return null;
         }
 
-        var doc = summaryElement.Element("inheritdoc")?.Attribute("cref")?.Value;
-        return doc != null ? FindSummaryElement(xmlDoc, doc) : summaryElement;
+        var v = summaryElement.Element("inheritdoc")?.Attribute("cref")?.Value;
+        return v != null ? FindSummaryElement(xmlDoc, v) : summaryElement;
     }
 
     private static string? GetLocalizedSummary(XElement? summaryElement)