feat(ISearchFormItemMetadata): add RenderContent method

src/BootstrapBlazor.Server/Locales/zh-CN.json

@@ -5065,8 +5065,8 @@
     "EditModelTitle": "编辑测试数据窗口",
     "NamePlaceholder": "请输入姓名，50字以内",
     "SearchFormDesc": "使用 <code>UseSearchForm</code> 开启搜索表单时未提供 <code>SearchItems</code> 默认尝试使用设置 <code>Searchable=\"true\"</code> 的 <code>TableColumn</code> 进行构建，可以通过 <code>TableColumn</code> 中的 <code>SearchFormItemMetadata</code> 属性定制化元数据",
-    "SearchFormTips": "开启 <code>UseSearchForm</code> 后 <code>SearchTemplate</code> <code>CustomerSearchModel</code> <code>CustomerSearchTemplate</code> 均不生效",
     "SearchFormIntro": "通过设置 <code>UseSearchForm=\"true\"</code> 开启搜索表单功能，通过 <code>SearchItems</code> 配置搜索表单内搜索项，适用于自定义复杂搜索条件的场景",
+    "SearchFormTips": "开启 <code>UseSearchForm</code> 后 <code>SearchTemplate</code> <code>CustomerSearchModel</code> <code>CustomerSearchTemplate</code> 均不生效",
     "SearchFormTitle": "搜索表单",
     "SearchTableGroupBoxText": "搜索条件",
     "SearchTableIntro": "设置 <code>ShowSearch</code> 显示查询组件，通过设置 <code>SearchTemplate</code> 模板自定义搜索 UI",

src/BootstrapBlazor/Components/SearchForm/SearchForm.razor.cs

@@ -145,26 +145,18 @@ private RenderFragment AutoGenerateTemplate(ISearchItem item)
             if (OnChanged != null)
             {
                 var filter = Items.ToFilter();
-                await OnChanged.Invoke(filter);
+                await OnChanged(filter);
             }
         };
 
-        return item.CreateSearchItemComponentByMetadata();
+        return item.Metadata.RenderContent() ?? item.CreateSearchItemComponentByMetadata();
     }
 
     private SearchFormLocalizerOptions? _options;
 
     private SearchFormLocalizerOptions GetSearchOptions()
     {
-        _options ??= SearchFormLocalizerOptions ?? new SearchFormLocalizerOptions()
-        {
-            SelectAllText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.SelectAllText)],
-            BooleanAllText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.BooleanAllText)],
-            BooleanTrueText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.BooleanTrueText)],
-            BooleanFalseText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.BooleanFalseText)],
-            NumberStartValueLabelText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.NumberStartValueLabelText)],
-            NumberEndValueLabelText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.NumberEndValueLabelText)]
-        };
+        _options ??= SearchFormLocalizerOptions ?? SearchFormLocalizer.GetSearchFormLocalizerOptions();
 
         return _options.Value;
     }

src/BootstrapBlazor/Components/Searches/DateTimeRangeSearchMetadata.cs

@@ -9,7 +9,7 @@ namespace BootstrapBlazor.Components;
 /// <para lang="zh">时间区间搜索元数据类</para>
 /// <para lang="en">DateTime range search meta data class</para>
 /// </summary>
