From 430d155998e61dfad139e31add0434bc1964df56 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=AB=98=E8=89=B3=E5=85=B5?= <yanbing.gao@aliyun.com>
Date: Mon, 28 Sep 2026 10:36:20 +0800
Subject: [PATCH] fix: preserve zero-valued content and valid jumper markup

---
 src/Options.tsx                          |  8 +--
 src/Pager.tsx                            |  3 +-
 src/Pagination.tsx                       |  6 +--
 tests/__snapshots__/demo.test.tsx.snap   |  4 +-
 tests/__snapshots__/simple.test.tsx.snap |  8 +--
 tests/hydration.test.tsx                 | 63 ++++++++++++++++++++++++
 tests/renderability.test.tsx             | 47 ++++++++++++++++++
 7 files changed, 125 insertions(+), 14 deletions(-)
 create mode 100644 tests/hydration.test.tsx
 create mode 100644 tests/renderability.test.tsx

diff --git a/src/Options.tsx b/src/Options.tsx
index aa570dc0..7abebba2 100644
--- a/src/Options.tsx
+++ b/src/Options.tsx
@@ -1,4 +1,4 @@
-import { KeyCode } from '@rc-component/util';
+import { isReactRenderable, KeyCode } from '@rc-component/util';
 import React from 'react';
 import type { PaginationLocale } from './interface';
 
