From 077da42f5eff3a76301a4e5e591e20707cf77c62 Mon Sep 17 00:00:00 2001 From: Argo Zhang Date: Sun, 24 Aug 2025 09:44:31 +0800 Subject: [PATCH 1/3] =?UTF-8?q?doc:=20=E4=BB=A3=E7=A0=81=E6=A0=BC=E5=BC=8F?= =?UTF-8?q?=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../Components/Components/CustomerFilter.razor | 2 -- 1 file changed, 2 deletions(-) diff --git a/src/BootstrapBlazor.Server/Components/Components/CustomerFilter.razor b/src/BootstrapBlazor.Server/Components/Components/CustomerFilter.razor index a3110a6adc1..05ff6bcdc02 100644 --- a/src/BootstrapBlazor.Server/Components/Components/CustomerFilter.razor +++ b/src/BootstrapBlazor.Server/Components/Components/CustomerFilter.razor @@ -9,5 +9,3 @@ else { } - - From a0fea3f9bff948aa7f254d5615ca28fcb7d063ad Mon Sep 17 00:00:00 2001 From: Argo Zhang Date: Sun, 24 Aug 2025 09:51:17 +0800 Subject: [PATCH 2/3] =?UTF-8?q?refactor:=20=E6=9B=B4=E6=96=B0=20OnFilterAs?= =?UTF-8?q?ync=20=E5=9B=9E=E8=B0=83=E6=96=B9=E6=B3=95=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../Components/Samples/Table/TablesFilter.razor | 1 + src/BootstrapBlazor.Server/Locales/en-US.json | 1 + src/BootstrapBlazor.Server/Locales/zh-CN.json | 1 + 3 files changed, 3 insertions(+) diff --git a/src/BootstrapBlazor.Server/Components/Samples/Table/TablesFilter.razor b/src/BootstrapBlazor.Server/Components/Samples/Table/TablesFilter.razor index 997fe95c8f4..0ddf920cf88 100644 --- a/src/BootstrapBlazor.Server/Components/Samples/Table/TablesFilter.razor +++ b/src/BootstrapBlazor.Server/Components/Samples/Table/TablesFilter.razor @@ -106,6 +106,7 @@

@Localizer["DefaultSortP"]

diff --git a/src/BootstrapBlazor.Server/Locales/en-US.json b/src/BootstrapBlazor.Server/Locales/en-US.json index fa9c2d5a420..3fb4378789c 100644 --- a/src/BootstrapBlazor.Server/Locales/en-US.json +++ b/src/BootstrapBlazor.Server/Locales/en-US.json @@ -5702,6 +5702,7 @@ "DefaultSortIntro": "Default sorts as default when setting the DefaultSort property value to true", "DefaultSortLi1": "Set DefaultSort=true to enable the default sort function, when multiple columns set this property, the first column works", "DefaultSortLi2": "Set DefaultSortOrder value, set default collation", + "DefaultSortLi3": "Before v9.6.2, use OnFilterValueChanged to trigger the filter callback. After refactoring, use OnFilterAsync to trigger the filter callback method.", "DefaultSortP": "In this case the default sort is the last column in reverse order", "SortListTitle": "Multi-column sort", "SortListIntro": "Set the SortList property, use this parameter for multi-column sorting when the table loads", diff --git a/src/BootstrapBlazor.Server/Locales/zh-CN.json b/src/BootstrapBlazor.Server/Locales/zh-CN.json index c9a3da3827a..d792e6df9c8 100644 --- a/src/BootstrapBlazor.Server/Locales/zh-CN.json +++ b/src/BootstrapBlazor.Server/Locales/zh-CN.json @@ -5703,6 +5703,7 @@ "DefaultSortIntro": "设置 DefaultSort 属性值为 true 时作为默认排序列", "DefaultSortLi1": "设置 DefaultSort=true 开启默认排序功能，当多列设置此属性时，第一列起作用", "DefaultSortLi2": "设置 DefaultSortOrder 值，设置默认排序规则", + "DefaultSortLi3": "v9.6.2 版本前，使用 OnFilterValueChanged 触发过滤回调，重构后使用 OnFilterAsync 触发过滤回调方法", "DefaultSortP": "本例中默认排序为最后一列倒序排序", "SortListTitle": "多列排序", "SortListIntro": "设置 SortList 属性，表格加载时使用此参数进行多列排序", From 3658426cb03a90cb1743024c8cd347244b71604b Mon Sep 17 00:00:00 2001 From: Argo Zhang Date: Sun, 24 Aug 2025 10:05:59 +0800 Subject: [PATCH 3/3] doc: update OnFilterAsync documentation --- .../Components/Samples/Table/TablesFilter.razor | 1 - src/BootstrapBlazor.Server/Locales/en-US.json | 3 +-- src/BootstrapBlazor.Server/Locales/zh-CN.json | 3 +-- 3 files changed, 2 insertions(+), 5 deletions(-) diff --git a/src/BootstrapBlazor.Server/Components/Samples/Table/TablesFilter.razor b/src/BootstrapBlazor.Server/Components/Samples/Table/TablesFilter.razor index 0ddf920cf88..997fe95c8f4 100644 --- a/src/BootstrapBlazor.Server/Components/Samples/Table/TablesFilter.razor +++ b/src/BootstrapBlazor.Server/Components/Samples/Table/TablesFilter.razor @@ -106,7 +106,6 @@
  • @((MarkupString)Localizer["DefaultSortLi1"].Value)
  • @((MarkupString)Localizer["DefaultSortLi2"].Value)
    • -
  • @((MarkupString)Localizer["DefaultSortLi3"].Value)