-public class DateTimeRangeSearchMetadata : SearchMetadataBase
+public class DateTimeRangeSearchMetadata : SearchFormItemMetadataBase
 {
     /// <summary>
     /// <para lang="zh">获得/设置 搜索值</para>

src/BootstrapBlazor/Components/Searches/DateTimeSearchMetadata.cs

@@ -9,7 +9,7 @@ namespace BootstrapBlazor.Components;
 /// <para lang="zh">时间搜索元数据类</para>
 /// <para lang="en">DateTime search meta data class</para>
 /// </summary>
-public class DateTimeSearchMetadata : SearchMetadataBase
+public class DateTimeSearchMetadata : SearchFormItemMetadataBase
 {
     /// <summary>
     /// <para lang="zh">获得/设置 搜索值</para>

src/BootstrapBlazor/Components/Searches/ISearchFormItemMetadata.cs

@@ -58,4 +58,11 @@ public interface ISearchFormItemMetadata
     /// <para lang="en">Reset method</para>
     /// </summary>
     void Reset();
+
+    /// <summary>
+    /// <para lang="zh">渲染自定义内容方法</para>
+    /// <para lang="en">Render custom content method</para>
+    /// </summary>
+    /// <returns></returns>
+    RenderFragment? RenderContent();
 }

src/BootstrapBlazor/Components/Searches/MultipleSelectSearchMetadata.cs

@@ -12,7 +12,7 @@ namespace BootstrapBlazor.Components;
 public class MultipleSelectSearchMetadata : SelectSearchMetadata
 {
     /// <summary>
-    /// <inheritdoc cref="SearchMetadataBase.GetFilter(string)"/>
+    /// <inheritdoc cref="SearchFormItemMetadataBase.GetFilter(string)"/>
     /// </summary>
     public override FilterKeyValueAction? GetFilter(string fieldName)
     {

src/BootstrapBlazor/Components/Searches/NumberSearchMetadata.cs

@@ -9,7 +9,7 @@ namespace BootstrapBlazor.Components;
 /// <para lang="zh">数字类型搜索元数据类</para>
 /// <para lang="en">Number type search metadata class</para>
 /// </summary>
-public class NumberSearchMetadata : SearchMetadataBase
+public class NumberSearchMetadata : SearchFormItemMetadataBase
 {
     /// <summary>
     /// <para lang="zh">获得/设置 搜索开始值</para>

src/BootstrapBlazor/Components/Searches/SearchMetadataBase.cs → src/BootstrapBlazor/Components/Searches/SearchFormItemMetadataBase.cs

@@ -11,7 +11,7 @@ namespace BootstrapBlazor.Components;
 /// <para lang="zh">搜索元数据基类</para>
 /// <para lang="en">Search meta data base class</para>
 /// </summary>
-public abstract class SearchMetadataBase : ISearchFormItemMetadata
+public abstract class SearchFormItemMetadataBase : ISearchFormItemMetadata
 {
     /// <summary>
     /// <para lang="zh">获得/设置 占位符文本</para>
@@ -72,7 +72,13 @@ public abstract class SearchMetadataBase : ISearchFormItemMetadata
     }
 
     /// <summary>
-    /// <inheritdoc/>
+    /// <inheritdoc cref="ISearchFormItemMetadata.Reset"/>
     /// </summary>
     public abstract void Reset();
+
+    /// <summary>
+    /// <inheritdoc cref="ISearchFormItemMetadata.RenderContent"/>
+    /// </summary>
+    /// <returns></returns>
+    public virtual RenderFragment? RenderContent() => null;
 }

src/BootstrapBlazor/Components/Searches/StringSearchMetadata.cs

@@ -9,7 +9,7 @@ namespace BootstrapBlazor.Components;
 /// <para lang="zh">字符串搜索元数据类</para>
 /// <para lang="en">String search meta data class</para>
 /// </summary>
-public class StringSearchMetadata : SearchMetadataBase
+public class StringSearchMetadata : SearchFormItemMetadataBase
 {
     /// <summary>
     /// <para lang="zh">获得/设置 搜索值</para>

src/BootstrapBlazor/Components/Table/Table.razor.Search.cs

@@ -185,15 +185,7 @@ private List<ISearchItem> GetSearchFormItems()
 
         if (SearchFormLocalizerOptions is null)
         {
-            SearchFormLocalizerOptions = new SearchFormLocalizerOptions()
-            {
-                SelectAllText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.SelectAllText)],
-                BooleanAllText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.BooleanAllText)],
-                BooleanTrueText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.BooleanTrueText)],
-                BooleanFalseText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.BooleanFalseText)],
-                NumberStartValueLabelText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.NumberStartValueLabelText)],
-                NumberEndValueLabelText = SearchFormLocalizer[nameof(Components.SearchFormLocalizerOptions.NumberEndValueLabelText)]
-            };
+            SearchFormLocalizerOptions = SearchFormLocalizer.GetSearchFormLocalizerOptions();
         }
         return GetSearchColumns().Select(i => i.ParseSearchItem(SearchFormLocalizerOptions.Value)).ToList();
     }

