doc: 增加在线协作示例

Author: ArgoZhang

src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet.razor

@@ -0,0 +1,6 @@
+@page "/OnlineSheet"
+<h3>OnlineSheet</h3>
+
+@code {
+    
+}

src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet.razor.cs

@@ -0,0 +1,8 @@
+using Microsoft.AspNetCore.Components;
+
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+
+public partial class OnlineSheet : ComponentBase
+{
+}
+

src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet.razor.css

@@ -0,0 +1 @@
+

src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineContributor.razor

@@ -0,0 +1,16 @@
+@namespace BootstrapBlazor.Server.Components.Samples.Tutorials
+
+<div class="bb-contributor">
+    <img src="@Contributor.Avatar" />
+    <div class="bb-contributor-main">
+        <div class="bb-contributor-item">
+            <label>姓名：</label>
+            <span>@Contributor.Name</span>
+        </div>
+        <div class="bb-contributor-item">
+            <label>姓名：</label>
+            <span>@Contributor.Description</span>
+        </div>
+    </div>
+</div>
+

src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineContributor.razor.cs

@@ -0,0 +1,19 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the Apache 2.0 License
+// See the LICENSE file in the project root for more information.
+// Maintainer: Argo Zhang([email protected]) Website: https://www.blazor.zone
+
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+
+/// <summary>
+/// Online sheet sample code
+/// </summary>
+public partial class OnlineContributor
+{
+    /// <summary>
+    /// Gets or sets Contributor
+    /// </summary>
+    [Parameter]
+    [NotNull]
+    public Contributor? Contributor { get; set; }
+}

src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineContributor.razor.css

@@ -0,0 +1,10 @@
+.bb-contributor {
+    display: flex;
+    flex-direction: row;
+}
+
+    .bb-contributor img {
+        border-radius: 50%;
+        width: 56px;
+        margin-right: .5rem;
+    }

src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineSheet.razor

@@ -0,0 +1,6 @@
+@namespace BootstrapBlazor.Server.Components.Samples.Tutorials
+@page "/tutorials/online-sheet"
+
+<div class="bb-online-sheet-demo">
+    <UniverSheet @ref="_sheetExcel" Data="@_data" OnReadyAsync="OnReadyAsync"></UniverSheet>
+</div>

src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineSheet.razor.cs

@@ -0,0 +1,103 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the Apache 2.0 License
+// See the LICENSE file in the project root for more information.
+// Maintainer: Argo Zhang([email protected]) Website: https://www.blazor.zone
+
+namespace BootstrapBlazor.Server.Components.Samples.Tutorials;
+
+/// <summary>
+/// Online sheet sample code
+/// </summary>
+public partial class OnlineSheet : ComponentBase, IDisposable
+{
+    [Inject, NotNull]
+    private IWebHostEnvironment? WebHost { get; set; }
+
+    [Inject, NotNull]
+    private ToastService? ToastService { get; set; }
+
+    [Inject, NotNull]
+    private IStringLocalizer<OnlineSheet>? Localizer { get; set; }
+
+    [Inject]
+    [NotNull]
+    private IDispatchService<Contributor>? DispatchService { get; set; }
+
+    [NotNull]
+    private UniverSheet? _sheetExcel = null;
+
+    private UniverSheetData? _data = null;
+
+    private bool _inited = false;
+
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
+    protected override void OnInitialized()
+    {
+        base.OnInitialized();
+
+        var reportFile = Path.Combine(WebHost.WebRootPath, "univer-sheet", "report.json");
+        if (File.Exists(reportFile))
+        {
+            var sheetData = File.ReadAllText(reportFile);
+
+            _data = new UniverSheetData()
+            {
+                Data = sheetData
+            };
+        }
+    }
+
+    private async Task OnReadyAsync()
+    {
+        _inited = true;
+        await ToastService.Information(Localizer["ToastOnReadyTitle"], Localizer["ToastOnReadyContent"]);
+        DispatchService.Subscribe(Dispatch);
+    }
+
+    private async Task Dispatch(DispatchEntry<Contributor> entry)
+    {
+        if (!_inited)
+        {
+            return;
+        }
+
+        if (entry.Entry != null)
+        {
+            await ToastService.Show(new ToastOption()
+            {
+                Title = "Dispatch 服务测试",
+                ChildContent = BootstrapDynamicComponent.CreateComponent<OnlineContributor>(new Dictionary<string, object?>()
+                {
+                    { "Contributor", entry.Entry }
+                }).Render(),
+                Category = ToastCategory.Information,
+                Delay = 3000,
+                ForceDelay = true
+            });
+
+            DispatchService.UnSubscribe(Dispatch);
+
+            await _sheetExcel.PushDataAsync(entry.Entry.Data);
+        }
+    }
+
+    private void Dispose(bool disposing)
+    {
+        if (disposing)
+        {
+            DispatchService.UnSubscribe(Dispatch);
+        }
+    }
+
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
+    public void Dispose()
+    {
+        Dispose(true);
+        GC.SuppressFinalize(this);
+    }
+}
+

src/BootstrapBlazor.Server/Components/Samples/Tutorials/OnlineSheet/OnlineSheet.razor.css

@@ -0,0 +1,4 @@
+.bb-online-sheet-demo {
+    margin: -1rem;
+    height: calc(100vh - var(--bs-header-height));
+}