From d56623ef77ef18923913646d8a5f6f22edce20e7 Mon Sep 17 00:00:00 2001
From: neverland <jait.chen@foxmail.com>
Date: Fri, 6 Oct 2023 10:00:13 +0800
Subject: [PATCH] feat(Notify): add jsdoc for utility functions (#12342)

---
 packages/vant/src/notify/README.md         |  8 ++++----
 packages/vant/src/notify/README.zh-CN.md   |  4 ++--
 packages/vant/src/notify/function-call.tsx | 12 ++++++++++++
 3 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/packages/vant/src/notify/README.md b/packages/vant/src/notify/README.md
index 294ea7d24..0caaf6ff8 100644
--- a/packages/vant/src/notify/README.md
+++ b/packages/vant/src/notify/README.md
@@ -115,10 +115,10 @@ Vant exports following Notify utility functions:
 
 | Methods | Description | Attribute | Return value |
 | --- | --- | --- | --- |
-| showNotify | Show notify | `NotifyOptions \| string` | notify instance |
-| closeNotify | Close notify | - | `void` |
-| setNotifyDefaultOptions | Set default options of all notifies | `NotifyOptions` | `void` |
-| resetNotifyDefaultOptions | Reset default options of all notifies | - | `void` |
+| showNotify | Display Notify at the top of the page | `NotifyOptions \| string` | Notify instance |
+| closeNotify | Close the currently displayed Notify | - | `void` |
+| setNotifyDefaultOptions | Modify the default configuration, affecting all `showNotify` calls | `NotifyOptions` | `void` |
+| resetNotifyDefaultOptions | Reset the default configuration, affecting all `showNotify` calls | - | `void` |
 
 ### NotifyOptions
 
diff --git a/packages/vant/src/notify/README.zh-CN.md b/packages/vant/src/notify/README.zh-CN.md
index b3fc4ab40..6889647b1 100644
--- a/packages/vant/src/notify/README.zh-CN.md
+++ b/packages/vant/src/notify/README.zh-CN.md
@@ -128,8 +128,8 @@ Vant 中导出了以下 Notify 相关的辅助函数：
 
 | 方法名 | 说明 | 参数 | 返回值 |
 | --- | --- | --- | --- |
-| showNotify | 展示提示 | `NotifyOptions \| string` | notify 实例 |
-| closeNotify | 关闭提示 | - | `void` |
+| showNotify | 在页面顶部展示 Notify | `NotifyOptions \| string` | notify 实例 |
+| closeNotify | 关闭当前展示的 Notify | - | `void` |
 | setNotifyDefaultOptions | 修改默认配置，影响所有的 `showNotify` 调用 | `NotifyOptions` | `void` |
 | resetNotifyDefaultOptions | 重置默认配置，影响所有的 `showNotify` 调用 | - | `void` |
 
diff --git a/packages/vant/src/notify/function-call.tsx b/packages/vant/src/notify/function-call.tsx
index 9b79e93ef..cdd906b97 100644
--- a/packages/vant/src/notify/function-call.tsx
+++ b/packages/vant/src/notify/function-call.tsx
@@ -34,12 +34,18 @@ const getDefaultOptions = (): NotifyOptions => ({
 
 let currentOptions = getDefaultOptions();
 
+/**
+ * Close the currently displayed Notify
+ */
 export const closeNotify = () => {
   if (instance) {
     instance.toggle(false);
   }
 };
 
+/**
+ * Display Notify at the top of the page
+ */
 export function showNotify(options: NotifyMessage | NotifyOptions) {
   if (!inBrowser) {
     return;
@@ -61,9 +67,15 @@ export function showNotify(options: NotifyMessage | NotifyOptions) {
   return instance;
 }
 
+/**
+ * Modify the default configuration, affecting all `showNotify` calls
+ */
 export const setNotifyDefaultOptions = (options: NotifyOptions) =>
   extend(currentOptions, options);
 
+/**
+ * Reset the default configuration, affecting all `showNotify` calls
+ */
 export const resetNotifyDefaultOptions = () => {
   currentOptions = getDefaultOptions();
 };