src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs

@@ -65,8 +65,8 @@ public ISearchFormItemMetadata BuildSearchMetadata(SearchFormLocalizerOptions op
         }
 
         /// <summary>
-        /// <para lang="zh">创建 搜索项的 RenderFragment 实例</para>
-        /// <para lang="en">Creates a RenderFragment instance for the search item</para>
+        /// <para lang="zh">通过 SearchItem 实例 Metadata 创建搜索项 UI 方法</para>
+        /// <para lang="en">Creates a search item UI method through the SearchItem instance Metadata</para>
         /// </summary>
         public RenderFragment CreateSearchItemComponentByMetadata() => builder =>
         {

src/BootstrapBlazor/Extensions/IStringLocalizerExtensions.cs

@@ -35,4 +35,14 @@ public static bool TryGetLocalizerString(this IStringLocalizer localizer, string
         }
         return ret;
     }
+
+    public static SearchFormLocalizerOptions GetSearchFormLocalizerOptions(this IStringLocalizer<SearchFormLocalizerOptions> localizer) => new SearchFormLocalizerOptions()
+    {
+        SelectAllText = localizer[nameof(Components.SearchFormLocalizerOptions.SelectAllText)],
+        BooleanAllText = localizer[nameof(Components.SearchFormLocalizerOptions.BooleanAllText)],
+        BooleanTrueText = localizer[nameof(Components.SearchFormLocalizerOptions.BooleanTrueText)],
+        BooleanFalseText = localizer[nameof(Components.SearchFormLocalizerOptions.BooleanFalseText)],
+        NumberStartValueLabelText = localizer[nameof(Components.SearchFormLocalizerOptions.NumberStartValueLabelText)],
+        NumberEndValueLabelText = localizer[nameof(Components.SearchFormLocalizerOptions.NumberEndValueLabelText)]
+    };
 }

test/UnitTest/Components/SearchFormTest.cs

@@ -270,4 +270,40 @@ public void Reset_Ok()
         // Metadata 为空时不报错
         item.Reset();
     }
+
+    [Fact]
+    public async Task CustomMetadata_Ok()
+    {
+        var filterKeyValueAction = new FilterKeyValueAction();
+        var cut = Context.Render<SearchForm>(pb =>
+        {
+            pb.Add(a => a.OnChanged, action =>
+            {
+                filterKeyValueAction = action;
+                return Task.CompletedTask;
+            });
+            pb.Add(a => a.Items, new List<ISearchItem>()
+            {
+                new SearchItem(nameof(Foo.Name), typeof(string), "Name")
+                {
+                    Metadata = new CustomeMetadata() { Value = "foo-name-value" }
+                }
+            });
+        });
+
+        cut.Contains("value=\"foo-name-value\"");
+    }
+
+    class CustomeMetadata : StringSearchMetadata
+    {
+        public override RenderFragment? RenderContent() => builder =>
+        {
+            builder.OpenComponent<BootstrapInput<string>>(0);
+            builder.AddAttribute(10, nameof(BootstrapInput<>.Value), Value);
+            builder.AddAttribute(20, nameof(BootstrapInput<>.OnValueChanged), ValueChangedHandler);
+            builder.AddAttribute(30, nameof(BootstrapInput<>.ShowLabel), true);
+            builder.AddAttribute(60, nameof(BootstrapInput<>.SkipValidate), true);
+            builder.CloseComponent();
+        };
+    }
 }