feat(Region): add SelectProvince component (#6930)

* doc: 增加省选择器示例

* chore: bump version 9.0.3

* doc: 增加省选择器菜单

* doc: 增加源码映射

Author: ArgoZhang

src/BootstrapBlazor.Server/BootstrapBlazor.Server.csproj

@@ -66,7 +66,7 @@
     <PackageReference Include="BootstrapBlazor.PdfViewer" Version="9.0.6" />
     <PackageReference Include="BootstrapBlazor.Player" Version="9.0.2" />
     <PackageReference Include="BootstrapBlazor.RDKit" Version="9.0.2" />
-    <PackageReference Include="BootstrapBlazor.Region" Version="9.0.2" />
+    <PackageReference Include="BootstrapBlazor.Region" Version="9.0.3" />
     <PackageReference Include="BootstrapBlazor.SignaturePad" Version="9.0.1" />
     <PackageReference Include="BootstrapBlazor.SmilesDrawer" Version="9.0.2" />
     <PackageReference Include="BootstrapBlazor.Sortable" Version="9.0.3" />

src/BootstrapBlazor.Server/Components/Samples/SelectProvinces.razor

@@ -0,0 +1,20 @@
+@page "/select-province"
+@inject IStringLocalizer<SelectProvinces> Localizer
+
+<h3>@Localizer["ProvinceTitle"]</h3>
+
+<h4>@Localizer["ProvinceDescription"]</h4>
+
+<PackageTips Name="BootstrapBlazor.Region" />
+
+<DemoBlock Title="@Localizer["ProvinceNormalTitle"]"
+           Introduction="@Localizer["ProvinceNormalIntro"]"
+           Name="Normal">
+    <SelectProvince Value="@_value"></SelectProvince>
+</DemoBlock>
+
+<DemoBlock Title="@Localizer["ProvinceMultipleTitle"]"
+           Introduction="@Localizer["ProvinceMultipleIntro"]"
+           Name="IsMultiple">
+    <SelectProvince IsMultiple="true" Value="@_multipleValues"></SelectProvince>
+</DemoBlock>

src/BootstrapBlazor.Server/Components/Samples/SelectProvinces.razor.cs

@@ -0,0 +1,17 @@
+// 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([email protected]) Website: https://www.blazor.zone
+
+namespace BootstrapBlazor.Server.Components.Samples;
+
+/// <summary>
+/// 省选择器示例
+/// </summary>
+public partial class SelectProvinces
+{
+    private string? _value = null;
+
+    private string? _multipleValues = null;
+}
+

src/BootstrapBlazor.Server/Extensions/MenusLocalizerExtensions.cs

@@ -524,14 +524,20 @@ void AddForm(DemoMenuItem item)
                 new()
                 {
                     IsNew = true,
-                    Text = Localizer["SelectCity"],
-                    Url = "select-city"
+                    Text = Localizer["SelectRegion"],
+                    Url = "select-region"
                 },
                 new()
                 {
                     IsNew = true,
-                    Text = Localizer["SelectRegion"],
-                    Url = "select-region"
+                    Text = Localizer["SelectProvince"],
+                    Url = "select-province"
+                },
+                new()
+                {
+                    IsNew = true,
+                    Text = Localizer["SelectCity"],
+                    Url = "select-city"
                 },
                 new()
                 {

src/BootstrapBlazor.Server/Locales/en-US.json

@@ -4874,6 +4874,7 @@
     "TaskDashBoard": "TaskDashBoard",
     "Dom2ImageService": "IDom2HtmlService",
     "SelectRegion": "Region Selector",
+    "SelectProvince": "Province Selector",
     "SelectCity": "City Selector"
   },
   "BootstrapBlazor.Server.Components.Samples.Table.TablesHeader": {
@@ -7236,5 +7237,13 @@
     "CityNormalIntro": "Select a city from the drop-down box",
     "CityMultipleTitle": "Multiple",
     "CityMultipleIntro": "Enable multiple selection mode by setting <code>IsMultiple</code> , and all cities will be automatically selected when clicking a province in the pop-up window."
+  },
+  "BootstrapBlazor.Server.Components.Samples.SelectProvinces": {
+    "ProvinceTitle": "Province Selector",
+    "ProvinceDescription": "Provide a drop-down box to select the province",
+    "ProvinceNormalTitle": "Basic usage",
+    "ProvinceNormalIntro": "Select the province from the drop-down box",
+    "ProvinceMultipleTitle": "Multiple",
+    "ProvinceMultipleIntro": "Enable multiple selection mode by setting <code>IsMultiple</code>"
   }
 }

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

@@ -4874,6 +4874,7 @@
     "TaskDashBoard": "任务管理器 TaskDashBoard",
     "Dom2ImageService": "节点转图片服务 IDom2HtmlService",
     "SelectRegion": "行政区域选择器 SelectRegion",
+    "SelectProvince": "省选择器 SelectProvince",
     "SelectCity": "城市选择器 SelectCity"
   },
   "BootstrapBlazor.Server.Components.Samples.Table.TablesHeader": {
@@ -7236,5 +7237,13 @@
     "CityNormalIntro": "通过下拉框的形式选择城市",
     "CityMultipleTitle": "多选",
     "CityMultipleIntro": "通过设置 <code>IsMultiple</code> 开启多选模式，点击弹窗中省份时自动选中所有城市"
+  },
+  "BootstrapBlazor.Server.Components.Samples.SelectProvinces": {
+    "ProvinceTitle": "SelectProvince 省选择器",
+    "ProvinceDescription": "提供下拉框选择省/直辖市/特别行政区",
+    "ProvinceNormalTitle": "基本用法",
+    "ProvinceNormalIntro": "通过下拉框的形式选择省/直辖市/特别行政区",
+    "ProvinceMultipleTitle": "多选",
+    "ProvinceMultipleIntro": "通过设置 <code>IsMultiple</code> 开启多选模式"
   }
 }

src/BootstrapBlazor.Server/docs.json

@@ -257,7 +257,8 @@
     "modbus-factory": "Modbus\\ModbusFactories",
     "serial-port-factory": "SerialPorts\\SerialPortFactories",
     "select-region": "SelectRegions",
-    "select-city": "SelectCities"
+    "select-city": "SelectCities",
+    "select-province": "SelectProvinces"
   },
   "video": {
     "table": "BV1ap4y1x7Qn?p=1",