diff --git a/src/v2/guide/forms.md b/src/v2/guide/forms.md index 2465e864eb..c2784eec33 100644 --- a/src/v2/guide/forms.md +++ b/src/v2/guide/forms.md @@ -10,6 +10,11 @@ You can use the `v-model` directive to create two-way data bindings on form inpu
`v-model` will ignore the initial `value`, `checked` or `selected` attributes found on any form elements. It will always treat the Vue instance data as the source of truth. You should declare the initial value on the JavaScript side, inside the `data` option of your component.
+`v-model` internally uses different properties and emits different events for different input elements: +- text and textarea elements use `value` property and `input` event; +- checkboxes and radiobuttons use `checked` property and `change` event; +- select fields use `value` as a prop and `change` as an event. +For languages that require an [IME](https://en.wikipedia.org/wiki/Input_method) (Chinese, Japanese, Korean etc.), you'll notice that `v-model` doesn't get updated during IME composition. If you want to cater for these updates as well, use `input` event instead.
### Text