feat(centralui): OffsetPager reusable pagination component (T35a)

2026-06-18 19:28:17 -04:00
parent 6a34ed9ed6
commit 2e4ca5a35f
2 changed files with 162 additions and 0 deletions
@@ -0,0 +1,109 @@
+using Bunit;
+using Microsoft.AspNetCore.Components;
+using ZB.MOM.WW.ScadaBridge.CentralUI.Components.Shared;
+
+namespace ZB.MOM.WW.ScadaBridge.CentralUI.Tests.Shared;
+
+/// <summary>
+/// bUnit tests for the <see cref="OffsetPager"/> reusable pagination bar (T35a).
+/// The component is purely presentational — it emits <c>PageChanged</c> callbacks
+/// and renders disabled states; the host page owns page-number and query state.
+/// </summary>
+public class OffsetPagerTests : BunitContext
+{
+    // ── PrevDisabled_OnFirstPage ──────────────────────────────────────────────
+
+    [Fact]
+    public void PrevDisabled_OnFirstPage()
+    {
+        var cut = Render<OffsetPager>(ps => ps
+            .Add(p => p.Page, 1)
+            .Add(p => p.HasNextPage, true));
+
+        var prev = cut.Find("[data-test='pager-prev']");
+
+        Assert.NotNull(prev.GetAttribute("disabled"));
+    }
+
+    // ── NextDisabled_WhenNoNextPage ───────────────────────────────────────────
+
+    [Fact]
+    public void NextDisabled_WhenNoNextPage()
+    {
+        var cut = Render<OffsetPager>(ps => ps
+            .Add(p => p.Page, 3)
+            .Add(p => p.HasNextPage, false));
+
+        var next = cut.Find("[data-test='pager-next']");
+
+        Assert.NotNull(next.GetAttribute("disabled"));
+    }
+
+    // ── Next_Click_EmitsPagePlusOne ───────────────────────────────────────────
+
+    [Fact]
+    public void Next_Click_EmitsPagePlusOne()
+    {
+        int? emitted = null;
+        var cut = Render<OffsetPager>(ps => ps
+            .Add(p => p.Page, 2)
+            .Add(p => p.HasNextPage, true)
+            .Add(p => p.PageChanged,
+                EventCallback.Factory.Create<int>(this, v => emitted = v)));
+
+        cut.Find("[data-test='pager-next']").Click();
+
+        Assert.Equal(3, emitted);
+    }
+
+    // ── Prev_Click_EmitsPageMinusOne ─────────────────────────────────────────
+
+    [Fact]
+    public void Prev_Click_EmitsPageMinusOne()
+    {
+        int? emitted = null;
+        var cut = Render<OffsetPager>(ps => ps
+            .Add(p => p.Page, 2)
+            .Add(p => p.HasNextPage, false)
+            .Add(p => p.PageChanged,
+                EventCallback.Factory.Create<int>(this, v => emitted = v)));
+
+        cut.Find("[data-test='pager-prev']").Click();
+
+        Assert.Equal(1, emitted);
+    }
+
+    // ── Summary_RendersPageOfTotal ────────────────────────────────────────────
+
+    [Fact]
+    public void Summary_RendersPageOfTotal()
+    {
+        var cut = Render<OffsetPager>(ps => ps
+            .Add(p => p.Page, 2)
+            .Add(p => p.PageSize, 50)
+            .Add(p => p.TotalCount, 230)
+            .Add(p => p.HasNextPage, true));
+
+        var summary = cut.Find("[data-test='pager-summary']");
+
+        Assert.Contains("Page 2 of 5", summary.TextContent);
+        Assert.Contains("230 total", summary.TextContent);
+    }
+
+    // ── BothDisabled_WhenDisabled ─────────────────────────────────────────────
+
+    [Fact]
+    public void BothDisabled_WhenDisabled()
+    {
+        var cut = Render<OffsetPager>(ps => ps
+            .Add(p => p.Page, 3)
+            .Add(p => p.HasNextPage, true)
+            .Add(p => p.Disabled, true));
+
+        var prev = cut.Find("[data-test='pager-prev']");
+        var next = cut.Find("[data-test='pager-next']");
+
+        Assert.NotNull(prev.GetAttribute("disabled"));
+        Assert.NotNull(next.GetAttribute("disabled"));
+    }
+}