Commit 79e14780 authored by Jiewei Qian's avatar Jiewei Qian Committed by Zhi Cun

Docs: warn input as a controlled component. (#14463)

Explicitly states that input events should be handled, and v-model modifiers
are not supported.
parent 57f39609
...@@ -148,6 +148,15 @@ ...@@ -148,6 +148,15 @@
Input data using mouse or keyboard. Input data using mouse or keyboard.
:::warning
Input is a controlled component, it **always shows Vue binding value**.
Under normal circumstances, `input` event should be handled. Its handler should update component's binding value (or use `v-model`). Otherwise, input box's value will not change.
Do not support `v-model` modifiers.
:::
### Basic usage ### Basic usage
:::demo :::demo
......
...@@ -148,6 +148,14 @@ ...@@ -148,6 +148,14 @@
Ingresa datos usando el ratón o teclado. Ingresa datos usando el ratón o teclado.
:::warning
Input is a controlled component, it **always shows Vue binding value**.
Under normal circumstances, `input` event should be handled. Its handler should update component's binding value (or use `v-model`). Otherwise, input box's value will not change.
Do not support `v-model` modifiers.
:::
### Uso básico ### Uso básico
:::demo :::demo
......
...@@ -148,6 +148,14 @@ ...@@ -148,6 +148,14 @@
Le champs d'input de base. Le champs d'input de base.
:::warning
Input is a controlled component, it **always shows Vue binding value**.
Under normal circumstances, `input` event should be handled. Its handler should update component's binding value (or use `v-model`). Otherwise, input box's value will not change.
Do not support `v-model` modifiers.
:::
### Usage ### Usage
:::demo :::demo
......
...@@ -185,6 +185,14 @@ ...@@ -185,6 +185,14 @@
通过鼠标或键盘输入字符 通过鼠标或键盘输入字符
:::warning
Input 为受控组件,它**总会显示 Vue 绑定值**
通常情况下,应当处理 `input` 事件,并更新组件的绑定值(或使用`v-model`)。否则,输入框内显示的值将不会改变。
不支持 `v-model` 修饰符。
:::
### 基础用法 ### 基础用法
:::demo :::demo
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment