doc(AttributeTable): support base type parameter (#7554)

* chore: 调整样式

* doc: 更新注释

* feat: 增加基类参数支持

* chore: 精简逻辑

Author: ArgoZhang

src/BootstrapBlazor.Server/Components/Components/AttributeTable.razor.css

@@ -8,5 +8,6 @@
 }
 
 .table-attr-mark {
-    font-size: 90%;
+    font-size: 85%;
+    color: var(--bs-success);
 }

src/BootstrapBlazor.Server/Directory.Build.targets

@@ -19,7 +19,7 @@
       <XmlDocsToCopy Include="%(Reference.RelativeDir)BootstrapBlazor*.xml" />
     </ItemGroup>
     <Message Text="Copying XML docs to output path: $(OutputPath)" Importance="High" />
-    <Copy SourceFiles="@(XmlDocsToCopy)" DestinationFolder="$(OutputPath)" SkipUnchangedFiles="true" Condition="Exists('%(RootDir)%(Directory)%(Filename)%(Extension)')" />
+    <Copy SourceFiles="@(XmlDocsToCopy)" DestinationFolder="$(OutputPath)" />
   </Target>
 
 </Project>

src/BootstrapBlazor.Server/Services/ComponentAttributeCacheService.cs

@@ -60,7 +60,9 @@ private static List<AttributeItem> GetAttributeCore(Type type)
     {
         if (xmlDoc == null) return null;
 
-        var memberName = $"P:{property.DeclaringType?.FullName}.{property.Name}";
+        var type = property.DeclaringType ?? property.PropertyType;
+        var typeName = type.FullName ?? $"BootstrapBlazor.Components.{type.Name}";
+        var memberName = $"P:{typeName}.{property.Name}";
         var summaryElement = FindSummaryElement(xmlDoc, memberName);
         return summaryElement == null ? null : GetLocalizedSummary(summaryElement);
     }

src/BootstrapBlazor/Components/Display/DisplayBase.cs

