From 9d689bdcfa6e454a4feb8dd2233608b801f0da06 Mon Sep 17 00:00:00 2001
From: Tony <6914529@qq.com>
Date: Mon, 23 Mar 2026 22:31:15 +0800
Subject: [PATCH 1/7] =?UTF-8?q?=E4=BC=98=E5=8C=96=E6=89=8B=E6=9C=BA?=
 =?UTF-8?q?=E7=AB=AF=E6=98=BE=E7=A4=BA=E6=BA=A2=E5=87=BA=E7=9A=84=E9=97=AE?=
 =?UTF-8?q?=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

优化手机端显示溢出的问题，目前手机端 是按照PC端开始日期和结束日期并排，优化后，手机端开始日期和结束日期采取上下排列
---
 .../Components/DateTimePicker/DatePickerBody.razor         | 6 +++---
 .../Components/DateTimeRange/DateTimeRange.razor.scss      | 7 ++++++-
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/BootstrapBlazor/Components/DateTimePicker/DatePickerBody.razor b/src/BootstrapBlazor/Components/DateTimePicker/DatePickerBody.razor
index 8db866aa238..8913ea4c9c3 100644
--- a/src/BootstrapBlazor/Components/DateTimePicker/DatePickerBody.razor
+++ b/src/BootstrapBlazor/Components/DateTimePicker/DatePickerBody.razor
@@ -1,4 +1,4 @@
-@namespace BootstrapBlazor.Components
+@namespace BootstrapBlazor.Components
 @inherits BootstrapComponentBase
 
 <div @attributes="@AdditionalAttributes" class="@ClassString">
@@ -179,8 +179,8 @@
     }
     @if (ShowFooter)
     {
-        <div class="picker-panel-footer">
-            <div class="flex-fill">
+        <div class="picker-panel-footer justify-content-between">
+            <div>
                 @if (ShowClearButton)
                 {
                     <Button class="picker-panel-link-btn is-confirm" Color="Color.None" OnClickWithoutRender="@ClickClearButton">
diff --git a/src/BootstrapBlazor/Components/DateTimeRange/DateTimeRange.razor.scss b/src/BootstrapBlazor/Components/DateTimeRange/DateTimeRange.razor.scss
index 7b2010a4d93..640cdb943d1 100644
--- a/src/BootstrapBlazor/Components/DateTimeRange/DateTimeRange.razor.scss
+++ b/src/BootstrapBlazor/Components/DateTimeRange/DateTimeRange.razor.scss
@@ -1,4 +1,4 @@
-@use "../../wwwroot/scss/variables" as *;
+@use "../../wwwroot/scss/variables" as *;
 
 .datetime-range {
     --bb-dt-range-bar-color: #{$bb-dt-range-bar-color};
@@ -85,6 +85,11 @@
         }
     }
 }
