From 3446976776a8382fcfc891ab1b1557f07016c5b8 Mon Sep 17 00:00:00 2001
From: Zhilu <hi@zhilu.cyou>
Date: Mon, 7 Apr 2025 09:53:25 +0800
Subject: [PATCH 1/2] docs(v-model): same-name shorthand usage

https://github.com/vuejs/core/pull/13156
---
 src/api/built-in-directives.md          | 21 +++++++++++++++++++++
 src/guide/essentials/template-syntax.md |  8 ++++++--
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/src/api/built-in-directives.md b/src/api/built-in-directives.md
index 8afb0bfc48..1a4629c773 100644
--- a/src/api/built-in-directives.md
+++ b/src/api/built-in-directives.md
@@ -358,12 +358,33 @@ Create a two-way binding on a form input element or a component.
   - `<textarea>`
   - components
 
+- **Shorthand:**
+  - Omitting value (when argument and bound variable have the same name, requires 3.6+)
+
 - **Modifiers**
 
   - [`.lazy`](/guide/essentials/forms#lazy) - listen to `change` events instead of `input`
   - [`.number`](/guide/essentials/forms#number) - cast valid input string to numbers
   - [`.trim`](/guide/essentials/forms#trim) - trim input
 
+- **Example**
+
+  ```vue-html
+  <!-- form elements -->
+  <input v-model="text" />
+  <select v-model="option" />
+  <textarea v-model="message" />
+
+  <!-- component bindings -->
+  <MyComponent v-model="value" />
+  <MyComponent v-model:checked="checked" />
+
+  <!-- same-name shorthand (3.6+) -->
+  <MyComponent v-model:checked />
+  ```
+
+  The shorthand only works when the bound variable has the same name as the argument. It cannot be used without an argument or when no binding expression is provided (e.g., `<input v-model>` will still result in an error).
+
 - **See also**
 
   - [Form Input Bindings](/guide/essentials/forms)
diff --git a/src/guide/essentials/template-syntax.md b/src/guide/essentials/template-syntax.md
index 56a7c7b5f1..a50c376913 100644
--- a/src/guide/essentials/template-syntax.md
+++ b/src/guide/essentials/template-syntax.md
@@ -66,7 +66,8 @@ Attributes that start with `:` may look a bit different from normal HTML, but it
 
 ### Same-name Shorthand {#same-name-shorthand}
 
-- Only supported in 3.4+
+- `v-bind`: Supported since 3.4
+- `v-model`: Supported since 3.6
 
 If the attribute has the same name with the JavaScript value being bound, the syntax can be further shortened to omit the attribute value:
 
@@ -76,9 +77,12 @@ If the attribute has the same name with the JavaScript value being bound, the sy
 
 <!-- this also works -->
 <div v-bind:id></div>
+
+<!-- same as v-model:foo="foo" -->
+<input v-model:foo>
 ```
 
-This is similar to the property shorthand syntax when declaring objects in JavaScript. Note this is a feature that is only available in Vue 3.4 and above.
+This works similarly to JavaScript’s object property shorthand and helps keep templates concise. Note `v-model` without an argument or bound expression (e.g., `<input v-model>`) is still invalid.
 
 ### Boolean Attributes {#boolean-attributes}
 

From 5f80a7a5fec32c8d028c18e345b5ac9fbe3f8764 Mon Sep 17 00:00:00 2001
From: Zhilu <hi@zhilu.cyou>
Date: Sat, 19 Apr 2025 13:07:40 +0800
Subject: [PATCH 2/2] docs(v-model): remove note from `template-syntax.md`

---
 src/guide/essentials/template-syntax.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/essentials/template-syntax.md b/src/guide/essentials/template-syntax.md
index a50c376913..ee8ffa5697 100644
--- a/src/guide/essentials/template-syntax.md
+++ b/src/guide/essentials/template-syntax.md
@@ -82,7 +82,7 @@ If the attribute has the same name with the JavaScript value being bound, the sy
 <input v-model:foo>
 ```
 
-This works similarly to JavaScript’s object property shorthand and helps keep templates concise. Note `v-model` without an argument or bound expression (e.g., `<input v-model>`) is still invalid.
+This works similarly to JavaScript’s object property shorthand and helps keep templates concise.
 
 ### Boolean Attributes {#boolean-attributes}