From b166620001d51bb461b15403856d22de37ec3104 Mon Sep 17 00:00:00 2001
From: zhaijunlei <276318515@qq.com>
Date: Fri, 9 Jan 2026 18:03:14 +0800
Subject: [PATCH 1/5] feat: UniverSheet add onRendered Lifecycle

---
 .../BootstrapBlazor.UniverSheet/wwwroot/univer.js   | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer.js b/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer.js
index bdda3021..33c30f04 100644
--- a/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer.js
+++ b/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer.js
@@ -113,6 +113,19 @@ export async function createUniverSheetAsync(sheet) {
         univerAPI.createWorkbook();
     }
 
+    const disposable = univerAPI.addEvent(
+        univerAPI.Event.LifeCycleChanged,
+        ({ stage }) => {
+          if (stage === univerAPI.Enum.LifecycleStages.Rendered) {
+            console.log('界面渲染完成')
+            // 移除loading...
+            
+            // 移除监听器
+            disposable.dispose()
+          }
+        },
+      )
+
     sheet.univer = univer;
     sheet.univerAPI = univerAPI;
     sheet.dispose = () => {

From 4d73f299cba31f0945b5926741555284ef92572d Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Sun, 11 Jan 2026 16:33:49 +0800
Subject: [PATCH 2/5] =?UTF-8?q?chore:=20=E5=A2=9E=E5=8A=A0=E8=B5=84?=
 =?UTF-8?q?=E6=BA=90=E6=96=87=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../BootstrapBlazor.UniverSheet.csproj                       | 5 +++++
 src/components/BootstrapBlazor.UniverSheet/Locales/en.json   | 5 +++++
 src/components/BootstrapBlazor.UniverSheet/Locales/zh.json   | 5 +++++
 3 files changed, 15 insertions(+)
 create mode 100644 src/components/BootstrapBlazor.UniverSheet/Locales/en.json
 create mode 100644 src/components/BootstrapBlazor.UniverSheet/Locales/zh.json

diff --git a/src/components/BootstrapBlazor.UniverSheet/BootstrapBlazor.UniverSheet.csproj b/src/components/BootstrapBlazor.UniverSheet/BootstrapBlazor.UniverSheet.csproj
index 3e74bd76..71abcbe8 100644
--- a/src/components/BootstrapBlazor.UniverSheet/BootstrapBlazor.UniverSheet.csproj
+++ b/src/components/BootstrapBlazor.UniverSheet/BootstrapBlazor.UniverSheet.csproj
@@ -9,6 +9,11 @@
     <Description>Bootstrap UI components extensions of Univer Sheet</Description>
   </PropertyGroup>
 
+  <ItemGroup>
+    <Content Remove="Locales\*.json" />
+    <EmbeddedResource Include="Locales\*.json" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Include="BootstrapBlazor" Version="$(BBVersion)" />
   </ItemGroup>
diff --git a/src/components/BootstrapBlazor.UniverSheet/Locales/en.json b/src/components/BootstrapBlazor.UniverSheet/Locales/en.json
new file mode 100644
index 00000000..8e3c78f7
--- /dev/null
+++ b/src/components/BootstrapBlazor.UniverSheet/Locales/en.json
@@ -0,0 +1,5 @@
+{
+  "BootstrapBlazor.Components.UniverSheet": {
+    "LoadingText": "Loading ..."
+  }
+}
diff --git a/src/components/BootstrapBlazor.UniverSheet/Locales/zh.json b/src/components/BootstrapBlazor.UniverSheet/Locales/zh.json
new file mode 100644
index 00000000..a175db67
--- /dev/null
+++ b/src/components/BootstrapBlazor.UniverSheet/Locales/zh.json
@@ -0,0 +1,5 @@
+{
+  "BootstrapBlazor.Components.UniverSheet": {
+    "LoadingText": "正在加载 ..."
+  }
+}

From 46e918547be537d0b440056a2e3ee240861e60c0 Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Sun, 11 Jan 2026 16:34:38 +0800
Subject: [PATCH 3/5] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0=E9=81=AE?=
 =?UTF-8?q?=E7=BD=A9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Components/UniverSheet.razor.js           | 10 +++++-
 .../wwwroot/univer.js                         | 33 +++++++++----------
 2 files changed, 25 insertions(+), 18 deletions(-)

diff --git a/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.js b/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.js
index 98592fb4..bb8f63a0 100644
--- a/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.js
+++ b/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.js
@@ -18,7 +18,15 @@ export async function init(id, invoke, options) {
         theme,
         lang,
         ribbonType,
-        darkMode
+        darkMode,
+        events: {
+            onRendered: () => {
+                const backdrop = el.querySelector('.bb-univer-sheet-backdrop');
+                if (backdrop) {
+                    backdrop.classList.add('d-none');
+                }
+            }
+        }
     };
 
     await createUniverSheetAsync(univerSheet);
diff --git a/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer.js b/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer.js
index 33c30f04..b3aea424 100644
--- a/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer.js
+++ b/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer.js
@@ -1,4 +1,4 @@
-import { addScript, addLink, getTheme } from '../BootstrapBlazor/modules/utility.js'
+import { addScript, addLink, getTheme } from '../BootstrapBlazor/modules/utility.js'
 import DataService from './data-service.js'
 
 const loadAssets2 = async lang => {
@@ -30,6 +30,7 @@ const loadAssets = async lang => {
     await addScript('./_content/BootstrapBlazor.UniverSheet/univer/univer-bundle.js');
     await addLink('./_content/BootstrapBlazor.UniverSheet/univer/univer-sheet.bundle.css');
 }
+
 export async function createUniverSheetAsync(sheet) {
     sheet.lang = sheet.lang ?? 'en-US';
     await loadAssets(sheet.lang);
@@ -46,7 +47,7 @@ export async function createUniverSheetAsync(sheet) {
     const lang = sheet.lang.replace('-', '')
     const langStr = lang.charAt(0).toUpperCase() + lang.slice(1)
     const options = {
-        theme: sheet.theme, 
+        theme: sheet.theme,
         darkMode: sheet.darkMode,
         locale: lang,
         locales: {
@@ -66,12 +67,12 @@ export async function createUniverSheetAsync(sheet) {
                 ribbonType: sheet.ribbonType ?? 'simple', // default | classic | simple
                 menu: {
                     'sheet.menu.print': {
-                      hidden: true,
+                        hidden: true,
                     },
                     'sheets-exchange-client.operation.exchange': {
-                      hidden: true,
+                        hidden: true,
                     },
-                  },
+                },
             }),
             UniverSheetsDrawingPreset(),
             UniverSheetsThreadCommentPreset(),
@@ -113,18 +114,16 @@ export async function createUniverSheetAsync(sheet) {
         univerAPI.createWorkbook();
     }
 
-    const disposable = univerAPI.addEvent(
-        univerAPI.Event.LifeCycleChanged,
-        ({ stage }) => {
-          if (stage === univerAPI.Enum.LifecycleStages.Rendered) {
-            console.log('界面渲染完成')
-            // 移除loading...
-            
-            // 移除监听器
-            disposable.dispose()
-          }
-        },
-      )
+    const { onRendered } = sheet.events;
+    if (onRendered) {
+        const disposable = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, e => {
+            const { stage } = e;
+            if (stage === univerAPI.Enum.LifecycleStages.Rendered) {
+                onRendered();
+                disposable.dispose()
+            }
+        });
+    }
 
     sheet.univer = univer;
     sheet.univerAPI = univerAPI;

From 2514d5fbade628cb7f8c2ead0faf387f8ddb32f5 Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Sun, 11 Jan 2026 16:35:42 +0800
Subject: [PATCH 4/5] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0=E5=8A=A0?=
 =?UTF-8?q?=E8=BD=BD=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Components/UniverSheet.razor                      |  7 ++++++-
 .../Components/UniverSheet.razor.cs                   | 11 +++++++++++
 .../Components/UniverSheet.razor.js                   |  2 +-
 .../wwwroot/univer/univer-sheet.bundle.css            |  1 -
 4 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor b/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor
index 8fdd46e9..44270051 100644
--- a/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor
+++ b/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor
@@ -2,4 +2,9 @@
 @inherits BootstrapModuleComponentBase
 @attribute [JSModuleAutoLoader("./_content/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.js", JSObjectReference = true)]
 
-<div @attributes="@AdditionalAttributes" class="@ClassString" id="@Id"></div>
+<div @attributes="@AdditionalAttributes" class="@ClassString" id="@Id" style="position: relative; overflow: hidden;">
+    <div class="bb-univer-sheet-wrap" style="height: 100%;"></div>
+    <div class="bb-univer-sheet-backdrop" style="background-color: #000; opacity: 0.3; position: absolute; inset: 0; z-index: 1205; display: flex; align-items: center; justify-content: center;">
+        <div style="color: #fff;">@LoadingText</div>
+    </div>
+</div>
diff --git a/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.cs b/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.cs
index 1c549e46..176561b6 100644
--- a/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.cs
+++ b/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.cs
@@ -3,6 +3,7 @@
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
 using Microsoft.AspNetCore.Components;
+using Microsoft.Extensions.Localization;
 using System.Globalization;
 
 namespace BootstrapBlazor.Components;
@@ -48,12 +49,21 @@ public partial class UniverSheet
     [Parameter]
     public UniverSheetData? Data { get; set; }
 
+    /// <summary>
+    /// 获得/设置 正在加载显示文本 默认 null 未设置读取资源文件
+    /// </summary>
+    [Parameter]
+    public string? LoadingText { get; set; }
+
     /// <summary>
     /// 获得/设置 Frame 加载页面传递过来的数据
     /// </summary>
     [Parameter]
     public Func<UniverSheetData?, Task<UniverSheetData?>>? OnPostDataAsync { get; set; }
 
+    [Inject, NotNull]
+    private IStringLocalizer<UniverSheet>? Localizer { get; set; }
+
     private string? ClassString => CssBuilder.Default("bb-univer-sheet")
         .AddClassFromAttributes(AdditionalAttributes)
         .Build();
@@ -78,6 +88,7 @@ protected override void OnParametersSet()
         base.OnParametersSet();
 
         Lang ??= CultureInfo.CurrentUICulture.Name;
+        LoadingText ??= Localizer[nameof(LoadingText)];
     }
 
     /// <summary>
diff --git a/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.js b/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.js
index bb8f63a0..dfbb3b2c 100644
--- a/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.js
+++ b/src/components/BootstrapBlazor.UniverSheet/Components/UniverSheet.razor.js
@@ -11,7 +11,7 @@ export async function init(id, invoke, options) {
 
     const { theme, lang, plugins, data, ribbonType, darkMode } = options;
     const univerSheet = {
-        el,
+        el: el.querySelector('.bb-univer-sheet-wrap'),
         invoke,
         data,
         plugins,
diff --git a/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer/univer-sheet.bundle.css b/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer/univer-sheet.bundle.css
index 1a57122d..ef9a9018 100644
--- a/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer/univer-sheet.bundle.css
+++ b/src/components/BootstrapBlazor.UniverSheet/wwwroot/univer/univer-sheet.bundle.css
@@ -3,7 +3,6 @@
 .bb-univer-sheet {
     width: 100%;
     height: 100%;
-    overflow: hidden;
 }
 
 .univer-theme {

From 24f6b30706ba0a9ed319150373ce5f40c409e381 Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Sun, 11 Jan 2026 16:36:05 +0800
Subject: [PATCH 5/5] chore: bump version 10.0.7

---
 .../BootstrapBlazor.UniverSheet.csproj                          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/BootstrapBlazor.UniverSheet/BootstrapBlazor.UniverSheet.csproj b/src/components/BootstrapBlazor.UniverSheet/BootstrapBlazor.UniverSheet.csproj
index 71abcbe8..93af5f20 100644
--- a/src/components/BootstrapBlazor.UniverSheet/BootstrapBlazor.UniverSheet.csproj
+++ b/src/components/BootstrapBlazor.UniverSheet/BootstrapBlazor.UniverSheet.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
   <PropertyGroup>
-    <Version>10.0.6</Version>
+    <Version>10.0.7</Version>
   </PropertyGroup>
 
   <PropertyGroup>