@Localizer["DefaultSortP"]

diff --git a/src/BootstrapBlazor.Server/Locales/en-US.json b/src/BootstrapBlazor.Server/Locales/en-US.json index 3fb4378789c..1a53ff3e4c6 100644 --- a/src/BootstrapBlazor.Server/Locales/en-US.json +++ b/src/BootstrapBlazor.Server/Locales/en-US.json @@ -5702,7 +5702,6 @@ "DefaultSortIntro": "Default sorts as default when setting the DefaultSort property value to true", "DefaultSortLi1": "Set DefaultSort=true to enable the default sort function, when multiple columns set this property, the first column works", "DefaultSortLi2": "Set DefaultSortOrder value, set default collation", - "DefaultSortLi3": "Before v9.6.2, use OnFilterValueChanged to trigger the filter callback. After refactoring, use OnFilterAsync to trigger the filter callback method.", "DefaultSortP": "In this case the default sort is the last column in reverse order", "SortListTitle": "Multi-column sort", "SortListIntro": "Set the SortList property, use this parameter for multi-column sorting when the table loads", @@ -5716,7 +5715,7 @@ "SetFilterInCodeIntro": "Example shows how to set filters through code", "SetFilterInCodeButtonText1": "Name contains 01", "SetFilterInCodeButtonText2": "Reset All Filter", - "TablesFilterTemplateDescription": "

The FilterTemplate type is RenderFragment its value is a custom component, and the component must inherit the filterBase In this case, the last column in this case, the Quantity column, uses the custom component by filtering the template CustomerFilter [portal] CustomerFilter component source code

Notes:

  • Custom filter components are wrapped with FilterProvider, and FilterProvider must be under the FilterTemplate node
  • Filters can be fine-tuned through the parameters of the FilterProvider component; for example, by setting ShowMoreButton to control whether the + - symbol is displayed
    • ", + "TablesFilterTemplateDescription": "

    The FilterTemplate type is RenderFragment its value is a custom component, and the component must inherit the filterBase In this case, the last column in this case, the Quantity column, uses the custom component by filtering the template CustomerFilter [portal] CustomerFilter component source code

    Notes:

    • Custom filter components are wrapped with FilterProvider, and FilterProvider must be under the FilterTemplate node
    • Filters can be fine-tuned through the parameters of the FilterProvider component; for example, by setting ShowMoreButton to control whether the + - symbol is displayed
    • Before v9.6.2, use OnFilterValueChanged to trigger the filter callback. After refactoring, use OnFilterAsync to trigger the filter callback method.
      • ", "CustomerFilterItem1": "All", "CustomerFilterItem2": "Greater than 10", "CustomerFilterItem3": "Greater than 50", diff --git a/src/BootstrapBlazor.Server/Locales/zh-CN.json b/src/BootstrapBlazor.Server/Locales/zh-CN.json index d792e6df9c8..c6e1bf16f76 100644 --- a/src/BootstrapBlazor.Server/Locales/zh-CN.json +++ b/src/BootstrapBlazor.Server/Locales/zh-CN.json @@ -5703,7 +5703,6 @@ "DefaultSortIntro": "设置 DefaultSort 属性值为 true 时作为默认排序列", "DefaultSortLi1": "设置 DefaultSort=true 开启默认排序功能，当多列设置此属性时，第一列起作用", "DefaultSortLi2": "设置 DefaultSortOrder 值，设置默认排序规则", - "DefaultSortLi3": "v9.6.2 版本前，使用 OnFilterValueChanged 触发过滤回调，重构后使用 OnFilterAsync 触发过滤回调方法", "DefaultSortP": "本例中默认排序为最后一列倒序排序", "SortListTitle": "多列排序", "SortListIntro": "设置 SortList 属性，表格加载时使用此参数进行多列排序", @@ -5717,7 +5716,7 @@ "SetFilterInCodeIntro": "示例展示如何通过代码设置过滤条件", "SetFilterInCodeButtonText1": "名称包含01", "SetFilterInCodeButtonText2": "重置条件", - "TablesFilterTemplateDescription": "

      FilterTemplate 类型为 RenderFragment 其值为自定义组件，组件必须继承 FilterBase 本例中最后一列 数量列 通过筛选模板使用自定义组件 CustomerFilter [传送门] CustomerFilter 组件源码

      注意事项：

      • 自定义过滤组件使用 FilterProvider 包裹，FilterProvider必须在 FilterTemplate 节点下
      • 通过 FilterProvider 组件的参数可微调过滤器；例如通过设置 ShowMoreButton 控制是否显示 + - 符号
        • ", + "TablesFilterTemplateDescription": "

        FilterTemplate 类型为 RenderFragment 其值为自定义组件，组件必须继承 FilterBase 本例中最后一列 数量列 通过筛选模板使用自定义组件 CustomerFilter [传送门] CustomerFilter 组件源码

        注意事项：

        • 自定义过滤组件使用 FilterProvider 包裹，FilterProvider必须在 FilterTemplate 节点下
        • 通过 FilterProvider 组件的参数可微调过滤器；例如通过设置 ShowMoreButton 控制是否显示 + - 符号
        • v9.6.2 版本前，使用 OnFilterValueChanged 触发过滤回调，重构后使用 OnFilterAsync 触发过滤回调方法
          • ", "CustomerFilterItem1": "全部", "CustomerFilterItem2": "大于 10", "CustomerFilterItem3": "大于 50",