From 81d36aa9ac30db199f1851aa617966141a669e25 Mon Sep 17 00:00:00 2001
From: neverland <jait.chen@foxmail.com>
Date: Sun, 26 Mar 2023 12:11:42 +0800
Subject: [PATCH] docs(Field): consistent with demo (#11707)

---
 package.json                                  |  1 +
 packages/vant/src/field/README.md             | 24 ++++++++++++++++---
 packages/vant/src/field/README.zh-CN.md       | 22 +++++++++++++++--
 packages/vant/src/field/demo/LabelAlign.vue   | 20 ++++++++--------
 .../test/__snapshots__/demo.spec.ts.snap      | 16 ++++++-------
 5 files changed, 60 insertions(+), 23 deletions(-)

diff --git a/package.json b/package.json
index 31ef5bb94..b43da6cff 100644
--- a/package.json
+++ b/package.json
@@ -6,6 +6,7 @@
     "lint": "pnpm --dir ./packages/vant lint",
     "test": "pnpm --dir ./packages/vant test",
     "test:watch": "pnpm --dir ./packages/vant test:watch",
+    "test:update": "pnpm --dir ./packages/vant test:update",
     "build": "pnpm --dir ./packages/vant build",
     "build:site": "pnpm --dir ./packages/vant build:site"
   },
diff --git a/packages/vant/src/field/README.md b/packages/vant/src/field/README.md
index 229e8bdd0..829461c5c 100644
--- a/packages/vant/src/field/README.md
+++ b/packages/vant/src/field/README.md
@@ -243,16 +243,34 @@ Use `input-align` prop to align the input value.
 
 ### Label Align
 
-Use `label-align` prop to align the input value.
+Use `label-align` prop to align the input value, can be set to `center`, `right` or `top`.
 
 ```html
 <van-cell-group inset>
   <van-field
     v-model="value"
-    label="Tel"
-    placeholder="Please input tel number"
+    label="Label"
+    placeholder="Align Top"
     label-align="top"
   />
+  <van-field
+    v-model="value2"
+    label="Label"
+    placeholder="Align Left"
+    label-align="left"
+  />
+  <van-field
+    v-model="value3"
+    label="Label"
+    placeholder="Align Center"
+    label-align="center"
+  />
+  <van-field
+    v-model="value4"
+    label="Label"
+    placeholder="Align Right"
+    label-align="right"
+  />
 </van-cell-group>
 ```
 
