!673 doc(#I264OZ): 更新文档关于统一设置 Toast 组件延时消失时间参数

* doc: 更新 Toast 组件统一配置 Delay 参数文档
* doc: 格式化文档
* doc: 增加 HostFile 参数完善 ssr wasm 文件名
* doc: wasm 模式增加弹出框组件延时配置示例
* doc: 更新英文版 readme

README.md

@@ -51,7 +51,7 @@ English | <a href="README.zh-CN.md">中文</a>
 
 `dotnet add package BootstrapBlazor`
 
-2.  **Add** the `stylesheet` `javascripts` file to your main index file - `~/Pages/_Host.cshtml`
+2.  **Add** the `stylesheet` `javascripts` file to your main index file - `Pages/_Host.cshtml (Server)` or `wwwroot/index.html (WebAssembly)`
 
  **HTML**  
 

src/BootstrapBlazor.Shared/Extensions/WebsiteOptions.cs

@@ -20,6 +20,9 @@
         /// </summary>
         public string AdminUrl { get; set; } = "https://admin.blazor.zone";
 
+        /// <summary>
+        /// 
+        /// </summary>
         public string ImageLibUrl { get; set; } = "https://imgs.blazor.zone";
     }
 }

src/BootstrapBlazor.Shared/Pages/Components/InstallContent.razor

@@ -12,7 +12,7 @@
 
 <h4>CSS 文件</h4>
 
-<p>将 Bootstrap 的 CSS 文件以 <code>&lt;link&gt;</code> 标签的形式添加到 <code>&lt;head&gt;</code> 标签中，并放置在所有其它样式表之前。</p>
+<p>将 Bootstrap 的 CSS 文件以 <code>&lt;link&gt;</code> 标签的形式添加到 <code>@HostFile</code> 文件 <code>&lt;head&gt;</code> 标签中，并放置在所有其它样式表之前。</p>
 
 <Pre CodeFile="install.1.html"></Pre>
 
@@ -23,7 +23,7 @@
 
 <h4>JS 文件</h4>
 
-<p>Bootstrap 所提供的许多组件都依赖 JavaScript 才能运行。具体来说，这些组件都依赖 jQuery、Popper.js 以及我们自己的 JavaScript 插件。将以下 <code>&lt;script&gt;</code> 标签放到页面尾部且在 <code>&lt;/body&gt;</code> 标签之前即可起作用。</p>
+<p>Bootstrap 所提供的许多组件都依赖 JavaScript 才能运行。具体来说，这些组件都依赖 jQuery、Popper.js 以及我们自己的 JavaScript 插件。将以下 <code>&lt;script&gt;</code> 标签放到 <code>>@HostFile</code> 文件尾部且在 <code>&lt;/body&gt;</code> 标签之前即可起作用。</p>
 <Pre CodeFile="install.2.html"></Pre>
 
 <h4>添加命名空间到 <code>_Imports.razor</code> 文件</h4>

src/BootstrapBlazor.Shared/Pages/Components/InstallContent.razor.cs

@@ -19,6 +19,12 @@ namespace BootstrapBlazor.Shared.Pages.Components
         [Parameter]
         public string Title { get; set; } = "服务器端渲染模式";
 
+        /// <summary>
+        /// 
+        /// </summary>
+        [Parameter]
+        public string HostFile { get; set; } = "Pages/_Host.cshtml";
+
         /// <summary>
         /// 
         /// </summary>

src/BootstrapBlazor.Shared/Pages/Install_wasm.razor

@@ -1,6 +1,6 @@
 @page "/install-wasm"
 
-<InstallContent Title="客户端渲染模式">
+<InstallContent Title="客户端渲染模式" HostFile="wwwroot/index.html">
 <Pre>public class Program
 {
     public static async Task Main(string[] args)

src/BootstrapBlazor.Shared/Pages/Toasts.razor

@@ -99,6 +99,29 @@
 
 <Pre>&lt;Toast /&gt;</Pre>
 
+<Alert ShowBar="true" Color="@Color.Info">特别说明: 可以通过 <code>BootstrapBlazorOptions</code> 全局统一配置参数可以设置整个系统内的 <code>Toast</code> 组件 <code>Delay</code> 参数值</Alert>
+
+<p>通过配置文件 <code>appsetting.json</code> 文件配置，适用于 <code>Server-Side App</code></p>
+
+<Pre>"BootstrapBlazorOptions": {
+    "ToastDelay": 4000,
+    "MessageDelay": 4000,
+    "SwalDelay": 4000
+}
+</Pre>
+
+<p>通过 <code>Startup</code> 文件中的 <code>ConfigureServices</code> 方法配置，适用于 <code>Server-Side App</code> 和 <code>WebAssembly App</code></p>
+
+<Pre>public void ConfigureServices(IServiceCollection services)
+{
+    // 统一设置 Toast 组件自动消失时间
+    services.Configure&lt;BootstrapBlazorOptions&gt;(options =>
+    {
+        options.ToastDelay = 4000;
+    });
+}
+</Pre>
+
 <Toast @ref="Toast"></Toast>
 
 <AttributeTable Items="@GetAttributes()" />

src/BootstrapBlazor.WebAssembly.ClientHost/Program.cs

@@ -1,4 +1,5 @@
-using BootstrapBlazor.Shared;
+using BootstrapBlazor.Components;
+using BootstrapBlazor.Shared;
 using BootstrapBlazor.Shared.Data;
 using Microsoft.AspNetCore.Components.WebAssembly.Hosting;
 using Microsoft.Extensions.DependencyInjection;
@@ -46,6 +47,8 @@ namespace BootstrapBlazor.WebAssembly.ClientHost
 
             builder.Services.AddSingleton<ICultureStorage, DefaultCultureStorage>();
 
+            builder.Services.Configure<BootstrapBlazorOptions>(op => op.ToastDelay = 4000);
+
             var host = builder.Build();
 
             await GetCultureAsync(host);