From f29ae8dfc29c309ddb76c2f5d1218fb55977658e Mon Sep 17 00:00:00 2001
From: wxsm <wxsms@foxmail.com>
Date: Wed, 25 Aug 2021 11:21:08 +0800
Subject: [PATCH 1/8] update attribute-coercion.md

---
 src/guide/migration/attribute-coercion.md | 53 +++++++++++------------
 1 file changed, 26 insertions(+), 27 deletions(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index ae24c52cd..f24ee83ac 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -6,15 +6,15 @@ badges:
 # attribute 强制行为 <MigrationBadges :badges="$frontmatter.badges" />
 
 :::info 信息
-这是一个低等级的内部 API 更改，不会影响大多数开发人员。
+这是一个底层的内部 API 更改，绝大多数开发人员不会受到影响。
 :::
 
 ## 概览
 
-下面是对这些变化的高层次总结：
+以下是对变化的总体概述：
 
-- 删除枚举 attribute 的内部概念，并将这些 attribute 视为普通的非布尔 attribute
-- **重大改变**：如果值为布尔值，则不再删除 attribute `false`。相反，它被设置为 attr=“false”。移除 attribute，应该使用 `null` 或者 `undefined`。
+- 移除枚举 attribute 的内部概念，并将这些 attribute 视为普通的非布尔 attribute
+- **非兼容**：如果值为布尔值 `false`，则不再移除 attribute。取而代之的是，它将被设置为 attr="false"。若要移除 attribute，应该使用 `null` 或者 `undefined`。
 
 如需更深入的解释，请继续阅读！
 
@@ -22,13 +22,13 @@ badges:
 
 在 2.x，我们有以下策略来强制 `v-bind` 的值：
 
-- 对于某些 attribute/元素对，Vue 始终使用相应的 IDL attribute(property)：[比如拥有 `value` 的 `<input>`，`<select>`，`<progress>`，等等](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L11-L18)。
+- 对于某些 attribute/元素对，Vue 始终使用相应的 IDL attribute (property)：[比如 `<input>`，`<select>`，`<progress>` 的 `value`，等等](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L11-L18)。
 
-- 对于“[布尔 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L33-L40)”和 [xlinks](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L44-L46)，如果它们是 `falsy` 的，Vue 会移除它们 ([`undefined`，`null` or `false`](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L52-L54)) ，否则会加上它们 (见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L66-L77)和[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L81-L85))。
+- 对于“[布尔 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L33-L40)”和 [xlinks](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L44-L46)，如果它们是 `falsy` ([`undefined`，`null` 或 `false`](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L52-L54)) 的，Vue 会移除它们，否则会加上。(见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L66-L77)和[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L81-L85))。
 
-- 对于“[枚举 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)” (目前 `contenteditable`，`draggable` 和 `spellcheck`)，Vue 会尝试[强制](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31)将它们串起来 (目前对 `contenteditable` 做了特殊处理，修复 [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397))。
+- 对于“[枚举 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)” (目前来说，`contenteditable`，`draggable` 和 `spellcheck`)，Vue 会尝试将它们[强制](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31)转换为字符串 (目前对 `contenteditable` 做了特殊处理，修复 [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397))。
 
--  对于其他 attribute，我们移除了 `falsy` 值 (`undefined`，`null`，or `false`) 并按原样设置其他值 (见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113))。
+-  对于其他 attribute，我们移除了 `falsy` 值 (`undefined`，`null`，或 `false`)，并按原样设置其他值 (见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113))。
 
 下表描述了 Vue 如何使用普通非布尔 attribute 强制“枚举 attribute”：
 
@@ -43,23 +43,22 @@ badges:
 | `attr="foo"`        | `foo="foo"`             | `draggable="true"`                |
 | `attr`              | `foo=""`                | `draggable="true"`                |
 
-<small>/：移除</small>
 
-从上表可以看出，当前实现 `true` 强制为 `'true'` 但如果 attribute 为 `false`，则移除该 attribute。这也导致了不一致性，并要求用户在非常常见的用例中手动强制布尔值为字符串，例如
+从上表可以看出，当前实现将 `true` 强制转换为了 `'true'`，但如果 attribute 为 `false`，则将其移除。这也导致了不一致性，并要求用户在非常常见的用例中手动将布尔值强制转换为字符串，例如
  `aria-*` attribute，例如 `aria-selected`，`aria-hidden`，等等。
 
 ## 3.x 语法
 
 我们打算放弃“枚举型 attribute”的内部概念，并将它们视为普通的非布尔型 HTML attribute。
 
