事件處理 監聽事件 我們可以使用 v-on 指令 (簡寫為 @) 來監聽 DOM 事件,並在事件觸發時執行對應的 JavaScript。用法:v-on:click="handler" 或 @click="handler"。
事件處理器 (handler) 的值可以是:
內聯事件處理器:事件被觸發時執行的內聯 JavaScript 語句 (與 onclick 類似)。
方法事件處理器:一個指向組件上定義的方法的屬性名或是路徑。
內聯事件處理器 內聯事件處理器通常用於簡單場景,例如:
jsconst count = ref(0)jsdata() {
return {
count: 0
}
}template
Count is: {{ count }}
在演練場中嘗試一下在演練場中嘗試一下
方法事件處理器 隨著事件處理器的邏輯變得愈發複雜,內聯代碼方式變得不夠靈活。因此 v-on 也可以接受一個方法名或對某個方法的調用。
舉例來說:
jsconst name = ref('Vue.js')
function greet(event) {
alert(`Hello ${name.value}!`)
// `event` 是 DOM 原生事件
if (event) {
alert(event.target.tagName)
}
}jsdata() {
return {
name: 'Vue.js'
}
},
methods: {
greet(event) {
// 方法中的 `this` 指向當前活躍的組件實例
alert(`Hello ${this.name}!`)
// `event` 是 DOM 原生事件
if (event) {
alert(event.target.tagName)
}
}
}template
在演練場中嘗試一下
在演練場中嘗試一下
方法事件處理器會自動接收原生 DOM 事件並觸發執行。在上面的例子中,我們能夠通過被觸發事件的 event.target 訪問到該 DOM 元素。
你也可以看看為事件處理器標註類型這一章了解更多。
你也可以看看為事件處理器標註類型這一章了解更多。
方法與內聯事件判斷 模板編譯器會通過檢查 v-on 的值是否是合法的 JavaScript 標識符或屬性訪問路徑來斷定是何種形式的事件處理器。舉例來說,foo、foo.bar 和 foo['bar'] 會被視為方法事件處理器,而 foo() 和 count++ 會被視為內聯事件處理器。
在內聯處理器中調用方法 除了直接綁定方法名,你還可以在內聯事件處理器中調用方法。這允許我們向方法傳入自定義參數以代替原生事件:
jsfunction say(message) {
alert(message)
}jsmethods: {
say(message) {
alert(message)
}
}template
在演練場中嘗試一下
在演練場中嘗試一下
在內聯事件處理器中訪問事件參數 有時我們需要在內聯事件處理器中訪問原生 DOM 事件。你可以向該處理器方法傳入一個特殊的 $event 變量,或者使用內聯箭頭函數:
template
Submit
Submit
jsfunction warn(message, event) {
// 這裡可以訪問原生事件
if (event) {
event.preventDefault()
}
alert(message)
}jsmethods: {
warn(message, event) {
// 這裡可以訪問 DOM 原生事件
if (event) {
event.preventDefault()
}
alert(message)
}
}事件修飾符 在處理事件時調用 event.preventDefault() 或 event.stopPropagation() 是很常見的。儘管我們可以直接在方法內調用,但如果方法能更專注於數據邏輯而不用去處理 DOM 事件的細節會更好。
為解決這一問題,Vue 為 v-on 提供了事件修飾符。修飾符是用 . 表示的指令後綴,包含以下這些:
.stop.prevent.self.capture.once.passivetemplate
使用修飾符時需要注意調用順序,因為相關代碼是以相同的順序生成的。因此使用 @click.prevent.self 會阻止元素及其子元素的所有點擊事件的默認行為,而 @click.self.prevent 則只會阻止對元素本身的點擊事件的默認行為。
.capture、.once 和 .passive 修飾符與原生 addEventListener 事件相對應:
template
TIP
請勿同時使用 .passive 和 .prevent,因為 .passive 已經向瀏覽器表明了你不想阻止事件的默認行為。如果你這麼做了,則 .prevent 會被忽略,並且瀏覽器會拋出警告。
按鍵修飾符 在監聽鍵盤事件時,我們經常需要檢查特定的按鍵。Vue 允許在 v-on 或 @ 監聽按鍵事件時添加按鍵修飾符。
template
你可以直接使用 KeyboardEvent.key 暴露的按鍵名稱作為修飾符,但需要轉為 kebab-case 形式。
template在上面的例子中,僅會在 $event.key 為 'PageDown' 時調用事件處理。
按鍵別名 Vue 為一些常用的按鍵提供了別名:
.enter.tab.delete (捕獲“Delete”和“Backspace”兩個按鍵).esc.space.up.down.left.right系統按鍵修飾符 你可以使用以下系統按鍵修飾符來觸發鼠標或鍵盤事件監聽器,只有當按鍵被按下時才會觸發。
.ctrl.alt.shift.meta注意
在 Mac 鍵盤上,meta 是 Command 鍵 (⌘)。在 Windows 鍵盤上,meta 鍵是 Windows 鍵 (⊞)。在 Sun 微機系統鍵盤上,meta 是鑽石鍵 (◆)。在某些鍵盤上,特別是 MIT 和 Lisp 機器的鍵盤及其後代版本的鍵盤,如 Knight 鍵盤,space-cadet 鍵盤,meta 都被標記為“META”。在 Symbolics 鍵盤上,meta 也被標識為“META”或“Meta”。
舉例來說:
template
請注意,系統按鍵修飾符和常規按鍵不同。與 keyup 事件一起使用時,該按鍵必須在事件發出時處於按下狀態。換句話說,keyup.ctrl 只會在你仍然按住 ctrl 但鬆開了另一個鍵時被觸發。若你單獨鬆開 ctrl 鍵將不會觸發。
.exact 修飾符 .exact 修飾符允許精確控制觸發事件所需要的系統修飾符的組合。
template
鼠標按鍵修飾符 .left.right.middle這些修飾符將處理程序限定為由特定鼠標按鍵觸發的事件。