@@ -21,7 +21,7 @@ interface OptionsProps {
   selectPrefixCls?: string;
   pageSize: number;
   pageSizeOptions?: number[];
-  goButton?: boolean | string;
+  goButton?: React.ReactNode;
   changeSize?: (size: number) => void;
   quickGo?: (value: number) => void;
   buildOptionText?: (value: number | string) => string;
@@ -67,7 +67,7 @@ const Options: React.FC<OptionsProps> = (props) => {
   };
 
   const handleBlur = (e: React.FocusEvent<HTMLInputElement, Element>) => {
-    if (goButton || goInputText === '') {
+    if (isReactRenderable(goButton) || goInputText === '') {
       return;
     }
     setGoInputText('');
@@ -137,7 +137,7 @@ const Options: React.FC<OptionsProps> = (props) => {
 
   // >>>>> Quick Go
   if (quickGo) {
-    if (goButton) {
+    if (isReactRenderable(goButton)) {
       gotoButton =
         typeof goButton === 'boolean' ? (
           <button
diff --git a/src/Pager.tsx b/src/Pager.tsx
index 5a512afd..7c2de827 100644
--- a/src/Pager.tsx
+++ b/src/Pager.tsx
@@ -1,6 +1,7 @@
 /* eslint react/prop-types: 0 */
 import { clsx } from 'clsx';
 import React from 'react';
+import { isReactRenderable } from '@rc-component/util';
 import type { PaginationProps } from './interface';
 
 export interface PagerProps extends Pick<PaginationProps, 'itemRender'> {
@@ -61,7 +62,7 @@ const Pager: React.FC<PagerProps> = (props) => {
   );
   const pagerLabel = `${pageLabel} ${page}`.trim();
 
-  return pager ? (
+  return isReactRenderable(pager) ? (
     <li
       title={showTitle ? String(page) : null}
       className={cls}
diff --git a/src/Pagination.tsx b/src/Pagination.tsx
index 2ca06bd8..757eec17 100644
--- a/src/Pagination.tsx
+++ b/src/Pagination.tsx
@@ -374,7 +374,7 @@ const Pagination: React.FC<PaginationProps> = (props) => {
 
   if (simple) {
     // ====== Simple quick jump ======
-    if (goButton) {
+    if (isReactRenderable(goButton)) {
       if (typeof goButton === 'boolean') {
         gotoButton = (
           <button type="button" onClick={handleGoTO} onKeyUp={handleGoTO}>
@@ -390,12 +390,12 @@ const Pagination: React.FC<PaginationProps> = (props) => {
       }
 
       gotoButton = (
-        <li
+        <span
           title={showTitle ? `${locale.jump_to}${current}/${allPages}` : null}
           className={`${prefixCls}-simple-pager`}
         >
           {gotoButton}
-        </li>
+        </span>
       );
     }
 
diff --git a/tests/__snapshots__/demo.test.tsx.snap b/tests/__snapshots__/demo.test.tsx.snap
index 2b1ffd7e..8b744cee 100644
--- a/tests/__snapshots__/demo.test.tsx.snap
+++ b/tests/__snapshots__/demo.test.tsx.snap
@@ -2727,7 +2727,7 @@ exports[`Example jumperWithGoButton 1`] = `
         />
         页
         <span>
-          <li
+          <span
             class="rc-pagination-simple-pager"
             title="跳至1/5"
           >
@@ -2736,7 +2736,7 @@ exports[`Example jumperWithGoButton 1`] = `
             >
               确定
             </button>
-          </li>
+          </span>
         </span>
       </div>
     </li>
diff --git a/tests/__snapshots__/simple.test.tsx.snap b/tests/__snapshots__/simple.test.tsx.snap
index db9c27d9..db8a2a83 100644
--- a/tests/__snapshots__/simple.test.tsx.snap
+++ b/tests/__snapshots__/simple.test.tsx.snap
@@ -26,7 +26,7 @@ exports[`simple Pagination props: showQuickJumper should render normally quick-j
   />
   页
   <span>
-    <li
+    <span
       class="rc-pagination-simple-pager"
       title="跳至1/5"
     >
@@ -37,7 +37,7 @@ exports[`simple Pagination props: showQuickJumper should render normally quick-j
           go
         </button>
       </span>
-    </li>
+    </span>
   </span>
 </div>
 `;
@@ -54,7 +54,7 @@ exports[`simple Pagination props: showQuickJumper should render normally quick-j
   />
   页
   <span>
-    <li
+    <span
       class="rc-pagination-simple-pager"
       title="跳至1/5"
     >
@@ -63,7 +63,7 @@ exports[`simple Pagination props: showQuickJumper should render normally quick-j
       >
         确定
       </button>
-    </li>
+    </span>
   </span>
 </div>
 `;
diff --git a/tests/hydration.test.tsx b/tests/hydration.test.tsx
new file mode 100644
index 00000000..267edfe5
--- /dev/null
+++ b/tests/hydration.test.tsx
@@ -0,0 +1,63 @@
+import React from 'react';
+import { act, fireEvent } from '@testing-library/react';
+import { hydrateRoot, type Root } from 'react-dom/client';
+import { renderToString } from 'react-dom/server';
+import Pagination from '../src';
+
+describe('simple Pagination hydration', () => {
+  it.each([
+    0,
+    true,
+    <button key="custom" type="button">
+      Go
+    </button>,
+  ])(
+    'hydrates a go button without replacing server nodes: %s',
+    async (goButton) => {
+      const onChange = jest.fn();
+      const onRecoverableError = jest.fn();
+      const node = (
+        <Pagination
+          simple
+          total={100}
+          showQuickJumper={{ goButton }}
+          onChange={onChange}
+        />
+      );
+      const container = document.createElement('div');
+      container.innerHTML = renderToString(node);
+      document.body.appendChild(container);
+      const serverRoot = container.firstElementChild;
+      const serverInput = container.querySelector('input');
+      let root: Root;
+
+      try {
+        await act(async () => {
+          root = hydrateRoot(container, node, { onRecoverableError });
+        });
+
+        expect(onRecoverableError).not.toHaveBeenCalled();
+        expect(container.firstElementChild).toBe(serverRoot);
+        expect(container.querySelector('input')).toBe(serverInput);
+        expect(container.querySelector('li li')).toBeNull();
+
+        const button = container.querySelector(
+          '.rc-pagination-options .rc-pagination-simple-pager',
+        ).firstElementChild;
+        fireEvent.change(serverInput, { target: { value: '3' } });
+        fireEvent.click(button);
+        expect(onChange).toHaveBeenLastCalledWith(3, 10);
+
+        const quickInput = container.querySelector(
+          '.rc-pagination-options-quick-jumper input',
+        );
+        fireEvent.change(quickInput, { target: { value: '4' } });
+        fireEvent.keyUp(button, { key: 'Enter', keyCode: 13, which: 13 });
+        expect(onChange).toHaveBeenLastCalledWith(4, 10);
+      } finally {
+        await act(async () => root?.unmount());
+        container.remove();
+      }
+    },
+  );
+});
diff --git a/tests/renderability.test.tsx b/tests/renderability.test.tsx
new file mode 100644
index 00000000..de2ee1f2
--- /dev/null
+++ b/tests/renderability.test.tsx
@@ -0,0 +1,47 @@
+import React from 'react';
+import { fireEvent, render } from '@testing-library/react';
+import Pagination from '../src';
+
+describe('ReactNode renderability', () => {
+  it('keeps zero page content clickable', () => {
+    const onChange = jest.fn();
+    const { container } = render(
+      <Pagination
+        total={30}
+        onChange={onChange}
+        itemRender={(_, type, node) => (type === 'page' ? 0 : node)}
+      />,
+    );
+    const page = container.querySelector('.rc-pagination-item-2');
+    expect(page.textContent).toBe('0');
+    fireEvent.click(page);
+    expect(onChange).toHaveBeenCalledWith(2, 10);
+  });
+
+  it.each([false, true])(
+    'keeps a zero go button interactive in simple=%s',
+    (simple) => {
+      const onChange = jest.fn();
+      const { container } = render(
+        <Pagination
+          simple={simple}
+          total={100}
+          onChange={onChange}
+          showQuickJumper={{ goButton: 0 }}
+        />,
+      );
+      const input = container.querySelector('input');
+      fireEvent.change(input, { target: { value: '3' } });
+      const button = Array.from(container.querySelectorAll('span')).find(
+        (node) => node.textContent === '0' && node.childElementCount === 0,
+      );
+      expect(button).toBeTruthy();
+      if (!simple) {
+        fireEvent.blur(input);
+        expect(onChange).not.toHaveBeenCalled();
+      }
+      fireEvent.click(button);
+      expect(onChange).toHaveBeenCalledWith(3, 10);
+    },
+  );
+});