-- 这就解决了普通非布尔型 attribute 和“枚举型 attribute”之间的不一致性
-- 它还可以使用 `'true'` 和 `'false'` 以外的值，甚至可以使用 `contenteditable` 等 attribute 的关键字
+- 这就解决了普通非布尔型 attribute 和“枚举型 attribute”之间的不一致性问题
+- 它还可以使用 `'true'` 和 `'false'` 以外的值，甚至可以使用如 `contenteditable` 等 attribute 的关键字
 
-对于非布尔型 attribute，如果 attribute 值为 `false`，Vue 将停止删除它们，相反强制它们的值为 `'false'`。
+对于非布尔型 attribute，如果其值为 `false`，Vue 将不再移除它们，而是将其强制转换为 `'false'`。
 
-- 这就解决了 `true` 和 `false` 之间的不一致性，并使输出 `aria-*` attributes 更容易
+- 这就解决了 `true` 和 `false` 之间的不一致性，并更易于输出 `aria-*` attribute
 
-下表描述了新行为：
+下表描述了新的行为：
 
 | 绑定表达式       | `foo` <sup>正常</sup>    | `draggable` <sup>枚举</sup> |
 | ------------------- | -------------------------- | --------------------------------- |
@@ -72,29 +71,29 @@ badges:
 | `attr="foo"`        | `foo="foo"`                | `draggable="foo"` <sup>*</sup>    |
 | `attr`              | `foo=""`                   | `draggable=""` <sup>*</sup>       |
 
-<small>*：变更</small>
+<small>*：已改变</small>
 
-布尔 attributes 的强制保持不变。
+布尔型 attribute 的强制保持不变。
 
 ## 迁移策略
 
 ### 枚举 attribute
 
-缺少值的枚举 attribute 和 `attr="false"` 可能会产生不同的 IDL attribute 值 (将反映实际状态)，描述如下：
+缺席的枚举 attribute 和 `attr="false"` 可能会产生不同的 IDL attribute 值 (将反映实际状态)，描述如下：
 
-| 缺少枚举attr | IDL attr & 值                     |
+| 缺席的枚举attr           | IDL attr & 值                     |
 | ---------------------- | ------------------------------------ |
 | `contenteditable`      | `contentEditable` &rarr; `'inherit'` |
 | `draggable`            | `draggable` &rarr; `false`           |
 | `spellcheck`           | `spellcheck` &rarr; `true`           |
 
-为了保持原有的行为，我们将强制使布尔型 Attribute 的 `false` 转换为 `'false'`，在 3.x Vue 中，开发人员需要将 `v-bind` 表达式解析为 `false` 或 `'false'`，表示 `contenteditable` 和 `spellcheck`。
+为了保持原有的行为能正常工作，我们将强制把 `false` 转换为 `'false'`，在 3.x Vue 中，开发者需要将 `v-bind` 表达式解析为 `false` 或 `'false'`，以表示 `contenteditable` 和 `spellcheck`。
 
-在 2.x 中，枚举 attribute 的无效值被强制为 `'true'`。这通常是无意的，不太可能大规模依赖。在 3.x 中，应显式指定 `true` 或 `'true'`。
+在 2.x 中，枚举 attribute 的无效值被强制转换为 `'true'`。这通常是不符合预期的，且在大规模使用时不太可靠。在 3.x 中，应显式指定 `true` 或 `'true'`。
 
-### 将 `false` 强制转换为 `'false'` 而不是删除 attribute
+### 将 `false` 强制转换为 `'false'` 而不是移除 attribute
 
-在 3.x，`null` 或 `undefined` 应用于显式删除 attribute。
+在 3.x 中，应该使用 `null` 或 `undefined` 以显式移除 attribute。
 
 ### 2.x 和 3.x 行为的比较
 
@@ -102,14 +101,14 @@ badges:
   <thead>
     <tr>
       <th>Attributes</th>
