From 6ec1cf21f13caebf2714c4466f7c09218fb6307c Mon Sep 17 00:00:00 2001
From: neverland <jait.chen@foxmail.com>
Date: Sun, 29 Oct 2023 17:04:27 +0800
Subject: [PATCH] docs(Signature): add resize method (#12411)

---
 packages/vant/src/signature/README.md       | 23 +++++++++++++++++++--
 packages/vant/src/signature/README.zh-CN.md | 23 +++++++++++++++++++--
 packages/vant/src/space/README.zh-CN.md     |  2 +-
 3 files changed, 43 insertions(+), 5 deletions(-)

diff --git a/packages/vant/src/signature/README.md b/packages/vant/src/signature/README.md
index 294b0bc30..494fa9a8e 100644
--- a/packages/vant/src/signature/README.md
+++ b/packages/vant/src/signature/README.md
@@ -99,12 +99,31 @@ Use `background-color` prop to set the color of the background.
 | submit | Emitted when clicking the confirm button | _data: { image: string; canvas: HTMLCanvasElement }_ |
 | clear | Emitted when clicking the cancel button | - |
 
+### Methods
+
+Use [ref](https://vuejs.org/guide/essentials/template-refs.html) to get Signature instance and call instance methods.
+
+| Name | Description | Attribute | Return value |
+| --- | --- | --- | --- |
+| resize `v4.7.3` | Resize Signature when container element resized or visibility changed | - | - |
+
 ### Types
 
 The component exports the following type definitions:
 
-```js
-import type { SignatureProps } from 'vant';
+```ts
+import type { SignatureProps, SignatureInstance } from 'vant';
+```
+
+`SignatureInstance` is the type of component instance:
+
+```ts
+import { ref } from 'vue';
+import type { SignatureInstance } from 'vant';
+
+const signatureRef = ref<SignatureInstance>();
+
+signatureRef.value?.resize();
 ```
 
 ## Theming
diff --git a/packages/vant/src/signature/README.zh-CN.md b/packages/vant/src/signature/README.zh-CN.md
index 373136406..dccf64ca3 100644
--- a/packages/vant/src/signature/README.zh-CN.md
+++ b/packages/vant/src/signature/README.zh-CN.md
@@ -99,12 +99,31 @@ export default {
 | submit | 点击确定按钮时触发 | _data: { image: string; canvas: HTMLCanvasElement }_ |
 | clear | 点击取消按钮时触发 | - |
 
+### 方法
+
+通过 ref 可以获取到 Signature 实例并调用实例方法，详见[组件实例方法](#/zh-CN/advanced-usage#zu-jian-shi-li-fang-fa)。
+
+| 方法名 | 说明 | 参数 | 返回值 |
+| --- | --- | --- | --- |
+| resize `v4.7.3` | 外层元素大小或组件显示状态变化时，可以调用此方法来触发重绘 | - | - |
+
 ### 类型定义
 
 组件导出以下类型定义：
 
-```js
-import type { SignatureProps } from 'vant';
+```ts
+import type { SignatureProps, SignatureInstance } from 'vant';
+```
+
+`SignatureInstance` 是组件实例的类型，用法如下：
+
+```ts
+import { ref } from 'vue';
+import type { SignatureInstance } from 'vant';
+
+const signatureRef = ref<SignatureInstance>();
+
+signatureRef.value?.resize();
 ```
 
 ## 主题定制
diff --git a/packages/vant/src/space/README.zh-CN.md b/packages/vant/src/space/README.zh-CN.md
index c3569d6be..62f59bde8 100644
--- a/packages/vant/src/space/README.zh-CN.md
+++ b/packages/vant/src/space/README.zh-CN.md
@@ -135,6 +135,6 @@ export default {
 
 组件导出以下类型定义：
 
-```js
+```ts
 import type { SpaceProps, SpaceSize, SpaceAlign } from 'vant';
 ```