v-model 是 vue.js 提供的語法糖,根據不同的表單控制項監聽不同的事件,實現對錶單控制項的數據雙向綁定。 當控制項是 <input> 輸入框時,v-model 監聽其 input 事件。 如下所示,這兩種寫法有什麼區別嗎? 輸入中文格式化問題 表單輸入常見需求:對<input>控制項輸入的內容進 ...
v-model 是 vue.js 提供的語法糖,根據不同的表單控制項監聽不同的事件,實現對錶單控制項的數據雙向綁定。
當控制項是 <input> 輸入框時,v-model 監聽其 input 事件。
如下所示,這兩種寫法有什麼區別嗎?
<input :value="name" @input="name = $event.target.value"> <input v-model="name">
輸入中文格式化問題
表單輸入常見需求:對<input>控制項輸入的內容進行格式化,譬如:轉成大寫字母。如果輸入的值包含中文,格式化就會引起輸入法異常。
如下圖所示,也可以線上嘗試:
如果使用 v-model 指令實現數據雙向綁定,就不會出現輸入法異常,如下圖所示,也可以線上嘗試:
上面的問題,可以看出 v-model 不只是給變數賦值,那麼,它還做了些什麼呢?
v-model 源碼分析
本文參考的 vue.js 源代碼是 2.5.16
翻看 v-model 源碼,可以看到 v-model 關註的仍然是 input 事件:
input 事件綁定的回調代碼處理,如下:
這裡可以看到,v-model 判斷了 composing 屬性,當輸入法組合沒有結束的時候,直接返回,並沒有賦值。
composing 屬性並不是標準 dom 元素屬性,那它是怎麼來的呢?
這裡可以看出,composing 屬性是 vue.js 添加到 dom 節點上的。
那麼,是什麼地方調用了這2個函數呢?可以看到,在插入dom節點時,vue.js 監聽了 compositionstart / compositionend 事件:
compositionstart / compositionend 這2個 dom 事件,瀏覽器相容性問題可以查閱 MDN 說明:
源代碼中還發現,在是否刷新 dom 屬性值時,也用到了 composing 屬性:
這裡可以看出,在輸入法組合過程中,vue.js 變數值的更新亦不會同步到 dom元素的 value 屬性。
綜上所述:
- v-model 實際上是監聽了 <input> 控制項的 input、compositionstart、compositionend 三個事件,在輸入法組合過程中就直接返回不賦值
- v-model 指令設置了變數 composing,此標識還用於判斷是否更新 dom元素的 value 屬性
v-model 輸入中文觸發的事件
從上面源代碼分析可知,v-model 綁定 <input> 輸入中文時,實際觸發的事件如下:
compositionstart => 3個 input => compositionend 事件,這些都是 <input>控制項觸發的。最後一個 input 事件,是源代碼裡面看到的 onCompositionEnd 回調裡面 vue.js 觸發的。
1、compositionstart事件
修改dom對象的composing屬性為 true
2、3個input事件
由於dom對象的composing屬性為true,不會賦值,直接返回。
3、compositioinend事件
修改dom對象的composing屬性為 false
4、vue.js觸發的 input事件
由於dom對象的composing屬性為false,賦值,修改相應變數的值。
格式化問題原因分析
再次看下文章開頭的示例,如果使用 v-model 指令實現數據雙向綁定,就不會出現輸入法異常,如下圖所示,也可以線上嘗試:
由前面的分析可知:
- v-model 指令設置了變數 composing,雖然代碼在 format 函數里更改了 this.name 的值,但此時 composing 標識阻止了將 this.name 的值同步給 input 元素的 value 屬性
- 如果你感興趣的話,可以修改 vue.js 的源代碼,將 shouldUpdateValue 函數里對 composing 屬性的判斷去掉,可以看到輸入法又跟之前一樣異常了
格式化問題 bugfix
再次看下文章開頭的示例,如果使用 :value, @input 實現數據雙向綁定,有兩個方案可以解決中文輸入異常的問題。
方案一:監聽 change 事件
等輸入結束失去焦點以後,再調用格式化方法,如下所示,也可以線上嘗試:
方案二:監聽 input 事件,同時判斷輸入法組合過程
在輸入法組合過程中,不進行格式化,如下所示,也可以線上嘗試: