From 49504204143ae2e5acac3efbbc3267a876946be5 Mon Sep 17 00:00:00 2001 From: Tony996 <6914529@qq.com> Date: Wed, 1 Jul 2026 08:38:40 +0800 Subject: [PATCH 1/4] =?UTF-8?q?=E5=85=B3=E4=BA=8ETable=E7=BB=84=E4=BB=B6?= =?UTF-8?q?=E4=B8=AD10.6=E4=BB=A5=E5=90=8E=E7=89=88=E6=9C=AC=E5=A4=9A?= =?UTF-8?q?=E4=B8=AA=E5=88=97=E4=B8=8D=E5=85=81=E8=AE=B8=E7=BB=91=E5=AE=9A?= =?UTF-8?q?=E7=9B=B8=E5=90=8C=E5=B1=9E=E6=80=A7=E7=9A=84=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E8=AF=B4=E6=98=8E=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit doc: 更新TableTemplateColumn示例 doc: 更新Column列设置页文档说明 --- .../Components/Samples/Table/TablesColumn.razor | 1 + .../Components/Samples/Table/TablesEdit.razor | 7 ++++++- src/BootstrapBlazor.Server/Locales/en-US.json | 4 +++- src/BootstrapBlazor.Server/Locales/zh-CN.json | 4 +++- 4 files changed, 13 insertions(+), 3 deletions(-) diff --git a/src/BootstrapBlazor.Server/Components/Samples/Table/TablesColumn.razor b/src/BootstrapBlazor.Server/Components/Samples/Table/TablesColumn.razor index 63b2ca27726..88b05691b1e 100644 --- a/src/BootstrapBlazor.Server/Components/Samples/Table/TablesColumn.razor +++ b/src/BootstrapBlazor.Server/Components/Samples/Table/TablesColumn.razor @@ -174,6 +174,7 @@

@((MarkupString)Localizer["BindComplexObjectP1"].Value)

@((MarkupString)Localizer["BindComplexObjectP2"].Value)

+

@((MarkupString)Localizer["BindComplexObjectP3"].Value)