diff --git a/packages/vant/src/field/README.zh-CN.md b/packages/vant/src/field/README.zh-CN.md
index 9c9648ac1..aa1c9a49c 100644
--- a/packages/vant/src/field/README.zh-CN.md
+++ b/packages/vant/src/field/README.zh-CN.md
@@ -268,10 +268,28 @@ export default {
 <van-cell-group inset>
   <van-field
     v-model="value"
-    label="手机号"
-    placeholder="请输入手机号"
+    label="文本"
+    placeholder="顶部对齐"
     label-align="top"
   />
+  <van-field
+    v-model="value2"
+    label="文本"
+    placeholder="左对齐"
+    label-align="left"
+  />
+  <van-field
+    v-model="value3"
+    label="文本"
+    placeholder="居中对齐"
+    label-align="center"
+  />
+  <van-field
+    v-model="value4"
+    label="文本"
+    placeholder="右对齐"
+    label-align="right"
+  />
 </van-cell-group>
 ```
 
diff --git a/packages/vant/src/field/demo/LabelAlign.vue b/packages/vant/src/field/demo/LabelAlign.vue
index a390367a4..023a3e795 100644
--- a/packages/vant/src/field/demo/LabelAlign.vue
+++ b/packages/vant/src/field/demo/LabelAlign.vue
@@ -6,7 +6,7 @@ import { useTranslate } from '../../../docs/site';
 
 const t = useTranslate({
   'zh-CN': {
-    text: '文本',
+    label: '文本',
     top: '顶部对齐',
     center: '居中对齐',
     left: '左对齐',
@@ -14,11 +14,11 @@ const t = useTranslate({
     labelAlign: '输入框文本位置',
   },
   'en-US': {
-    text: 'Text',
-    top: 'Top Align',
-    center: 'Center Align',
-    left: 'Left Align',
-    right: 'Right Align',
+    label: 'Label',
+    top: 'Align Top',
+    center: 'Align Center',
+    left: 'Align Left',
+    right: 'Align Right',
     labelAlign: 'Label Align',
   },
 });
@@ -31,25 +31,25 @@ const value = ref('');
     <van-cell-group inset>
       <van-field
         v-model="value"
-        :label="t('text')"
+        :label="t('label')"
         :placeholder="t('top')"
         label-align="top"
       />
       <van-field
         v-model="value"
-        :label="t('text')"
+        :label="t('label')"
         :placeholder="t('left')"
         label-align="left"
       />
       <van-field
         v-model="value"
-        :label="t('text')"
+        :label="t('label')"
         :placeholder="t('center')"
         label-align="center"
       />
       <van-field
         v-model="value"
-        :label="t('text')"
+        :label="t('label')"
         :placeholder="t('right')"
         label-align="right"
       />
diff --git a/packages/vant/src/field/test/__snapshots__/demo.spec.ts.snap b/packages/vant/src/field/test/__snapshots__/demo.spec.ts.snap
index ca5993ad9..1fc319a6d 100644
--- a/packages/vant/src/field/test/__snapshots__/demo.spec.ts.snap
+++ b/packages/vant/src/field/test/__snapshots__/demo.spec.ts.snap
@@ -424,7 +424,7 @@ exports[`should render demo and match snapshot 1`] = `
         <label id="van-field-label"
                for="van-field-input"
         >
-          Text
+          Label
         </label>
       </div>
       <div class="van-cell__value van-field__value">
@@ -432,7 +432,7 @@ exports[`should render demo and match snapshot 1`] = `
           <input type="text"
                  id="van-field-input"
                  class="van-field__control"
-                 placeholder="Top Align"
+                 placeholder="Align Top"
                  aria-labelledby="van-field-label"
           >
         </div>
@@ -443,7 +443,7 @@ exports[`should render demo and match snapshot 1`] = `
         <label id="van-field-label"
                for="van-field-input"
         >
-          Text
+          Label
         </label>
       </div>
       <div class="van-cell__value van-field__value">
@@ -451,7 +451,7 @@ exports[`should render demo and match snapshot 1`] = `
           <input type="text"
                  id="van-field-input"
                  class="van-field__control"
-                 placeholder="Left Align"
+                 placeholder="Align Left"
                  aria-labelledby="van-field-label"
           >
         </div>
@@ -462,7 +462,7 @@ exports[`should render demo and match snapshot 1`] = `
         <label id="van-field-label"
                for="van-field-input"
         >
-          Text
+          Label
         </label>
       </div>
       <div class="van-cell__value van-field__value">
@@ -470,7 +470,7 @@ exports[`should render demo and match snapshot 1`] = `
           <input type="text"
                  id="van-field-input"
                  class="van-field__control"
-                 placeholder="Center Align"
+                 placeholder="Align Center"
                  aria-labelledby="van-field-label"
           >
         </div>
@@ -481,7 +481,7 @@ exports[`should render demo and match snapshot 1`] = `
         <label id="van-field-label"
                for="van-field-input"
         >
-          Text
+          Label
         </label>
       </div>
       <div class="van-cell__value van-field__value">
@@ -489,7 +489,7 @@ exports[`should render demo and match snapshot 1`] = `
           <input type="text"
                  id="van-field-input"
                  class="van-field__control"
-                 placeholder="Right Align"
+                 placeholder="Align Right"
                  aria-labelledby="van-field-label"
           >
         </div>