Skip to content

Commit e3e8252

Browse files
re-fortkazupon
authored andcommitted
Tweak wording of .passive modifier explanation (#670)
* Tweak wording of `.passive` modifier explanation * Update date
1 parent 4610a2b commit e3e8252

File tree

1 file changed

+8
-4
lines changed

1 file changed

+8
-4
lines changed

src/v2/guide/events.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: イベントハンドリング
3-
updated: 2018-01-10
3+
updated: 2018-01-30
44
type: guide
55
order: 9
66
---
@@ -208,14 +208,18 @@ methods: {
208208

209209
> 2.3.0 で新規追加
210210
211+
Vue は [`addEventListener``passive` オプション](https://developer.mozilla.org/ja/docs/Web/API/EventTarget/addEventListener#Parameters)に対応する `.passive` 修飾子も提供しています。
212+
211213
``` html
212-
<!-- スクロールイベントはデフォルトのスクロールの挙動をキャンセルしません -->
214+
<!-- スクロールイベントのデフォルトの挙動(スクロール)は -->
215+
<!-- `onScroll` が `event.preventDefault()` を含んでいる場合、 -->
216+
<!-- イベントの完了を待たずに即座に起きるでしょう。 -->
213217
<div v-on:scroll.passive="onScroll">...</div>
214218
```
215219

216-
これらの修飾子に加え、Vue は特にモバイルでのパフォーマンスを改善するために `.passive` 修飾子を提供しています。例えば、スクロールを行う際、ブラウザは処理が完了した後にスクロールを行います。なぜなら、ブラウザはそのイベントがハンドラ内で `event.preventDefault()` を呼び出すかどうか分からないからです。`.passive` 修飾子はこのイベントがデフォルトのイベントの挙動をキャンセルしないことを前もってブラウザに伝えるために使われます
220+
`.passive` 修飾子は特にモバイルでのパフォーマンスを改善するのに有用です
217221

218-
<p class="tip">`.passive` と `.prevent` を一緒に使わないでください。Passive ハンドラはデフォルトのイベントを中止できません。</p>
222+
<p class="tip">`.passive` と `.prevent` を一緒に使わないでください。`.prevent` は無視され、ブラウザにはおそらく警告が表示されます。`.passive` はイベントのデフォルトの挙動を妨げ_ない_ことをブラウザに伝達することを思い出してください。</p>
219223

220224
## キー修飾子
221225

0 commit comments

Comments
 (0)