doc(BarcodeGenerator): update BarcodeGenerator documentation (#7610)

ArgoZhang · web-flow · commit 856d896798bd · 2026-01-31T15:45:10.000+08:00
* doc: 撤回资源文件丢失内内容

* doc: 增加条码设置资源文件

* doc: 更新示例

* refactor: 更改命名空间

* doc: 更改命名空间

* doc: 条码生成更改命名空间

* doc: 更新资源文件

* refactor: 更正写法防止工具误删除资源文件

* doc: 更正变量名

* doc: 整理 BaseLayout 资源文件

* doc: 整理 ComponentLayout 资源文件

* doc: 更新资源文件

* doc: 更新实战菜单

* doc: 更新资源文件

* doc: 更新资源文件

* test: 更新资源文件

* test: 更新单元测试

* doc: 增加注释

* doc: 更新资源文件

* doc: 更新描述文字
diff --git a/src/BootstrapBlazor.Server/Components/Components/BarcodeGenerateSettings.razor b/src/BootstrapBlazor.Server/Components/Components/BarcodeGenerateSettings.razor
@@ -1,9 +1,9 @@
-﻿@inject IStringLocalizer<BarcodeGenerateSettings> Localizer
+@inject IStringLocalizer<BarcodeGenerateSettings> Localizer
 
 <GroupBox Title="@Localizer["BarcodeGeneratorGroupBoxText"]">
     <div class="row form-inline g-3">
         <div class="col-12 col-sm-6">
-            <BootstrapInput Value="Value" ShowLabel="true" UseInputEvent="true" OnValueChanged="OnValueChanged" />
+            <BootstrapInput Value="Value" DisplayText="Value" ShowLabel="true" UseInputEvent="true" OnValueChanged="OnValueChanged" />
         </div>
         <div class="col-12 col-sm-6">
             <Select @bind-Value="Format" OnValueChanged="OnFormatChanged" ShowLabel="true" />
diff --git a/src/BootstrapBlazor.Server/Components/Components/FormInlineSwitch.razor.cs b/src/BootstrapBlazor.Server/Components/Components/FormInlineSwitch.razor.cs
@@ -57,6 +57,10 @@ protected override void OnInitialized()
     {
         base.OnInitialized();
 
-        Items = Enum.GetNames<RowType>().Select(i => new SelectedItem(i, Localizer[i]));
+        Items = new List<SelectedItem>
+        {
+            new SelectedItem("Normal", Localizer["Normal"]),
+            new SelectedItem("Inline", Localizer["Inline"]),
+        };
     }
 }
diff --git a/src/BootstrapBlazor.Server/Components/Components/QQGroup.razor b/src/BootstrapBlazor.Server/Components/Components/QQGroup.razor
@@ -1,8 +1,8 @@
-﻿@inject IOptions<WebsiteOptions> WebsiteOption
-@inject IStringLocalizer<QQGroup> Localzier
+@inject IOptions<WebsiteOptions> WebsiteOption
+@inject IStringLocalizer<QQGroup> Localizer
 
 <div>
-    @Localzier["Group"]：BootstrapAdmin & Blazor
+    @Localizer["Group"]：BootstrapAdmin & Blazor
     <a class="mx-1" target="_blank" href="@WebsiteOption.Value.QQGroup1Link">
         <span class="text-success fa-brands fa-qq"></span>
         <span class="text-success"><b>795206915</b></span>
@@ -11,5 +11,5 @@
         <span class="text-success fa-brands fa-qq"></span>
         <span class="text-success"><b>675147445</b></span>
     </a>
-    @Localzier["Welcome"]
+    @Localizer["Welcome"]
 </div>
diff --git a/src/BootstrapBlazor.Server/Components/Layout/TutorialsNavMenu.razor.cs b/src/BootstrapBlazor.Server/Components/Layout/TutorialsNavMenu.razor.cs
@@ -1,4 +1,4 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
@@ -18,6 +18,10 @@ public partial class TutorialsNavMenu
     [NotNull]
     private IStringLocalizer<BaseLayout>? AppLocalizer { get; set; }
 
+    [Inject]
+    [NotNull]
+    private IStringLocalizer<Tutorials>? TutorialsLocalizer { get; set; }
+
     [Inject]
     [NotNull]
     private IStringLocalizer<Tutorials>? Localizer { get; set; }