-      <th><code>v-bind</code> value <sup>2.x</sup></th>
-      <th><code>v-bind</code> value <sup>3.x</sup></th>
+      <th><code>v-bind</code> 的值 <sup>2.x</sup></th>
+      <th><code>v-bind</code> 的值 <sup>3.x</sup></th>
       <th>HTML 输出</th>
     </tr>
   </thead>
   <tbody>
     <tr>
-      <td rowspan="3">2.x “枚举attribute”<br><small>i.e. <code>contenteditable</code>, <code>draggable</code> and <code>spellcheck</code>.</small></td>
+      <td rowspan="3">2.x “枚举 attribute”<br><small>即 <code>contenteditable</code>, <code>draggable</code> 与 <code>spellcheck</code>。</small></td>
       <td><code>undefined</code>, <code>false</code></td>
       <td><code>undefined</code>, <code>null</code></td>
       <td><i>removed</i></td>
@@ -128,7 +127,7 @@ badges:
       <td><code>"false"</code></td>
     </tr>
     <tr>
-      <td rowspan="2">其他非布尔attribute<br><small>eg. <code>aria-checked</code>, <code>tabindex</code>, <code>alt</code>, etc.</small></td>
+      <td rowspan="2">其他非布尔 attribute<br><small>如 <code>aria-checked</code>, <code>tabindex</code>, <code>alt</code>，等等。</small></td>
       <td><code>undefined</code>, <code>null</code>, <code>false</code></td>
       <td><code>undefined</code>, <code>null</code></td>
       <td><i>removed</i></td>

From 0dccaf47e3abf0a3446ffcf53f2b6941cce030a4 Mon Sep 17 00:00:00 2001
From: wxsm <wxsms@foxmail.com>
Date: Wed, 25 Aug 2021 11:28:08 +0800
Subject: [PATCH 2/8] update attribute-coercion.md

---
 src/guide/migration/attribute-coercion.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index f24ee83ac..998443a88 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -22,7 +22,7 @@ badges:
 
 在 2.x，我们有以下策略来强制 `v-bind` 的值：
 
-- 对于某些 attribute/元素对，Vue 始终使用相应的 IDL attribute (property)：[比如 `<input>`，`<select>`，`<progress>` 的 `value`，等等](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L11-L18)。
+- 对于某些 attribute/元素对，Vue 始终使用相应的 IDL attribute (property)：[比如 `<input>`，`<select>`，`<progress>` 中的 `value`，等等](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L11-L18)。
 
 - 对于“[布尔 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L33-L40)”和 [xlinks](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L44-L46)，如果它们是 `falsy` ([`undefined`，`null` 或 `false`](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L52-L54)) 的，Vue 会移除它们，否则会加上。(见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L66-L77)和[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L81-L85))。
 
@@ -73,7 +73,7 @@ badges:
 
 <small>*：已改变</small>
 
-布尔型 attribute 的强制保持不变。
+布尔型 attribute 的强制转换保持不变。
 
 ## 迁移策略
 
@@ -81,7 +81,7 @@ badges:
 
 缺席的枚举 attribute 和 `attr="false"` 可能会产生不同的 IDL attribute 值 (将反映实际状态)，描述如下：
 
-| 缺席的枚举attr           | IDL attr & 值                     |
+| 缺席的枚举 attr           | IDL attr & 值                     |
 | ---------------------- | ------------------------------------ |
 | `contenteditable`      | `contentEditable` &rarr; `'inherit'` |
 | `draggable`            | `draggable` &rarr; `false`           |

From 00b6faca9cf80029fb619f76f31711f150899847 Mon Sep 17 00:00:00 2001
From: wxsm <wxsms@foxmail.com>
Date: Wed, 25 Aug 2021 11:43:32 +0800
Subject: [PATCH 3/8] update attribute-coercion.md

---
 src/guide/migration/attribute-coercion.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 998443a88..8ab5fc7be 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -26,11 +26,11 @@ badges:
 
 - 对于“[布尔 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L33-L40)”和 [xlinks](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L44-L46)，如果它们是 `falsy` ([`undefined`，`null` 或 `false`](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L52-L54)) 的，Vue 会移除它们，否则会加上。(见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L66-L77)和[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L81-L85))。
 
