-
Notifications
You must be signed in to change notification settings - Fork 4
/
587.txt
82 lines (66 loc) · 3.48 KB
/
587.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
[8] [[イベント]]の[DFN[[RUBYB[発火]@en[fire]]]]とは、初期化して[[ディスパッチ]]することをいいます。
* 仕様書
[REFS[
- [2] [CITE@en-US[DOM Standard]] ([TIME[2013-04-26 20:00:45 +09:00]] 版) <https://dom.spec.whatwg.org/#firing-events>
- [4] [CITE@en-US-x-hixie[HTML Standard]] ([TIME[2013-05-05 06:42:10 +09:00]] 版) <https://www.whatwg.org/specs/web-apps/current-work/#event-firing>
]REFS]
* 意味
[11] [DFN[[RUBYB[イベントを発火]@en[fire an event]]]]するとは、
[[名前][イベント型]] [VAR[e]]、
[[対象][イベント対象]][VAR[対象]]、
[VAR[イベント構築子]] (既定値 [CODE(DOMi)@en[Event]])、
[VAR[[[IDL属性]]の初期化]]、
[VAR[遺物[[対象上書き]]フラグ]]について、
次のようにします [SRC[>>2]]。
[FIG(steps)[
= [12] [VAR[イベント]]を、[VAR[イベント構築子]]の初期値を[[引数]] [VAR[e]]
で実行した結果に設定します。
= [13] [VAR[イベント]]の [CODE[isTrusted]] を、 [[真]]に設定します。
= [14] [VAR[イベント]]について[VAR[IDL属性の初期化]]を実行します。
= [15] [VAR[対象]]において[VAR[イベント]]を[VAR[遺物[[対象上書き]]フラグ]]について
[[dispatch]] した結果を返します。
]FIG]
;; [16] [CODE(DOMa)@en[isTrusted]] は [VAR[IDL属性の初期化]]で[[偽]]に設定されることもあります
[SRC[>>2]]。
[HISTORY[
[5]
[DFN[[RUBYB[[VAR@en[e]] という名前のイベントを発火]@en[fire an event named [VAR[e]]]]]] [SRC[>>2]]
または
[DFN[[RUBYB[[VAR@en[e]] という名前の単純イベントを発火]@en[fire a simple event named [VAR[e]]]]]] [SRC[>>4]]
するとは、[[イベント]]を
[FIG(list members)[
[FIGCAPTION[
[[イベント]]
]FIGCAPTION]
:[[インターフェイス]]:[CODE(DOMi)@en[[[Event]]]]
:[CODE(DOMa)@en[[[type]]]]:[VAR@en[e]]
:[CODE(DOMa)@en[[[isTrusted]]]]:[[真]]
:[[対象]]:指定されたオブジェクト
]FIG]
... と初期化し[[ディスパッチ]]することをいいます。 [SRC[>>2]]
]HISTORY]
[9] [[ディスパッチ]]の結果 ([[取り消し]]されたか否か) が呼び出し元で参照されることもあります。
[6] 「[[発火]]」は他にも[[イベント]]の形式ごとに定義されています。
[FIG(list)[
- [[fire a synthetic mouse event]]
- [[fire a [CODE(DOMe)@en[click]] event]]
- [[fire a focus event]]
]FIG]
* 歴史
[3] [[DOM3]] までは[[発火]]と[[ディスパッチ]]は同義とされていましたが、 [[DOM Standard]]
以降区別されています。
[REFS[
- [1] [CITE@en[Web Applications 1.0 r6188 Update 'fire' and 'dispatch' terminology.]]
( ([TIME[2011-06-04 09:46:00 +09:00]] 版))
<http://html5.org/tools/web-apps-tracker?from=6187&to=6188>
]REFS]
[7] [[Page Visibility]] は「fire a simple event」を定義・引用なしで使っています。
[10] [CITE@en[Redesign fire an event and target override]]
([[annevk]]著, [TIME[2016-10-15 00:32:41 +09:00]])
<https://github.com/whatwg/dom/commit/e19d7eef74fb83792415a4a78ed866d28f4cc543>
[17] [CITE@en[Editorial: major cleanup around firing and dispatching events]]
([[annevk]]著, [TIME[2016-10-19 01:00:43 +09:00]])
<https://github.com/whatwg/html/commit/8ffbd146d4709057e45dd6cfc81e7a70897050c5>
[18] [CITE@en[Editorial: "fire a simple event" is now "fire an event"]]
([[sendilkumarn]]著, [TIME[2016-10-21 16:36:33 +09:00]])
<https://github.com/whatwg/html/commit/3d19b31e62debaa6132744a530d3d7e33e0bc269>