- + + + +
diff --git a/src/BootstrapBlazor.Server/Locales/en-US.json b/src/BootstrapBlazor.Server/Locales/en-US.json index 6720abc1a2f..6a2646f11f0 100644 --- a/src/BootstrapBlazor.Server/Locales/en-US.json +++ b/src/BootstrapBlazor.Server/Locales/en-US.json @@ -4671,6 +4671,7 @@ "BindComplexObjectIntro": "When binding a complex type, whether the bound object collection is empty or not, the TItem must provide a parameterless constructor. Otherwise, it is required to provide a construction callback through CreateItemCallback. When binding a complex expression, the bound expression must not throw a NullReferenceException exception. If the business logic cannot avoid this issue, it is recommended to handle it using a Template", "BindComplexObjectP1": "In this example, the complex type ComplexFoo does not have a parameterless constructor, so a construction callback for ComplexFoo should be provided through CreateItemCallback", "BindComplexObjectP2": "In this example, we want to bind a complex expression context.Company.Name to the column CompanyName, but the business logic cannot ensure that the value of the Company property is not null at the time of binding. Therefore, we can first bind a simple expression and then handle it using the column template Template", + "BindComplexObjectP3": "Starting from version 10.6.1, @bind-Fieldno longer allows multiple columns to be bound to the same attribute. To achieve the corresponding operation, please use TableTemplateColumn, please refer to [Portal]", "BindComplexObjectTitle": "Bind Complex Types and Expressions", "ColumnIgnoreButtonText": "Ignoring/Not Ignoring", "ColumnIgnoreIntro": "By setting the Ignore parameter to control whether the column is rendered, this parameter is different from Visible. SettingVisible=\"false\" to not display the column can be checked and displayed in the list through ShowColumnList=\"true\"", @@ -4942,7 +4943,8 @@ "TablesTemplateColumnTitle": "TemplateColumn", "TablesVisibleIntro": "If the IsVisibleWhenAdd or IsVisibleWhenEdit property is set to false, hide this column when creating or updating. In this example, the New pop-up window does not display Count Edit Pop up window does not display Complete edit the item", "TablesVisibleTitle": "Editor Visible/Hidden", - "TableTemplateColumnText": "Template" + "TableTemplateColumnText": "Template", + "TableTemplateColumnText2": "Name & Count" }, "BootstrapBlazor.Server.Components.Samples.Table.TablesExcel": { "TablesExcelCellRenderIntro": "Advanced usage", diff --git a/src/BootstrapBlazor.Server/Locales/zh-CN.json b/src/BootstrapBlazor.Server/Locales/zh-CN.json index d904df87828..4eb3bbb2e4b 100644 --- a/src/BootstrapBlazor.Server/Locales/zh-CN.json +++ b/src/BootstrapBlazor.Server/Locales/zh-CN.json @@ -4671,6 +4671,7 @@ "BindComplexObjectIntro": "当绑定复杂类型时，无论绑定的对象集合是否为空，都要求 TItem 提供无参构造函数，否则要求通过 CreateItemCallback 提供构造回调；当绑定复杂表达式时，要求绑定时该表达式不得引发 NullReferenceException 异常，如果业务逻辑无法避免此问题，建议使用 Template 进行处理", "BindComplexObjectP1": "本例中，复杂类型 ComplexFoo 不具备无参构造函数，需通过 CreateItemCallback 提供 ComplexFoo 的构造回调", "BindComplexObjectP2": "本例中，我们希望将复杂表达式 context.Company.Name 绑定到列 CompanyName 上，但是业务逻辑无法确保绑定时属性 Company 的值不为 null 。因此可以先绑定简单表达式，再通过列模板 Template 进行处理", + "BindComplexObjectP3": "从10.6.1版本开始@bind-Field不再允许多个列绑定相同属性，如要实现相应操作请使用TableTemplateColumn。请参阅 [传送门]", "BindComplexObjectTitle": "绑定复杂类型和表达式", "ColumnIgnoreButtonText": "忽略/不忽略", "ColumnIgnoreIntro": "通过设置 Ignore 参数控制列是否渲染，此参数与 Visible 不同，设置 Visible=\"false\" 后不显示列可通过 ShowColumnList=\"true\" 在列表中勾选并显示", @@ -4942,7 +4943,8 @@ "TablesTemplateColumnTitle": "模板列", "TablesVisibleIntro": "
Visible 默认值为 true 如果有列设置了 IsVisibleWhenAdd 或者 IsVisibleWhenEdit 属性为 false 时, 新建或者更新时隐藏此列。本例中 新建 弹窗不显示 数量 编辑 弹窗不显示 是否 编辑项。
可以通过在数据模型中使用 [AutoGenerateClass(Visible = false)] 全部禁止显示，再通过 IsVisibleWhenAdd 或者 IsVisibleWhenEdit 单独设置编辑状态下的可见性，本例中，地址 列默认不可见，新建、编辑 弹窗内均可以编辑
", "TablesVisibleTitle": "Table 编辑时显示/隐藏", - "TableTemplateColumnText": "模板列" + "TableTemplateColumnText": "模板列", + "TableTemplateColumnText2": "姓名 & 数量" }, "BootstrapBlazor.Server.Components.Samples.Table.TablesExcel": { "TablesExcelCellRenderIntro": "高级用法", From 9f7d959a03b5433841c6d177acfeeb94f6ced3b0 Mon Sep 17 00:00:00 2001 From: Tony996 <6914529@qq.com> Date: Wed, 1 Jul 2026 10:33:44 +0800 Subject: [PATCH 2/4] =?UTF-8?q?=E5=B0=86=E5=A4=9A=E4=B8=AA=E5=88=97?= =?UTF-8?q?=E4=B8=8D=E5=85=81=E8=AE=B8FieldName=E6=96=87=E6=A1=A3=E8=AF=B4?= =?UTF-8?q?=E6=98=8E=E8=B0=83=E6=95=B4=E5=88=B0=E5=88=97=E6=A8=A1=E6=9D=BF?= =?UTF-8?q?=E8=AF=B4=E6=98=8E=E4=B8=AD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit doc:将多个列不允许FieldName文档说明调整到列模板说明中 --- .../Components/Samples/Table/TablesColumn.razor | 1 - .../Components/Samples/Table/TablesColumnTemplate.razor | 3 ++- src/BootstrapBlazor.Server/Locales/en-US.json | 2 +- src/BootstrapBlazor.Server/Locales/zh-CN.json | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/BootstrapBlazor.Server/Components/Samples/Table/TablesColumn.razor b/src/BootstrapBlazor.Server/Components/Samples/Table/TablesColumn.razor index 88b05691b1e..63b2ca27726 100644 --- a/src/BootstrapBlazor.Server/Components/Samples/Table/TablesColumn.razor +++ b/src/BootstrapBlazor.Server/Components/Samples/Table/TablesColumn.razor @@ -174,7 +174,6 @@

@((MarkupString)Localizer["BindComplexObjectP1"].Value)

@((MarkupString)Localizer["BindComplexObjectP2"].Value)

-

@((MarkupString)Localizer["BindComplexObjectP3"].Value)

NavMenuLocalizer @inject IStringLocalizer Localizer @inject IStringLocalizer FooLocalizer @@ -18,6 +18,7 @@

@((MarkupString)Localizer["TableColumnP1"].Value)

@((MarkupString)Localizer["TableColumnP2"].Value)

+

@((MarkupString)Localizer["TableColumnP4"].Value)

@((MarkupString)Localizer["TableColumnP3"].Value)

  • @((MarkupString)Localizer["TableColumnLi1"].Value)
    • diff --git a/src/BootstrapBlazor.Server/Locales/en-US.json b/src/BootstrapBlazor.Server/Locales/en-US.json index 6a2646f11f0..75962bf0e5d 100644 --- a/src/BootstrapBlazor.Server/Locales/en-US.json +++ b/src/BootstrapBlazor.Server/Locales/en-US.json @@ -4671,7 +4671,6 @@ "BindComplexObjectIntro": "When binding a complex type, whether the bound object collection is empty or not, the TItem must provide a parameterless constructor. Otherwise, it is required to provide a construction callback through CreateItemCallback. When binding a complex expression, the bound expression must not throw a NullReferenceException exception. If the business logic cannot avoid this issue, it is recommended to handle it using a Template", "BindComplexObjectP1": "In this example, the complex type ComplexFoo does not have a parameterless constructor, so a construction callback for ComplexFoo should be provided through CreateItemCallback", "BindComplexObjectP2": "In this example, we want to bind a complex expression context.Company.Name to the column CompanyName, but the business logic cannot ensure that the value of the Company property is not null at the time of binding. Therefore, we can first bind a simple expression and then handle it using the column template Template", - "BindComplexObjectP3": "Starting from version 10.6.1, @bind-Fieldno longer allows multiple columns to be bound to the same attribute. To achieve the corresponding operation, please use TableTemplateColumn, please refer to [Portal]", "BindComplexObjectTitle": "Bind Complex Types and Expressions", "ColumnIgnoreButtonText": "Ignoring/Not Ignoring", "ColumnIgnoreIntro": "By setting the Ignore parameter to control whether the column is rendered, this parameter is different from Visible. SettingVisible=\"false\" to not display the column can be checked and displayed in the list through ShowColumnList=\"true\"", @@ -4785,6 +4784,7 @@ "TableColumnP1": "In this example, the column DateTime value is displayed in different colors depending on whether the Complete value is true", "TableColumnP2": "In this example, the column Complete is displayed as a Checkbox component according to the value of Complete", "TableColumnP3": "Template template comes with Context associated context, its value is of type TableColumnContext", + "TableColumnP4": "Starting from version 10.6.1, @bind-Fieldno longer allows multiple columns to be bound to the same attribute. To achieve the corresponding operation, please use TableTemplateColumn, please refer to [Portal]", "TableColumnTitle": "Custom Column Data Template", "TablesColumnDescription": "Used to display multiple pieces of data with similar structures, data can be sorted, filtered, compared or other custom operations.", "TablesColumnTitle": "Table Column", diff --git a/src/BootstrapBlazor.Server/Locales/zh-CN.json b/src/BootstrapBlazor.Server/Locales/zh-CN.json index 4eb3bbb2e4b..8376677b2df 100644 --- a/src/BootstrapBlazor.Server/Locales/zh-CN.json +++ b/src/BootstrapBlazor.Server/Locales/zh-CN.json @@ -4671,7 +4671,6 @@ "BindComplexObjectIntro": "当绑定复杂类型时，无论绑定的对象集合是否为空，都要求 TItem 提供无参构造函数，否则要求通过 CreateItemCallback 提供构造回调；当绑定复杂表达式时，要求绑定时该表达式不得引发 NullReferenceException 异常，如果业务逻辑无法避免此问题，建议使用 Template 进行处理", "BindComplexObjectP1": "本例中，复杂类型 ComplexFoo 不具备无参构造函数，需通过 CreateItemCallback 提供 ComplexFoo 的构造回调", "BindComplexObjectP2": "本例中，我们希望将复杂表达式 context.Company.Name 绑定到列 CompanyName 上，但是业务逻辑无法确保绑定时属性 Company 的值不为 null 。因此可以先绑定简单表达式，再通过列模板 Template 进行处理", - "BindComplexObjectP3": "从10.6.1版本开始@bind-Field不再允许多个列绑定相同属性，如要实现相应操作请使用TableTemplateColumn。请参阅 [传送门]", "BindComplexObjectTitle": "绑定复杂类型和表达式", "ColumnIgnoreButtonText": "忽略/不忽略", "ColumnIgnoreIntro": "通过设置 Ignore 参数控制列是否渲染，此参数与 Visible 不同，设置 Visible=\"false\" 后不显示列可通过 ShowColumnList=\"true\" 在列表中勾选并显示", @@ -4785,6 +4784,7 @@ "TableColumnP1": " 本例中列 DateTime 值根据 Complete 值是否为 true 显示不同颜色", "TableColumnP2": "本例中列 Complete 根据 Complete 值自定义显示为 Checkbox 组件", "TableColumnP3": "Template 模板自带 Context 相关联上下文，其值为 TableColumnContext 类型", + "TableColumnP4": "从10.6.1版本开始@bind-Field不再允许多个列绑定相同属性，如要实现相应操作请使用TableTemplateColumn。请参阅 [传送门]", "TableColumnTitle": "自定义列数据模板", "TablesColumnDescription": "用于展示多条结构类似的数据，可对数据进行排序、筛选、对比或其他自定义操作。", "TablesColumnTitle": "Table 表格", From b0d5d0e1df055925ede1ffd9f9b08acc26ca0a71 Mon Sep 17 00:00:00 2001 From: Argo Zhang Date: Thu, 2 Jul 2026 10:20:47 +0800 Subject: [PATCH 3/4] =?UTF-8?q?doc:=20=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/BootstrapBlazor.Server/Locales/en-US.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/BootstrapBlazor.Server/Locales/en-US.json b/src/BootstrapBlazor.Server/Locales/en-US.json index 75962bf0e5d..0675b5a9321 100644 --- a/src/BootstrapBlazor.Server/Locales/en-US.json +++ b/src/BootstrapBlazor.Server/Locales/en-US.json @@ -4784,7 +4784,7 @@ "TableColumnP1": "In this example, the column DateTime value is displayed in different colors depending on whether the Complete value is true", "TableColumnP2": "In this example, the column Complete is displayed as a Checkbox component according to the value of Complete", "TableColumnP3": "Template template comes with Context associated context, its value is of type TableColumnContext", - "TableColumnP4": "Starting from version 10.6.1, @bind-Fieldno longer allows multiple columns to be bound to the same attribute. To achieve the corresponding operation, please use TableTemplateColumn, please refer to [Portal]", + "TableColumnP4": "Starting from version 10.6.1, @bind-Field no longer allows multiple columns to be bound to the same attribute. To achieve this, use TableTemplateColumn. See [Portal]", "TableColumnTitle": "Custom Column Data Template", "TablesColumnDescription": "Used to display multiple pieces of data with similar structures, data can be sorted, filtered, compared or other custom operations.", "TablesColumnTitle": "Table Column", From 9a5a08b1731b663f8c320d5a5b55afefb950f7bd Mon Sep 17 00:00:00 2001 From: Argo Zhang Date: Thu, 2 Jul 2026 10:23:23 +0800 Subject: [PATCH 4/4] =?UTF-8?q?doc:=20=E6=96=87=E6=A1=A3=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 --- src/BootstrapBlazor.Server/Locales/zh-CN.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/BootstrapBlazor.Server/Locales/zh-CN.json b/src/BootstrapBlazor.Server/Locales/zh-CN.json index 8376677b2df..cc3265ab088 100644 --- a/src/BootstrapBlazor.Server/Locales/zh-CN.json +++ b/src/BootstrapBlazor.Server/Locales/zh-CN.json @@ -4784,7 +4784,7 @@ "TableColumnP1": " 本例中列 DateTime 值根据 Complete 值是否为 true 显示不同颜色", "TableColumnP2": "本例中列 Complete 根据 Complete 值自定义显示为 Checkbox 组件", "TableColumnP3": "Template 模板自带 Context 相关联上下文，其值为 TableColumnContext 类型", - "TableColumnP4": "从10.6.1版本开始@bind-Field不再允许多个列绑定相同属性，如要实现相应操作请使用TableTemplateColumn。请参阅 [传送门]", + "TableColumnP4": "从 10.6.1 版本开始 @bind-Field 不再允许多个列绑定相同属性，如要实现相应操作请使用 TableTemplateColumn。请参阅 [传送门]", "TableColumnTitle": "自定义列数据模板", "TablesColumnDescription": "用于展示多条结构类似的数据，可对数据进行排序、筛选、对比或其他自定义操作。", "TablesColumnTitle": "Table 表格",