-- 对于“[枚举 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)” (目前来说，`contenteditable`，`draggable` 和 `spellcheck`)，Vue 会尝试将它们[强制](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31)转换为字符串 (目前对 `contenteditable` 做了特殊处理，修复 [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397))。
+- 对于“[枚举 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)” (目前来说：`contenteditable`，`draggable` 和 `spellcheck`)，Vue 会尝试将它们[强制](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31)转换为字符串 (目前对 `contenteditable` 做了特殊处理，以修复 [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397))。
 
--  对于其他 attribute，我们移除了 `falsy` 值 (`undefined`，`null`，或 `false`)，并按原样设置其他值 (见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113))。
+-  对于其他 attribute，我们将移除 `falsy` 的值 (`undefined`，`null`，或 `false`)，其他值按原样设置 (见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113))。
 
-下表描述了 Vue 如何使用普通非布尔 attribute 强制“枚举 attribute”：
+下表描述了 Vue 如何强制转换“枚举 attribute”，以及与普通非布尔 attribute 的不同之处：
 
 | 绑定表达式           | `foo` <sup>正常</sup>   | `draggable` <sup>枚举</sup>       |
 | ------------------- | ----------------------- | --------------------------------- |

From 63be026f69544a30c271f80c55bdc43b77c733c8 Mon Sep 17 00:00:00 2001
From: wxsm <wxsms@foxmail.com>
Date: Wed, 25 Aug 2021 11:46:46 +0800
Subject: [PATCH 4/8] update attribute-coercion.md

---
 src/guide/migration/attribute-coercion.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 8ab5fc7be..83e686cbc 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -89,7 +89,7 @@ badges:
 
 为了保持原有的行为能正常工作，我们将强制把 `false` 转换为 `'false'`，在 3.x Vue 中，开发者需要将 `v-bind` 表达式解析为 `false` 或 `'false'`，以表示 `contenteditable` 和 `spellcheck`。
 
-在 2.x 中，枚举 attribute 的无效值被强制转换为 `'true'`。这通常是不符合预期的，且在大规模使用时不太可靠。在 3.x 中，应显式指定 `true` 或 `'true'`。
+在 2.x 中，枚举 attribute 的无效值将被强制转换为 `'true'`。这通常是不符合预期的，且在大规模使用时不太可靠。在 3.x 中，应显式指定 `true` 或 `'true'`。
 
 ### 将 `false` 强制转换为 `'false'` 而不是移除 attribute
 
@@ -111,7 +111,7 @@ badges:
       <td rowspan="3">2.x “枚举 attribute”<br><small>即 <code>contenteditable</code>, <code>draggable</code> 与 <code>spellcheck</code>。</small></td>
       <td><code>undefined</code>, <code>false</code></td>
       <td><code>undefined</code>, <code>null</code></td>
-      <td><i>removed</i></td>
+      <td><i>被移除</i></td>
     </tr>
     <tr>
       <td>
@@ -130,7 +130,7 @@ badges:
       <td rowspan="2">其他非布尔 attribute<br><small>如 <code>aria-checked</code>, <code>tabindex</code>, <code>alt</code>，等等。</small></td>
       <td><code>undefined</code>, <code>null</code>, <code>false</code></td>
       <td><code>undefined</code>, <code>null</code></td>
-      <td><i>removed</i></td>
+      <td><i>被移除</i></td>
     </tr>
     <tr>
       <td><code>'false'</code></td>

From 5f43774d4f3af348eb12aa75f02da0e649bb30c6 Mon Sep 17 00:00:00 2001
From: wxsm <wxsms@foxmail.com>
Date: Wed, 25 Aug 2021 13:29:50 +0800
Subject: [PATCH 5/8] Apply suggestions from code review

Co-authored-by: GU Yiling <justice360@gmail.com>
---
 src/guide/migration/attribute-coercion.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 83e686cbc..13277d2fc 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -26,7 +26,7 @@ badges:
 
 - 对于“[布尔 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L33-L40)”和 [xlinks](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L44-L46)，如果它们是 `falsy` ([`undefined`，`null` 或 `false`](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L52-L54)) 的，Vue 会移除它们，否则会加上。(见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L66-L77)和[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L81-L85))。
 