@@ -48,12 +52,12 @@ protected override async Task OnInitializedAsync()
             new()
             {
                 Template = CreateDownloadButtonComponent("dashboard", _dashboardFileList),
-                Text = Localizer["DashboardSummary"],
+                Text = TutorialsLocalizer["DashboardSummary"],
                 Url = "tutorials/dashboard"
             },
             new()
             {
-                Text = Localizer["LoginSummary"],
+                Text = TutorialsLocalizer["LoginSummary"],
                 Url = "tutorials/login",
                 Items =
                 [
@@ -92,24 +96,24 @@ protected override async Task OnInitializedAsync()
             new()
             {
                 Template = CreateDownloadButtonComponent("waterfall", _waterfallFileList),
-                Text = Localizer["WaterfallSummary"],
+                Text = TutorialsLocalizer["WaterfallSummary"],
                 Url = "tutorials/waterfall"
             },
             new()
             {
                 Template = CreateDownloadButtonComponent("translate", _translateFileList),
-                Text = Localizer["TranslateSummary"],
+                Text = TutorialsLocalizer["TranslateSummary"],
                 Url = "tutorials/translate"
             },
             new()
             {
                 Template = CreateDownloadButtonComponent("drawing", _drawingAppFileList),
-                Text = Localizer["DrawingSummary"],
+                Text = TutorialsLocalizer["DrawingSummary"],
                 Url = "tutorials/drawing"
             },
             new()
             {
-                Text = Localizer["AdminSummary"],
+                Text = TutorialsLocalizer["AdminSummary"],
                 Url = "tutorials/admin",
             },
             new()
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/BarCodeGenerator.razor b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/BarCodeGenerator.razor
@@ -1,4 +1,3 @@
-﻿@namespace BootstrapBlazor.Server.Components.Samples.Tutorials
 @inject IStringLocalizer<BarCodeGenerator> Localizer
 @page "/tutorials/barcode"
 
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/BarCodeGenerator.razor.cs b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/BarCodeGenerator.razor.cs
@@ -1,11 +1,11 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
 using Microsoft.AspNetCore.Components.Forms;
 
-namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials.BarCodeGenerator;
 
 /// <summary>
 /// BarCodeGenerator 组件示例代码
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/EmailContent.cs b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/EmailContent.cs
@@ -1,9 +1,9 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
-namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials.BarCodeGenerator;
 
 /// <summary>
 /// EmailContent
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/TextContent.cs b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/TextContent.cs
@@ -1,9 +1,9 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
-namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials.BarCodeGenerator;
 
 /// <summary>
 /// TextContent
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/WiFiAuthentication.cs b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/WiFiAuthentication.cs
@@ -1,11 +1,11 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
 using System.ComponentModel;
 
-namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials.BarCodeGenerator;
 
 /// <summary>
 /// WiFiAuthentication enum
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/WiFiContent.cs b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/BarCodeGenerator/WiFiContent.cs
@@ -1,9 +1,9 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
-namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials.BarCodeGenerator;
 
 /// <summary>
 /// WiFi content class
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/Contributor.cs b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/Contributor.cs
@@ -1,9 +1,9 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
-namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials.OnlineSheet;
 
 /// <summary>
 /// Contributor
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/MockOnlineContributor.cs b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/MockOnlineContributor.cs
@@ -1,9 +1,9 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
-namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials.OnlineSheet;
 
 static class MockOnlineContributor
 {
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineContributor.razor b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineContributor.razor
@@ -1,5 +1,3 @@
-﻿@namespace BootstrapBlazor.Server.Components.Samples.Tutorials
-
 <div class="bb-contributor">
     <img src="@Contributor.Avatar" />
     <div class="bb-contributor-main">
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineContributor.razor.cs b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineContributor.razor.cs
@@ -1,9 +1,9 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
-namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials.OnlineSheet;
 
 /// <summary>
 /// Online sheet sample code
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineSheet.razor b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineSheet.razor
@@ -1,4 +1,3 @@
-﻿@namespace BootstrapBlazor.Server.Components.Samples.Tutorials
 @page "/tutorials/online-sheet"
 
 <div class="bb-online-sheet-demo">
diff --git a/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineSheet.razor.cs b/src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineSheet.razor.cs
@@ -1,9 +1,9 @@
-﻿// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
-namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials.OnlineSheet;
 
 /// <summary>
 /// Online sheet sample code
diff --git a/src/BootstrapBlazor.Server/Locales/en-US.json b/src/BootstrapBlazor.Server/Locales/en-US.json
diff --git a/src/BootstrapBlazor.Server/Locales/zh-CN.json b/src/BootstrapBlazor.Server/Locales/zh-CN.json
diff --git a/test/UnitTest.Localization/JsonTest.cs b/test/UnitTest.Localization/JsonTest.cs

Original file line number	Diff line number	Diff line change
`@@ -57,6 +57,10 @@ protected override void OnInitialized()`
`57`	`57`	`{`
`58`	`58`	`base.OnInitialized();`
`59`	`59`
`60`		`- Items = Enum.GetNames<RowType>().Select(i => new SelectedItem(i, Localizer[i]));`
	`60`	`+ Items = new List<SelectedItem>`
	`61`	`+ {`
	`62`	`+ new SelectedItem("Normal", Localizer["Normal"]),`
	`63`	`+ new SelectedItem("Inline", Localizer["Inline"]),`
	`64`	`+ };`
`61`	`65`	`}`
`62`	`66`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,3 @@`
`1`		`-@namespace BootstrapBlazor.Server.Components.Samples.Tutorials`
`2`	`1`	`@inject IStringLocalizer<BarCodeGenerator> Localizer`
`3`	`2`	`@page "/tutorials/barcode"`
`4`	`3`