@@ -15,13 +15,13 @@ namespace BootstrapBlazor.Components;
 public abstract class DisplayBase<TValue> : BootstrapModuleComponentBase
 {
     /// <summary>
-    /// <para lang="zh">是否显示 标签</para>
+    /// <para lang="zh">是否显示标签</para>
     /// <para lang="en">Whether to Show Label</para>
     /// </summary>
     protected bool IsShowLabel { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得 the <see cref="FieldIdentifier"/> for the bound value.</para>
+    /// <para lang="zh">获得绑定值的 <see cref="FieldIdentifier"/>。</para>
     /// <para lang="en">Gets the <see cref="FieldIdentifier"/> for the bound value.</para>
     /// </summary>
     protected FieldIdentifier? FieldIdentifier { get; set; }
@@ -40,7 +40,7 @@ public abstract class DisplayBase<TValue> : BootstrapModuleComponentBase
     protected Type? ValueType { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得/设置 the value of the input. This should be used with two-way binding.</para>
+    /// <para lang="zh">获得/设置 输入组件的值，支持双向绑定。</para>
     /// <para lang="en">Gets or sets the value of the input. This should be used with two-way binding.</para>
     /// </summary>
     /// <example>
@@ -51,28 +51,28 @@ public abstract class DisplayBase<TValue> : BootstrapModuleComponentBase
     public TValue? Value { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得/设置 a 回调 that updates the bound value.</para>
+    /// <para lang="zh">获得/设置 用于更新绑定值的回调。</para>
     /// <para lang="en">Gets or sets a callback that updates the bound value.</para>
     /// </summary>
     [Parameter]
     public EventCallback<TValue?> ValueChanged { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得/设置 an expression that identifies the bound value.</para>
+    /// <para lang="zh">获得/设置 标识绑定值的表达式。</para>
     /// <para lang="en">Gets or sets an expression that identifies the bound value.</para>
     /// </summary>
     [Parameter]
     public Expression<Func<TValue?>>? ValueExpression { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得/设置 是否显示前置标签 默认值为 null 为空时默认不显示标签</para>
+    /// <para lang="zh">获得/设置 是否显示前置标签，默认值为 null，为空时不显示标签</para>
     /// <para lang="en">Gets or sets Whether to Show Label. Default is null, not show label when null</para>
     /// </summary>
     [Parameter]
     public bool? ShowLabel { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得/设置 是否显示 Tooltip 多用于文字过长导致裁减时使用 默认 null</para>
+    /// <para lang="zh">获得/设置 是否显示 Tooltip，多用于文字过长导致裁剪时使用，默认 null</para>
     /// <para lang="en">Gets or sets Whether to Show Tooltip. Default is null</para>
     /// </summary>
     [Parameter]
@@ -93,29 +93,28 @@ public abstract class DisplayBase<TValue> : BootstrapModuleComponentBase
     protected ValidateForm? ValidateForm { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得 IShowLabel 实例</para>
-    /// <para lang="en">Get IShowLabel Instance</para>
+    /// <para lang="zh">获得 <see cref="IShowLabel"/> 实例</para>
+    /// <para lang="en">Get <see cref="IShowLabel"/> Instance</para>
     /// </summary>
     [CascadingParameter(Name = "EditorForm")]
     protected IShowLabel? EditorForm { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得 InputGroup 实例</para>
-    /// <para lang="en">Get InputGroup Instance</para>
+    /// <para lang="zh">获得 <see cref="BootstrapInputGroup"/> 实例</para>
+    /// <para lang="en">Get <see cref="BootstrapInputGroup"/> Instance</para>
     /// </summary>
     [CascadingParameter]
     protected BootstrapInputGroup? InputGroup { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得 IFilter 实例</para>
-    /// <para lang="en">Get IFilter Instance</para>
+    /// <para lang="zh">获得 <see cref="IFilter"/> 实例</para>
+    /// <para lang="en">Get <see cref="IFilter"/> Instance</para>
     /// </summary>
     [CascadingParameter]
     protected IFilter? Filter { get; set; }
 
     /// <summary>
-    /// <para lang="zh">SetParametersAsync 方法</para>
-    /// <para lang="en">SetParametersAsync Method</para>
+    /// <inheritdoc/>
     /// </summary>
     /// <param name="parameters"></param>
     public override Task SetParametersAsync(ParameterView parameters)
@@ -135,8 +134,7 @@ public override Task SetParametersAsync(ParameterView parameters)
     }
 
     /// <summary>
-    /// <para lang="zh">OnParametersSet 方法</para>
-    /// <para lang="en">OnParametersSet Method</para>
+    /// <inheritdoc/>
     /// </summary>
     protected override void OnParametersSet()
     {
@@ -185,7 +183,6 @@ protected override void OnParametersSet()
     /// <para lang="en">Format Value to String Method</para>
     /// </summary>
     /// <param name="value">The value to format.</param>
-    /// <returns>A string representation of the value.</returns>
     protected virtual string? FormatValueAsString(TValue? value)
     {
         string? ret;

src/BootstrapBlazor/Components/Validate/ValidateBase.cs

@@ -42,8 +42,8 @@ public abstract class ValidateBase<TValue> : DisplayBase<TValue>, IValidateCompo
     protected string? ErrorMessage { get; set; }
 
     /// <summary>
-    /// <para lang="zh">获得/设置 数据合规样式</para>
-    /// <para lang="en">Gets or sets the validation CSS class</para>
+    /// <para lang="zh">获得 数据合规样式</para>
+    /// <para lang="en">Gets the validation CSS class</para>
     /// </summary>
     protected string? ValidCss => IsValid.HasValue ? GetValidString(IsValid.Value) : null;
 
@@ -62,7 +62,7 @@ public abstract class ValidateBase<TValue> : DisplayBase<TValue>, IValidateCompo
     protected string? Disabled => IsDisabled ? "disabled" : null;
 
     /// <summary>
-    /// <para lang="zh">是否显示 必填项标记</para>
+    /// <para lang="zh">获得/设置 是否显示 必填项标记</para>
     /// <para lang="en">Gets or sets whether to display the required field marker</para>
     /// </summary>
     protected string? Required { get; set; }