-- 对于“[枚举 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)” (目前来说：`contenteditable`，`draggable` 和 `spellcheck`)，Vue 会尝试将它们[强制](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31)转换为字符串 (目前对 `contenteditable` 做了特殊处理，以修复 [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397))。
+- 对于“[枚举 attribute](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)” (目前来说包括 `contenteditable`、`draggable` 和 `spellcheck`)，Vue 会尝试将它们[强制](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31)转换为字符串 (目前对 `contenteditable` 做了特殊处理，以修复 [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397))。
 
 -  对于其他 attribute，我们将移除 `falsy` 的值 (`undefined`，`null`，或 `false`)，其他值按原样设置 (见[这里](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113))。
 
@@ -45,14 +45,14 @@ badges:
 
 
 从上表可以看出，当前实现将 `true` 强制转换为了 `'true'`，但如果 attribute 为 `false`，则将其移除。这也导致了不一致性，并要求用户在非常常见的用例中手动将布尔值强制转换为字符串，例如
- `aria-*` attribute，例如 `aria-selected`，`aria-hidden`，等等。
+ `aria-*` attribute，例如 `aria-selected`、`aria-hidden` 等等。
 
 ## 3.x 语法
 
 我们打算放弃“枚举型 attribute”的内部概念，并将它们视为普通的非布尔型 HTML attribute。
 
 - 这就解决了普通非布尔型 attribute 和“枚举型 attribute”之间的不一致性问题
-- 它还可以使用 `'true'` 和 `'false'` 以外的值，甚至可以使用如 `contenteditable` 等 attribute 的关键字
+- 这个改动还使得对于诸如 `contenteditable` 这样的 attribute，我们可以使用 `'true'` 和 `'false'` 以外的值，甚至是未来新增的关键字。
 
 对于非布尔型 attribute，如果其值为 `false`，Vue 将不再移除它们，而是将其强制转换为 `'false'`。
 
@@ -79,17 +79,17 @@ badges:
 
 ### 枚举 attribute
 
-缺席的枚举 attribute 和 `attr="false"` 可能会产生不同的 IDL attribute 值 (将反映实际状态)，描述如下：
+枚举 attribute 如果不存在，可能会和 `attr="false"` 会产生不同的 IDL attribute 值 (将反映实际状态)，描述如下：
 
-| 缺席的枚举 attr           | IDL attr & 值                     |
+| 不存在的枚举 attr           | IDL attr & 值                     |
 | ---------------------- | ------------------------------------ |
 | `contenteditable`      | `contentEditable` &rarr; `'inherit'` |
 | `draggable`            | `draggable` &rarr; `false`           |
 | `spellcheck`           | `spellcheck` &rarr; `true`           |
 
-为了保持原有的行为能正常工作，我们将强制把 `false` 转换为 `'false'`，在 3.x Vue 中，开发者需要将 `v-bind` 表达式解析为 `false` 或 `'false'`，以表示 `contenteditable` 和 `spellcheck`。
+对于“枚举 attribute”，由于我们不再把 `null` 转换为 `'false'`，在 3.x 中，对于 `contenteditable` 和 `spellcheck`，开发者需要将原来解析为 `null` 的 `v-bind` 表达式变更为 `false` 或 `'false'` 才能保持行为和 2.x 中保持一致。
 
-在 2.x 中，枚举 attribute 的无效值将被强制转换为 `'true'`。这通常是不符合预期的，且在大规模使用时不太可靠。在 3.x 中，应显式指定 `true` 或 `'true'`。
+在 2.x 中，枚举 attribute 的无效值将被强制转换为 `'true'`。这通常是不符合预期的，所以该行为不太可能被大规模依赖。在 3.x 中，应显式指定 `true` 或 `'true'`。
 
 ### 将 `false` 强制转换为 `'false'` 而不是移除 attribute
 
@@ -108,7 +108,7 @@ badges:
   </thead>
   <tbody>
     <tr>
-      <td rowspan="3">2.x “枚举 attribute”<br><small>即 <code>contenteditable</code>, <code>draggable</code> 与 <code>spellcheck</code>。</small></td>
+      <td rowspan="3">2.x “枚举 attribute”<br><small>即 <code>contenteditable</code>、<code>draggable</code> 与 <code>spellcheck</code>。</small></td>
       <td><code>undefined</code>, <code>false</code></td>
       <td><code>undefined</code>, <code>null</code></td>
       <td><i>被移除</i></td>