+@media (max-width: 768px) {
+    .range-panel-body {
+        flex-direction:column;
+    }
+}
 
 .is-lunar .picker-panel-body {
     .picker-panel-body-main .picker-panel-content table td {

From 0df5a573313763b1ddf1e60e5628e7759047507e Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Thu, 26 Mar 2026 10:09:32 +0800
Subject: [PATCH 2/7] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0=20IsPopover=20?=
 =?UTF-8?q?=E9=BB=98=E8=AE=A4=E8=AE=BE=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs b/src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs
index 2ef88ee7d0f..e9c3282d7d4 100644
--- a/src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs
+++ b/src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs
@@ -161,6 +161,9 @@ private void AddSelectSearchComponent(ISearchItem item, SelectSearchMetadata sel
             builder.AddAttribute(70, nameof(Select<>.PlaceHolder), selectSearchMetadata.PlaceHolder);
             builder.AddAttribute(80, nameof(Select<>.SkipValidate), true);
             builder.AddAttribute(90, nameof(Select<>.ShowSearch), selectSearchMetadata.ShowSearch);
+            builder.AddAttribute(100, nameof(Select<>.OnSearchTextChanged), selectSearchMetadata.OnSearchTextChanged);
+            builder.AddAttribute(110, nameof(Select<>.ItemTemplate), selectSearchMetadata.ItemTemplate);
+            builder.AddAttribute(120, nameof(Select<>.IsPopover), true);
             builder.CloseComponent();
         }
 

From a9be30bf7c9f4856be4320b171386621ff10f2a1 Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Thu, 26 Mar 2026 10:16:09 +0800
Subject: [PATCH 3/7] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0=E5=8F=82?=
 =?UTF-8?q?=E6=95=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Components/Searches/SelectSearchMetadata.cs      | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/src/BootstrapBlazor/Components/Searches/SelectSearchMetadata.cs b/src/BootstrapBlazor/Components/Searches/SelectSearchMetadata.cs
index 64da7221803..b4a6ea159b8 100644
--- a/src/BootstrapBlazor/Components/Searches/SelectSearchMetadata.cs
+++ b/src/BootstrapBlazor/Components/Searches/SelectSearchMetadata.cs
@@ -17,6 +17,18 @@ public class SelectSearchMetadata : StringSearchMetadata
     /// </summary>
     public bool ShowSearch { get; set; }
 
+    /// <summary>
+    /// <para lang="zh">获得/设置 搜索文本改变时的回调方法</para>
+    /// <para lang="en">Gets or sets the callback method when the search text changes</para>
+    /// </summary>
+    public Func<string, IEnumerable<SelectedItem>>? OnSearchTextChanged { get; set; }
+
+    /// <summary>
+    /// <para lang="zh">获得/设置 项目模板</para>
+    /// <para lang="en">Gets or sets the item template</para>
+    /// </summary>
+    public RenderFragment<SelectedItem>? ItemTemplate { get; set; }
+
     /// <summary>
     /// <para lang="zh">获得/设置 选择项集合</para>
     /// <para lang="en">Gets or sets the collection of select items</para>

From 8fe9baa790a58d147c31a88dbe003f58c9c1882d Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Thu, 26 Mar 2026 10:19:28 +0800
Subject: [PATCH 4/7] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0=20IsPopover=20?=
 =?UTF-8?q?=E5=8F=82=E6=95=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Components/Searches/SelectSearchMetadata.cs             | 6 ++++++
 src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs     | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/BootstrapBlazor/Components/Searches/SelectSearchMetadata.cs b/src/BootstrapBlazor/Components/Searches/SelectSearchMetadata.cs
index b4a6ea159b8..21a1fd893d9 100644
--- a/src/BootstrapBlazor/Components/Searches/SelectSearchMetadata.cs
+++ b/src/BootstrapBlazor/Components/Searches/SelectSearchMetadata.cs
@@ -35,4 +35,10 @@ public class SelectSearchMetadata : StringSearchMetadata
     /// </summary>
     /// <returns></returns>
     public IEnumerable<SelectedItem>? Items { get; set; }
+
+    /// <summary>
+    /// <para lang="zh">获得/设置 是否使用 Popover 渲染下拉框 默认 false</para>
+    /// <para lang="en">Gets or sets Whether to use Popover to render dropdown. Default false</para>
+    /// </summary>
+    public bool IsPopover { get; set; }
 }
diff --git a/src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs b/src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs
index e9c3282d7d4..caf3a266a39 100644
--- a/src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs
+++ b/src/BootstrapBlazor/Extensions/ISearchItemExtensions.cs
@@ -163,7 +163,7 @@ private void AddSelectSearchComponent(ISearchItem item, SelectSearchMetadata sel
             builder.AddAttribute(90, nameof(Select<>.ShowSearch), selectSearchMetadata.ShowSearch);
             builder.AddAttribute(100, nameof(Select<>.OnSearchTextChanged), selectSearchMetadata.OnSearchTextChanged);
             builder.AddAttribute(110, nameof(Select<>.ItemTemplate), selectSearchMetadata.ItemTemplate);
-            builder.AddAttribute(120, nameof(Select<>.IsPopover), true);
+            builder.AddAttribute(120, nameof(Select<>.IsPopover), selectSearchMetadata.IsPopover);
             builder.CloseComponent();
         }
 

From 26d6f1dc5a85ab566cdbc9d1541fdf227a178b4e Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Thu, 26 Mar 2026 10:20:36 +0800
Subject: [PATCH 5/7] =?UTF-8?q?test:=20=E6=9B=B4=E6=96=B0=E5=8D=95?=
 =?UTF-8?q?=E5=85=83=E6=B5=8B=E8=AF=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 test/UnitTest/Components/SearchFormItemMetadataTest.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/test/UnitTest/Components/SearchFormItemMetadataTest.cs b/test/UnitTest/Components/SearchFormItemMetadataTest.cs
index 912028cd023..906b6071430 100644
--- a/test/UnitTest/Components/SearchFormItemMetadataTest.cs
+++ b/test/UnitTest/Components/SearchFormItemMetadataTest.cs
@@ -108,6 +108,8 @@ public void SelectSearchFormItemMetadata_Ok()
         var meta = new SelectSearchMetadata()
         {
             ShowSearch = true,
+            IsPopover = true,
+            OnSearchTextChanged = key => [],
             Items = new List<SelectedItem>()
             {
                 new SelectedItem("v1", "v1"),

From db3b404d65497873e0cdb462e68ebe34f1f5bba4 Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Thu, 26 Mar 2026 10:23:55 +0800
Subject: [PATCH 6/7] =?UTF-8?q?doc:=20=E8=B5=84=E6=BA=90=E6=96=87=E4=BB=B6?=
 =?UTF-8?q?=E6=8E=92=E5=BA=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/BootstrapBlazor.Server/Locales/en-US.json | 22 +++++++++----------
 src/BootstrapBlazor.Server/Locales/zh-CN.json | 22 +++++++++----------
 2 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/src/BootstrapBlazor.Server/Locales/en-US.json b/src/BootstrapBlazor.Server/Locales/en-US.json
index f6aa936a26d..3a06764977a 100644
--- a/src/BootstrapBlazor.Server/Locales/en-US.json
+++ b/src/BootstrapBlazor.Server/Locales/en-US.json
@@ -5068,6 +5068,16 @@
     "SearchFormDescItem1": "Customize metadata using the <code>SearchFormItemMetadata</code> property in <code>TableColumn</code>.",
     "SearchFormDescItem2": "Customize the search item UI using the <code>RenderContent</code> method in the <code>SearchFormItemMetadata</code> parameter.",
     "SearchFormIntro": "Enable the search form feature by setting <code>UseSearchForm=\"true\"</code>, and configure the search items within the form using <code>SearchItems</code>, suitable for scenarios with custom complex search conditions",
+    "SearchFormItemMetadataCustom": "When the default search metadata above cannot meet your business requirements, for example when a dropdown needs to use the <code>SelectTable</code> component for display, you can inherit from a suitable search metadata base class to implement your own custom search metadata",
+    "SearchFormItemMetadataListDesc": "The current version includes the following built-in <code>ISearchFormItemMetadata</code> implementations",
+    "SearchFormItemMetadataListP1": "<code>StringSearchMetadata</code> String search metadata, defaults to a contains relationship",
+    "SearchFormItemMetadataListP2": "<code>MultipleStringSearchMetadata</code> Multiple string search metadata, uses space-separated values to form multiple OR conditions, e.g. <b>condition1</b> <b>condition2</b> results in contains condition1 OR contains condition2",
+    "SearchFormItemMetadataListP3": "<code>NumberSearchMetadata</code> Number search metadata",
+    "SearchFormItemMetadataListP4": "<code>SelectSearchMetadata</code> Dropdown select search metadata",
+    "SearchFormItemMetadataListP5": "<code>MultipleSelectSearchMetadata</code> Multiple select dropdown search metadata",
+    "SearchFormItemMetadataListP6": "<code>DateTimeSearchMetadata</code> DateTime search metadata",
+    "SearchFormItemMetadataListP7": "<code>DateTimeRangeSearchMetadata</code> DateTime range search metadata",
+    "SearchFormItemMetadataListP8": "<code>CheckboxListSearchMetadata</code> Checkbox list search metadata",
     "SearchFormTips": "Enabling <code>UseSearchForm</code> will prevent <code>SearchModel</code> <code>SearchTemplate</code>, <code>CustomerSearchModel</code>, and <code>CustomerSearchTemplate</code> from taking effect.",
     "SearchFormTitle": "Search Form",
     "SearchFormWarningTips": "<code>BootstrapBlazor</code> v10.4.2 introduced the <code>UseSearchForm</code> parameter, making the following examples obsolete. It is strongly recommended to use <code>UseSearchForm</code>.",
@@ -5084,17 +5094,7 @@
     "SelectedItemValue1": "Name1",
     "SelectedItemValue2": "Name2",
     "TablesSearchDesc": "Commonly used for single table maintenance, simple addition, deletion, modification, search, sorting, filtering, search and other common functions can be realized through attribute configuration, and very complex can be realized through the advanced usage of <code>Template</code> business needs functions",
-    "TablesSearchTitle": "Table Search",
-    "SearchFormItemMetadataListDesc": "The current version includes the following built-in <code>ISearchFormItemMetadata</code> implementations",
-    "SearchFormItemMetadataListP1": "<code>StringSearchMetadata</code> String search metadata, defaults to a contains relationship",
-    "SearchFormItemMetadataListP2": "<code>MultipleStringSearchMetadata</code> Multiple string search metadata, uses space-separated values to form multiple OR conditions, e.g. <b>condition1</b> <b>condition2</b> results in contains condition1 OR contains condition2",
-    "SearchFormItemMetadataListP3": "<code>NumberSearchMetadata</code> Number search metadata",
-    "SearchFormItemMetadataListP4": "<code>SelectSearchMetadata</code> Dropdown select search metadata",
-    "SearchFormItemMetadataListP5": "<code>MultipleSelectSearchMetadata</code> Multiple select dropdown search metadata",
-    "SearchFormItemMetadataListP6": "<code>DateTimeSearchMetadata</code> DateTime search metadata",
-    "SearchFormItemMetadataListP7": "<code>DateTimeRangeSearchMetadata</code> DateTime range search metadata",
-    "SearchFormItemMetadataListP8": "<code>CheckboxListSearchMetadata</code> Checkbox list search metadata",
-    "SearchFormItemMetadataCustom": "When the default search metadata above cannot meet your business requirements, for example when a dropdown needs to use the <code>SelectTable</code> component for display, you can inherit from a suitable search metadata base class to implement your own custom search metadata"
+    "TablesSearchTitle": "Table Search"
   },
   "BootstrapBlazor.Server.Components.Samples.Table.TablesSelection": {
     "TablesSelectionCountText": "Count：{0}",
diff --git a/src/BootstrapBlazor.Server/Locales/zh-CN.json b/src/BootstrapBlazor.Server/Locales/zh-CN.json
index 27d70c19b1a..64cc58c830f 100644
--- a/src/BootstrapBlazor.Server/Locales/zh-CN.json
+++ b/src/BootstrapBlazor.Server/Locales/zh-CN.json
@@ -5068,6 +5068,16 @@
     "SearchFormDescItem1": "通过 <code>TableColumn</code> 中的 <code>SearchFormItemMetadata</code> 属性定制化元数据",
     "SearchFormDescItem2": "通过 <code>SearchFormItemMetadata</code> 参数中 <code>RenderContent</code> 方法自定义搜索项 UI",
     "SearchFormIntro": "通过设置 <code>UseSearchForm=\"true\"</code> 开启搜索表单功能，通过 <code>SearchItems</code> 配置搜索表单内搜索项，适用于自定义复杂搜索条件的场景",
+    "SearchFormItemMetadataCustom": "例如以上默认搜索元模型无法满足业务需求时，比如下拉框需要使用 <code>SelectTable</code> 组件进行展示，可以通过继承合适的搜索元模型基类自行实现一个自定义搜索元模型",
+    "SearchFormItemMetadataListDesc": "当前版本内置 <code>ISearchFormItemMetadata</code> 实现类如下",
+    "SearchFormItemMetadataListP1": "<code>StringSearchMetadata</code> 字符串搜索元模型 默认是包含关系",
+    "SearchFormItemMetadataListP2": "<code>MultipleStringSearchMetadata</code> 多字符串搜索元模型默认使用空格分隔组成多个或者条件如 <b>条件1</b> <b>条件2</b> 最终形成 包含条件1 或者 包含条件2 的判定",
+    "SearchFormItemMetadataListP3": "<code>NumberSearchMetadata</code> 数字搜索元模型",
+    "SearchFormItemMetadataListP4": "<code>SelectSearchMetadata</code> 下拉选择搜索元模型",
+    "SearchFormItemMetadataListP5": "<code>MultipleSelectSearchMetadata</code> 多选下拉搜索元模型",
+    "SearchFormItemMetadataListP6": "<code>DateTimeSearchMetadata</code> 日期时间搜索元模型",
+    "SearchFormItemMetadataListP7": "<code>DateTimeRangeSearchMetadata</code> 日期时间范围搜索元模型",
+    "SearchFormItemMetadataListP8": "<code>CheckboxListSearchMetadata</code> 复选框列表搜索元模型",
     "SearchFormTips": "开启 <code>UseSearchForm</code> 后 <code>SearchModel</code> <code>SearchTemplate</code> <code>CustomerSearchModel</code> <code>CustomerSearchTemplate</code> 均不生效",
     "SearchFormTitle": "搜索表单",
     "SearchFormWarningTips": "<code>BootstrapBlazor</code> v10.4.2 版本后增加 <code>UseSearchForm</code> 参数后以下示例均可以不学习了，强烈推荐使用 <code>UseSearchForm</code>",
@@ -5084,17 +5094,7 @@
     "SelectedItemValue1": "姓名1",
     "SelectedItemValue2": "姓名2",
     "TablesSearchDesc": "常用于单表维护，通过属性配置实现简单的增、删、改、查、排序、过滤、搜索等常用功能，通过 <code>Template</code> 的高级用法能实现非常复杂的业务需求功能",
-    "TablesSearchTitle": "Table 表格",
-    "SearchFormItemMetadataListDesc": "当前版本内置 <code>ISearchFormItemMetadata</code> 实现类如下",
-    "SearchFormItemMetadataListP1": "<code>StringSearchMetadata</code> 字符串搜索元模型 默认是包含关系",
-    "SearchFormItemMetadataListP2": "<code>MultipleStringSearchMetadata</code> 多字符串搜索元模型默认使用空格分隔组成多个或者条件如 <b>条件1</b> <b>条件2</b> 最终形成 包含条件1 或者 包含条件2 的判定",
-    "SearchFormItemMetadataListP3": "<code>NumberSearchMetadata</code> 数字搜索元模型",
-    "SearchFormItemMetadataListP4": "<code>SelectSearchMetadata</code> 下拉选择搜索元模型",
-    "SearchFormItemMetadataListP5": "<code>MultipleSelectSearchMetadata</code> 多选下拉搜索元模型",
-    "SearchFormItemMetadataListP6": "<code>DateTimeSearchMetadata</code> 日期时间搜索元模型",
-    "SearchFormItemMetadataListP7": "<code>DateTimeRangeSearchMetadata</code> 日期时间范围搜索元模型",
-    "SearchFormItemMetadataListP8": "<code>CheckboxListSearchMetadata</code> 复选框列表搜索元模型",
-    "SearchFormItemMetadataCustom": "例如以上默认搜索元模型无法满足业务需求时，比如下拉框需要使用 <code>SelectTable</code> 组件进行展示，可以通过继承合适的搜索元模型基类自行实现一个自定义搜索元模型"
+    "TablesSearchTitle": "Table 表格"
   },
   "BootstrapBlazor.Server.Components.Samples.Table.TablesSelection": {
     "TablesSelectionCountText": "选中的行数：{0}",

From 923246bb9b73f909f463e23e7db732952bc02491 Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Thu, 26 Mar 2026 10:24:04 +0800
Subject: [PATCH 7/7] =?UTF-8?q?test:=20=E6=9B=B4=E6=96=B0=E5=8D=95?=
 =?UTF-8?q?=E5=85=83=E6=B5=8B=E8=AF=95=E6=8F=90=E9=AB=98=E8=A6=86=E7=9B=96?=
 =?UTF-8?q?=E7=8E=87?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 test/UnitTest/Components/SearchFormItemMetadataTest.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/test/UnitTest/Components/SearchFormItemMetadataTest.cs b/test/UnitTest/Components/SearchFormItemMetadataTest.cs
index 906b6071430..8eaf3aed2f3 100644
--- a/test/UnitTest/Components/SearchFormItemMetadataTest.cs
+++ b/test/UnitTest/Components/SearchFormItemMetadataTest.cs
@@ -110,6 +110,10 @@ public void SelectSearchFormItemMetadata_Ok()
             ShowSearch = true,
             IsPopover = true,
             OnSearchTextChanged = key => [],
+            ItemTemplate = item => builder =>
+            {
+                builder.AddContent(0, item.Text);
+            },
             Items = new List<SelectedItem>()
             {
                 new SelectedItem("v1", "v1"),