doc: 更新注释

Author: ArgoZhang

src/BootstrapBlazor/Extensions/JSModuleExtensions.cs

@@ -11,33 +11,33 @@ namespace BootstrapBlazor.Components;
 public static class JSModuleExtensions
 {
     /// <summary>
-    /// 导入 utility js 模块
+    /// Load utility js module
     /// </summary>
-    /// <param name="jsRuntime"></param>
-    /// <param name="version"></param>
-    /// <returns>A <see cref="Task"/><![CDATA[<]]><see cref="JSModule"/><![CDATA[>]]> 模块加载器</returns>
+    /// <param name="jsRuntime">The <see cref="IJSRuntime"/> instance</param>
+    /// <param name="version">The version of the module</param>
+    /// <returns>A <see cref="Task"/><![CDATA[<]]><see cref="JSModule"/><![CDATA[>]]> module loader</returns>
     public static Task<JSModule> LoadUtility(this IJSRuntime jsRuntime, string? version = null) => LoadModuleByName(jsRuntime, "utility", version);
 
     /// <summary>
-    /// 通过名称导入内置脚本模块
+    /// Load built-in script module by name
     /// </summary>
-    /// <param name="jsRuntime"></param>
-    /// <param name="moduleName"></param>
-    /// <param name="version"></param>
-    /// <returns>A <see cref="Task"/><![CDATA[<]]><see cref="JSModule"/><![CDATA[>]]> 模块加载器</returns>
+    /// <param name="jsRuntime">The <see cref="IJSRuntime"/> instance</param>
+    /// <param name="moduleName">The name of the module</param>
+    /// <param name="version">The version of the module</param>
+    /// <returns>A <see cref="Task"/><![CDATA[<]]><see cref="JSModule"/><![CDATA[>]]> module loader</returns>
     public static Task<JSModule> LoadModuleByName(this IJSRuntime jsRuntime, string moduleName, string? version = null)
     {
         var fileName = $"./_content/BootstrapBlazor/modules/{moduleName}.js";
         return LoadModule(jsRuntime, fileName, version);
     }
 
     /// <summary>
-    /// IJSRuntime 扩展方法 动态加载脚本
+    /// IJSRuntime extension method to dynamically load scripts
     /// </summary>
-    /// <param name="jsRuntime"></param>
-    /// <param name="fileName"></param>
-    /// <param name="version"></param>
-    /// <returns>A <see cref="Task"/><![CDATA[<]]><see cref="JSModule"/><![CDATA[>]]> 模块加载器</returns>
+    /// <param name="jsRuntime">The <see cref="IJSRuntime"/> instance</param>
+    /// <param name="fileName">The file name of the script</param>
+    /// <param name="version">The version of the script</param>
+    /// <returns>A <see cref="Task"/><![CDATA[<]]><see cref="JSModule"/><![CDATA[>]]> module loader</returns>
     public static async Task<JSModule> LoadModule(this IJSRuntime jsRuntime, string fileName, string? version = null)
     {
         if (!string.IsNullOrEmpty(version))
@@ -64,10 +64,10 @@ public static async Task<JSModule> LoadModule(this IJSRuntime jsRuntime, string
     }
 
     /// <summary>
-    /// 获得指定类型的加载 Module 名称
+    /// Get the module name of the specified type
     /// </summary>
-    /// <param name="type"></param>
-    /// <returns></returns>
+    /// <param name="type">The type</param>
+    /// <returns>The module name</returns>
     public static string GetTypeModuleName(this Type type)
     {
         var name = type.Name;
@@ -80,47 +80,47 @@ public static string GetTypeModuleName(this Type type)
     }
 
     /// <summary>
-    /// 在新标签页打开指定网址
+    /// Open the specified URL in a new tab
     /// </summary>
-    /// <param name="module"><see cref="JSModule"/> 实例</param>
-    /// <param name="url">打开网页地址</param>
-    /// <param name="target">默认 _blank</param>
-    /// <param name="features">默认 null</param>
+    /// <param name="module"><see cref="JSModule"/> instance</param>
+    /// <param name="url">The URL to open</param>
+    /// <param name="target">The target window, default is _blank</param>
+    /// <param name="features">The features of the new window, default is null</param>
     /// <returns>A <see cref="ValueTask"/> that represents the asynchronous invocation operation.</returns>
     public static ValueTask OpenUrl(this JSModule module, string url, string? target = "_blank", string? features = null) => module.InvokeVoidAsync("openUrl", url, target, features);
 
     /// <summary>
-    /// 动态运行js代码
+    /// Dynamically run js code
     /// </summary>
-    /// <param name="module"><see cref="JSModule"/> 实例</param>
-    /// <param name="script"></param>
+    /// <param name="module"><see cref="JSModule"/> instance</param>
+    /// <param name="script">The script to run</param>
     /// <returns>A <see cref="ValueTask"/> that represents the asynchronous invocation operation.</returns>
     public static async ValueTask Eval(this JSModule module, string script) => await module.InvokeVoidAsync("runEval", script);
 
     /// <summary>
-    /// 通过 Eval 动态运行 JavaScript 代码
+    /// Dynamically run JavaScript code via Eval
     /// </summary>
-    /// <param name="module"><see cref="JSModule"/> 实例</param>
-    /// <param name="script"></param>
+    /// <param name="module"><see cref="JSModule"/> instance</param>
+    /// <param name="script">The script to run</param>
     /// <returns>A <see cref="ValueTask"/> that represents the asynchronous invocation operation.</returns>
     public static ValueTask<TValue?> Eval<TValue>(this JSModule module, string script) => module.InvokeAsync<TValue?>("runEval", script);
 
     /// <summary>
-    /// 通过 Function 动态运行 JavaScript 代码
+    /// Dynamically run JavaScript code via Function
     /// </summary>
-    /// <param name="module"><see cref="JSModule"/> 实例</param>
-    /// <param name="script"></param>
-    /// <param name="args"></param>
+    /// <param name="module"><see cref="JSModule"/> instance</param>
+    /// <param name="script">The script to run</param>
+    /// <param name="args">The arguments to pass to the script</param>
     /// <returns>A <see cref="ValueTask"/> that represents the asynchronous invocation operation.</returns>
     public static ValueTask Function(this JSModule module, string script, params object?[]? args) => module.InvokeVoidAsync("runFunction", script, args);
 
     /// <summary>
-    /// 动态运行js代码
+    /// Dynamically run js code
     /// </summary>
-    /// <typeparam name="TValue"></typeparam>
-    /// <param name="module"><see cref="JSModule"/> 实例</param>
-    /// <param name="script"></param>
-    /// <param name="args"></param>
+    /// <typeparam name="TValue">The return type</typeparam>
+    /// <param name="module"><see cref="JSModule"/> instance</param>
+    /// <param name="script">The script to run</param>
+    /// <param name="args">The arguments to pass to the script</param>
     /// <returns>A <see cref="ValueTask"/> that represents the asynchronous invocation operation.</returns>
     public static async ValueTask<TValue?> Function<TValue>(this JSModule module, string script, params object?[]? args)
     {
@@ -133,39 +133,39 @@ public static string GetTypeModuleName(this Type type)
     }
 
     /// <summary>
-    /// 获取当前终端是否为移动设备
+    /// Check if the current terminal is a mobile device
     /// </summary>
-    /// <param name="module"><see cref="JSModule"/> 实例</param>
+    /// <param name="module"><see cref="JSModule"/> instance</param>
     /// <returns>A <see cref="ValueTask"/> that represents the asynchronous invocation operation.</returns>
     public static ValueTask<bool> IsMobile(this JSModule module) => module.InvokeAsync<bool>("isMobile");
 
     /// <summary>
-    /// 获取一个页面上不重复的元素ID
+    /// Get a unique element ID on a page
     /// </summary>
     /// <param name="module">An instance of <see cref="JSModule"/></param>
     /// <param name="prefix">A prefix of type <see cref="string"/></param>
     /// <returns>Returns a <see cref="string"/> formatted element ID</returns>
     public static ValueTask<string?> GenerateId(this JSModule module, string? prefix = null) => module.InvokeAsync<string?>("getUID", prefix);
 
     /// <summary>
-    /// 获取一个页面内指定元素 Html 字符串
+    /// Get the HTML string of a specified element on a page
     /// </summary>
     /// <param name="module">An instance of <see cref="JSModule"/></param>
-    /// <param name="id"></param>
-    /// <param name="selector"></param>
+    /// <param name="id">The ID of the element</param>
+    /// <param name="selector">The selector of the element</param>
     /// <returns>Returns a <see cref="string"/> formatted element ID</returns>
     public static ValueTask<string?> GetHtml(this JSModule module, string? id = null, string? selector = null) => module.InvokeAsync<string?>("getHtml", new { id, selector });
 
     /// <summary>
-    /// 设置主题方法
+    /// Set the theme method
     /// </summary>
     /// <param name="module">An instance of <see cref="JSModule"/></param>
-    /// <param name="themeName">theme name</param>
+    /// <param name="themeName">The name of the theme</param>
     /// <returns></returns>
     public static ValueTask SetThemeAsync(this JSModule module, string themeName) => module.InvokeVoidAsync("setTheme", themeName, true);
 
     /// <summary>
-    /// 设置主题方法
+    /// Get the theme method
     /// </summary>
     /// <param name="module">An instance of <see cref="JSModule"/></param>
     /// <returns></returns>