doc: 增加 OnFileUpload 回调方法说明

Author: ArgoZhang

src/BootstrapBlazor.Server/BootstrapBlazor.Server.csproj

@@ -70,7 +70,7 @@
     <PackageReference Include="BootstrapBlazor.Sortable" Version="9.0.3" />
     <PackageReference Include="BootstrapBlazor.Splitting" Version="9.0.3" />
     <PackageReference Include="BootstrapBlazor.SvgEditor" Version="9.0.3" />
-    <PackageReference Include="BootstrapBlazor.SummerNote" Version="9.0.4" />
+    <PackageReference Include="BootstrapBlazor.SummerNote" Version="9.0.5" />
     <PackageReference Include="BootstrapBlazor.TableExport" Version="9.2.6" />
     <PackageReference Include="BootstrapBlazor.Tasks.Dashboard" Version="9.0.0" />
     <PackageReference Include="BootstrapBlazor.TcpSocket" Version="9.0.0" />

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

@@ -111,13 +111,11 @@ private async Task InsertHtmlAsync()
         await Editor.DoMethodAsync("pasteHTML", $"<h1>{Localizer["DoMethodAsyncPasteHTML"]}</h1>");
     }
 
-    private async Task<string> OnFileUpload(EditorUploadFile uploadFile)
+    private async Task OnFileUpload(EditorUploadFile uploadFile)
     {
-        var url = Path.Combine("images", "uploader",
-            $"{Path.GetFileNameWithoutExtension(uploadFile.FileName)}-{DateTimeOffset.Now:yyyyMMddHHmmss}{Path.GetExtension(uploadFile.FileName)}");
+        var url = Path.Combine("images", "uploader", $"{Path.GetFileNameWithoutExtension(uploadFile.FileName)}-{DateTimeOffset.Now:yyyyMMddHHmmss}{Path.GetExtension(uploadFile.FileName)}");
         var fileName = Path.Combine(WebsiteOption.CurrentValue.WebRootPath, url);
-        var ret = await uploadFile.SaveToFile(fileName);
-        return ret ? url : "";
+        await uploadFile.SaveToFileAsync(fileName);
     }
 
     private string? _editorCode;
@@ -176,6 +174,14 @@ private AttributeItem[] GetAttributes() =>
             Type = "IEnumerable<EditorToolbarButton>",
             ValueList = " — ",
             DefaultValue = " — "
+        },
+        new()
+        {
+            Name = "OnFileUpload",
+            Description = Localizer["OnFileUploadAttribute"],
+            Type = "Func<EditorUploadFile, Task>",
+            ValueList = " — ",
+            DefaultValue = " — "
         }
     ];
 }

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

@@ -2577,7 +2577,8 @@
     "DoMethodAsyncButton2": "Update to  H2",
     "DoMethodAsyncButton3": "Insert Image",
     "DoMethodAsyncButton4": "Get Code",
-    "DoMethodAsyncPasteHTML": "Here is the content inserted by the external button"
+    "DoMethodAsyncPasteHTML": "Here is the content inserted by the external button",
+    "OnFileUploadAttribute": "File upload callback method"
   },
   "BootstrapBlazor.Server.Components.Samples.EditorForms": {
     "Title": "EditorForm",

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

@@ -2578,7 +2578,8 @@
     "DoMethodAsyncButton2": "将段落修改为 H2",
     "DoMethodAsyncButton3": "添加一张图片",
     "DoMethodAsyncButton4": "获得组件内容",
-    "DoMethodAsyncPasteHTML": "这里是外部按钮插入的内容"
+    "DoMethodAsyncPasteHTML": "这里是外部按钮插入的内容",
+    "OnFileUploadAttribute": "文件上传回调方法"
   },
   "BootstrapBlazor.Server.Components.Samples.EditorForms": {
     "Title": "EditorForm 表单组件",