From 30a4143afc53aacdffbe09ec2111a8feed4020cb Mon Sep 17 00:00:00 2001
From: MadCcc <madccc@foxmail.com>
Date: Tue, 23 Jan 2024 20:33:53 +0800
Subject: [PATCH] docs: add pagination design page (#47119)

---
 .../pagination/design/behavior-pattern.tsx    | 39 +++++++++++++++++++
 components/pagination/design/demo/basic.tsx   |  6 +++
 .../pagination/design/demo/large-amount.tsx   |  6 +++
 components/pagination/design/demo/mini.tsx    | 20 ++++++++++
 .../pagination/design/demo/page-size.tsx      |  6 +++
 .../pagination/design/demo/quick-jump.tsx     |  6 +++
 components/pagination/design/demo/simple.tsx  |  8 ++++
 components/pagination/design/demo/total.tsx   | 13 +++++++
 .../pagination/index.$tab-design.zh-CN.md     | 27 +++++++++++++
 9 files changed, 131 insertions(+)
 create mode 100644 components/pagination/design/behavior-pattern.tsx
 create mode 100644 components/pagination/design/demo/basic.tsx
 create mode 100644 components/pagination/design/demo/large-amount.tsx
 create mode 100644 components/pagination/design/demo/mini.tsx
 create mode 100644 components/pagination/design/demo/page-size.tsx
 create mode 100644 components/pagination/design/demo/quick-jump.tsx
 create mode 100644 components/pagination/design/demo/simple.tsx
 create mode 100644 components/pagination/design/demo/total.tsx
 create mode 100644 components/pagination/index.$tab-design.zh-CN.md

diff --git a/components/pagination/design/behavior-pattern.tsx b/components/pagination/design/behavior-pattern.tsx
new file mode 100644
index 0000000000..04682aebb3
--- /dev/null
+++ b/components/pagination/design/behavior-pattern.tsx
@@ -0,0 +1,39 @@
+import React from 'react';
+
+import BehaviorMap from '../../../.dumi/theme/common/BehaviorMap';
+
+const BehaviorPattern: React.FC = () => (
+  <BehaviorMap
+    data={{
+      id: '200000004',
+      label: '跳转页面',
+      children: [
+        {
+          id: '500000061',
+          label: '跳转至指定页面',
+          targetType: 'mvp',
+        },
+        {
+          id: '200000005',
+          label: '调整单页展示条数',
+          targetType: 'extension',
+          link: 'components-pagination-index-tab-design-demo-page-size',
+        },
+        {
+          id: '200000006',
+          label: '快速跳转',
+          targetType: 'extension',
+          link: 'components-pagination-index-tab-design-demo-quick-jump',
+        },
+        {
+          id: '200000007',
+          label: '了解数据总量',
+          targetType: 'extension',
+          link: 'components-pagination-index-tab-design-demo-total',
+        },
+      ],
+    }}
+  />
+);
+
+export default BehaviorPattern;
diff --git a/components/pagination/design/demo/basic.tsx b/components/pagination/design/demo/basic.tsx
new file mode 100644
index 0000000000..730c16b65c
--- /dev/null
+++ b/components/pagination/design/demo/basic.tsx
@@ -0,0 +1,6 @@
+import React from 'react';
+import { Pagination } from 'antd';
+
+const App: React.FC = () => <Pagination defaultCurrent={2} total={50} showSizeChanger={false} />;
+
+export default App;
diff --git a/components/pagination/design/demo/large-amount.tsx b/components/pagination/design/demo/large-amount.tsx
new file mode 100644
index 0000000000..72b5eb7589
--- /dev/null
+++ b/components/pagination/design/demo/large-amount.tsx
@@ -0,0 +1,6 @@
+import React from 'react';
+import { Pagination } from 'antd';
+
+const App: React.FC = () => <Pagination defaultCurrent={5} total={100} showSizeChanger={false} />;
+
+export default App;
diff --git a/components/pagination/design/demo/mini.tsx b/components/pagination/design/demo/mini.tsx
new file mode 100644
index 0000000000..52b5b84cee
--- /dev/null
+++ b/components/pagination/design/demo/mini.tsx
@@ -0,0 +1,20 @@
+import React from 'react';
+import { Flex, Pagination } from 'antd';
+
+const App: React.FC = () => (
+  <Flex vertical gap="middle">
+    <Pagination defaultCurrent={1} total={50} showSizeChanger={false} size="small" />
+    <Pagination defaultCurrent={1} total={100} showSizeChanger={false} size="small" />
+    <Pagination defaultCurrent={1} total={100} size="small" />
+    <Pagination defaultCurrent={1} total={100} showQuickJumper size="small" />
+    <Pagination
+      defaultCurrent={1}
+      total={100}
+      showQuickJumper
+      size="small"
+      showTotal={(total, range) => `第 ${range.join('-')} 条 / 共 ${total} 条`}
+    />
+  </Flex>
+);
+
+export default App;
diff --git a/components/pagination/design/demo/page-size.tsx b/components/pagination/design/demo/page-size.tsx
new file mode 100644
index 0000000000..bd4f45e7ff
--- /dev/null
+++ b/components/pagination/design/demo/page-size.tsx
@@ -0,0 +1,6 @@
+import React from 'react';
+import { Pagination } from 'antd';
+
+const App: React.FC = () => <Pagination defaultCurrent={3} total={500} />;
+
+export default App;
diff --git a/components/pagination/design/demo/quick-jump.tsx b/components/pagination/design/demo/quick-jump.tsx
new file mode 100644
index 0000000000..fc917c4ef1
--- /dev/null
+++ b/components/pagination/design/demo/quick-jump.tsx
@@ -0,0 +1,6 @@
+import React from 'react';
+import { Pagination } from 'antd';
+
+const App: React.FC = () => <Pagination defaultCurrent={3} total={500} showQuickJumper />;
+
+export default App;
diff --git a/components/pagination/design/demo/simple.tsx b/components/pagination/design/demo/simple.tsx
new file mode 100644
index 0000000000..8badd57a67
--- /dev/null
+++ b/components/pagination/design/demo/simple.tsx
@@ -0,0 +1,8 @@
+import React from 'react';
+import { Pagination } from 'antd';
+
+const App: React.FC = () => (
+  <Pagination defaultCurrent={2} total={50} showSizeChanger={false} simple />
+);
+
+export default App;
diff --git a/components/pagination/design/demo/total.tsx b/components/pagination/design/demo/total.tsx
new file mode 100644
index 0000000000..7912161a50
--- /dev/null
+++ b/components/pagination/design/demo/total.tsx
@@ -0,0 +1,13 @@
+import React from 'react';
+import { Pagination } from 'antd';
+
+const App: React.FC = () => (
+  <Pagination
+    defaultCurrent={3}
+    total={500}
+    showQuickJumper
+    showTotal={(total, range) => `第 ${range.join('-')} 条 / 共 ${total} 条`}
+  />
+);
+
+export default App;
diff --git a/components/pagination/index.$tab-design.zh-CN.md b/components/pagination/index.$tab-design.zh-CN.md
new file mode 100644
index 0000000000..973c9771ae
--- /dev/null
+++ b/components/pagination/index.$tab-design.zh-CN.md
@@ -0,0 +1,27 @@
+## 组件定义
+
+Pagination的本质是控制单页内信息数量，可跳转页面。
+
+<code src="./design/behavior-pattern.tsx" inline></code>
+
+## 基础使用
+
+<code src="./design/demo/basic" description="最基础的分页控件，仅展示页码。" tip="建议使用在内容少于10页的轻量化分页场景。">少量页面</code>
+
+<code src="./design/demo/large-amount" description="拥有大量数据需要展示，通过分页能够让用户快速定位当前页码。展示首尾页码，部分页码省略。" tip="建议使用在内容超过10页以上的分页场景。">大量页面</code>
+
+## 交互变体
+
+<code src="./design/demo/page-size" description="可根据用户需求对每页展示条目数进行调整。">调整单页展示条数</code>
+
+<code src="./design/demo/quick-jump" description="当数据有快速定位的需求时，输入页码，可快速跳转到指定页。">快速跳转</code>
+
+<code src="./design/demo/total" description="用户无需全部浏览即可快速了解数据总量。常用于表格内的数据统计。">了解数据总量</code>
+
+## 样式变体
+
+<code src="./design/demo/simple" description="极度简单的分页控件，只展示当前页、总页数及上下翻页。适用于模块内的横向空间较少的场景。">简洁分页</code>
+
+<code src="./design/demo/mini" description="小尺寸的分页控件。适用于模块内的空间较少，需要轻量化的翻页的场景。">迷你版分页</code>
+
+<code src="./demo/itemRender" description="修改上一步和下一步为文字链接。">上一步和下一步</code>