feat: 更新说明文档

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.5" />
+    <PackageReference Include="BootstrapBlazor.SummerNote" Version="9.0.6" />
     <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,11 +111,15 @@ private async Task InsertHtmlAsync()
         await Editor.DoMethodAsync("pasteHTML", $"<h1>{Localizer["DoMethodAsyncPasteHTML"]}</h1>");
     }
 
-    private async Task OnFileUpload(EditorUploadFile uploadFile)
+    private async Task<string> OnFileUpload(EditorUploadFile uploadFile)
     {
         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);
         await uploadFile.SaveToFileAsync(fileName);
+
+        // 此处返回空字符串底层使用 URL.createObjectURL 方法创建 Blob 对象地址
+        // 实战中可以返回 SSO 地址或者 base64 字符串等
+        return "";
     }
 
     private string? _editorCode;

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

@@ -2536,7 +2536,7 @@
     "EditorPlaceholderIntro": "The prompt message when a null value is set by setting the <code>Placeholder</code> attribute",
     "EditorPlaceholderDescription": "The default prompt is <b>Edit after clicking</b>",
     "EditorIsEditorTitle": "Display as a rich text edit box by default",
-    "EditorIsEditorIntro": "Set the component to be directly displayed as a rich text edit box by setting the <code>IsEditor</code> property",
+    "EditorIsEditorIntro": "Set the component to be directly displayed as a rich text edit box by setting the <code>IsEditor</code> property. When uploading an image, you can get the image information through the <code>OnFileUpload</code> callback method",
     "EditorHeightTitle": "Custom height",
     "EditorHeightIntro": "Set the height of the component by setting the <code>Height</code> property",
     "EditorOnValueChangedTitle": "Two-way binding",

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

@@ -2537,7 +2537,7 @@
     "EditorPlaceholderIntro": "通过设置 <code>Placeholder</code> 属性来设置空值时的提示消息",
     "EditorPlaceholderDescription": "默认提示是 <b>点击后进行编辑</b>",
     "EditorIsEditorTitle": "默认显示为富文本编辑框",
-    "EditorIsEditorIntro": "通过设置 <code>IsEditor</code> 属性来设置组件直接显示为富文本编辑框",
+    "EditorIsEditorIntro": "通过设置 <code>IsEditor</code> 属性来设置组件直接显示为富文本编辑框，上传图片时可以通过 <code>OnFileUpload</code> 回调方法获得图片信息",
     "EditorHeightTitle": "自定义高度",
     "EditorHeightIntro": "通过设置 <code>Height</code> 属性来设置组件高度",
     "EditorOnValueChangedTitle": "双向绑定",