@@ -127,7 +127,7 @@ badges:
       <td><code>"false"</code></td>
     </tr>
     <tr>
-      <td rowspan="2">其他非布尔 attribute<br><small>如 <code>aria-checked</code>, <code>tabindex</code>, <code>alt</code>，等等。</small></td>
+      <td rowspan="2">其他非布尔 attribute<br><small>如 <code>aria-checked</code>、<code>tabindex</code>、<code>alt</code> 等等。</small></td>
       <td><code>undefined</code>, <code>null</code>, <code>false</code></td>
       <td><code>undefined</code>, <code>null</code></td>
       <td><i>被移除</i></td>

From 7f741a0907c40daeded3b2716de677db1d4d1dca Mon Sep 17 00:00:00 2001
From: wxsm <wxsms@foxmail.com>
Date: Wed, 25 Aug 2021 13:32:24 +0800
Subject: [PATCH 6/8] Update src/guide/migration/attribute-coercion.md

---
 src/guide/migration/attribute-coercion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 13277d2fc..7216daaa1 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -87,7 +87,7 @@ badges:
 | `draggable`            | `draggable` &rarr; `false`           |
 | `spellcheck`           | `spellcheck` &rarr; `true`           |
 
-对于“枚举 attribute”，由于我们不再把 `null` 转换为 `'false'`，在 3.x 中，对于 `contenteditable` 和 `spellcheck`，开发者需要将原来解析为 `null` 的 `v-bind` 表达式变更为 `false` 或 `'false'` 才能保持行为和 2.x 中保持一致。
+对于“枚举 attribute”，由于我们不再把 `null` 转换为 `'false'`，在 3.x 中，对于 `contenteditable` 和 `spellcheck`，开发者需要将原来解析为 `null` 的 `v-bind` 表达式变更为 `false` 或 `'false'` 才能保持和 2.x 中的行为一致。
 
 在 2.x 中，枚举 attribute 的无效值将被强制转换为 `'true'`。这通常是不符合预期的，所以该行为不太可能被大规模依赖。在 3.x 中，应显式指定 `true` 或 `'true'`。
 

From 8146f2b74b51c01c3cefe3402ddb84a69b1ff6d3 Mon Sep 17 00:00:00 2001
From: wxsm <wxsms@foxmail.com>
Date: Wed, 25 Aug 2021 14:52:45 +0800
Subject: [PATCH 7/8] update attribute-coercion.md

---
 src/guide/migration/attribute-coercion.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 7216daaa1..96dd9e192 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -109,7 +109,7 @@ badges:
   <tbody>
     <tr>
       <td rowspan="3">2.x “枚举 attribute”<br><small>即 <code>contenteditable</code>、<code>draggable</code> 与 <code>spellcheck</code>。</small></td>
-      <td><code>undefined</code>, <code>false</code></td>
+      <td><code>undefined</code></td>
       <td><code>undefined</code>, <code>null</code></td>
       <td><i>被移除</i></td>
     </tr>
@@ -123,7 +123,7 @@ badges:
     </tr>
     <tr>
       <td><code>null</code>, <code>'false'</code></td>
-      <td><code>false</code>, <code>'false'</code></td>
+      <td><code>null</code>, <code>false</code>, <code>'false'</code></td>
       <td><code>"false"</code></td>
     </tr>
     <tr>

From 76c10a87cd8d3cfab97c2c0e33bae295370d6572 Mon Sep 17 00:00:00 2001
From: wxsm <wxsms@foxmail.com>
Date: Wed, 25 Aug 2021 14:55:53 +0800
Subject: [PATCH 8/8] update attribute-coercion.md

---
 src/guide/migration/attribute-coercion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 96dd9e192..19597a382 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -122,8 +122,8 @@ badges:
       <td><code>"true"</code></td>
     </tr>
     <tr>
-      <td><code>null</code>, <code>'false'</code></td>
       <td><code>null</code>, <code>false</code>, <code>'false'</code></td>
+      <td><code>false</code>, <code>'false'</code></td>
       <td><code>"false"</code></td>
     </tr>
     <tr>