Skip to content

Commit 185ea82

Browse files
[event-timing] 各種更新
Cleanup typos and references (before larger spec change). w3c/event-timing@f224aec Add one more small fix that makes lychee unhappy w3c/event-timing@f21c115 Fix broken links for Event types. w3c/event-timing@af8a610 (和訳には織り込み済み) +編集(削除漏れ( "If event’s type attribute value is not keydown nor pointerdown..."
1 parent dcfae8f commit 185ea82

1 file changed

Lines changed: 40 additions & 52 deletions

File tree

event-timing-ja.html

Lines changed: 40 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -109,17 +109,17 @@
109109
●●options
110110

111111
spec_title:Event Timing API
112-
spec_date:2025-05-26
113-
trans_update:2025-06-03
114-
source_checked:
112+
spec_date:2026-02-24
113+
trans_update:2026-02-25
114+
source_checked:260224
115115
page_state_key:TIMING
116116
original_url:https://w3c.github.io/event-timing/
117117
abbr_url:EVENT-TIMING
118118
spec_status:ED
119119
ref_id_prefix:bib-
120120
ref_id_lowercase:true
121121
conformance:w3c
122-
copyright:2025,permissive
122+
copyright:2026,permissive
123123
trans_1st_pub:
124124

125125

@@ -429,6 +429,7 @@
429429
%開始:start
430430
%~event:event
431431
%~window:window
432+
%~window:relevantGlobal
432433
%ヤリトリ~ID:interactionId
433434
ヤリトリ~ID:interactiond IDs
434435
ヤリトリ~ID:interactionId
@@ -453,7 +454,6 @@
453454
%処理~開始:processingStart
454455
%~target:target
455456
%処理~終了:~processingEnd
456-
%関連な大域~obj:relevantGlobal
457457
%文書:doc
458458
%描画~時刻印:renderingTimestamp
459459
%名前:name
@@ -578,16 +578,14 @@
578578
Ian Clelland; Noam Rosenthal. <Paint Timing>. URL: https://w3c.github.io/paint-timing/
579579
[PERFORMANCE-TIMELINE-2]
580580
Nicolas Pena Moreno. <Performance Timeline>. URL: https://w3c.github.io/performance-timeline/
581-
[POINTEREVENTS]
582-
Jacob Rossi; Matt Brubeck. <Pointer Events>. URL: https://dvcs.w3.org/hg/pointerevents/raw-file/tip/pointerEvents.html
583-
[POINTEREVENTS3]
581+
[POINTEREVENTS4]
584582
Patrick Lauke; Robert Flack. <Pointer Events>. URL: https://w3c.github.io/pointerevents/
585583
[RFC2119]
586584
S. Bradner. <Key words for use in RFCs to Indicate Requirement Levels>. March 1997. Best Current Practice. URL: https://datatracker.ietf.org/doc/html/rfc2119
587585
[TOUCH-EVENTS]
588586
Doug Schepers; et al. <Touch Events>. URL: https://w3c.github.io/touch-events/
589587
[UIEVENTS]
590-
Gary Kacmarcik; Travis Leithead. <UI Events>. URL: https://w3c.github.io/uievents/
588+
Xiaoqian Wu. <UI Events>. URL: https://w3c.github.io/uievents/
591589
[WEBIDL]
592590
Edgar Chen; Timothy Gu. <Web IDL Standard>. Living Standard. URL: https://webidl.spec.whatwg.org/
593591

@@ -747,14 +745,13 @@ <h3 title="Overview">1.1. 概観</h3>
747745
</p>
748746
<ul>
749747
<li>
750-
~event~listenerは,[
751-
~page読込nにおける ごく早期においては、
752-
まだ登録されない見込みが高い
753-
]ので
748+
~event~listenerは,
749+
~page読込nにおける ごく早期においては登録されていないかもしれないので
754750
【~targetになる要素が~instance化されるまで待機する必要がある】、
755-
~event~listenerを要求することは,そのような時点で~event待時間を測定することを予め除外する。
751+
~event~listenerを要求することは,
752+
~event待時間を測定することを予め除外する。
756753
757-
First, requiring event listeners precludes measuring event latency very early in the page load because listeners will likely not be registered yet at that point in time.\
754+
First, requiring event listeners precludes measuring event latency very early in the page load because listeners might not be registered yet.\
758755
</li>
759756
<li>
760757
開発者は、
@@ -763,7 +760,7 @@ <h3 title="Overview">1.1. 概観</h3>
763760
その結果、
764761
~event待時間の計算に不必要な処理能~overheadが加算される。
765762
766-
Second, developers that are only interested in the input delay might be forced to add new listeners to events that originally did not have one. This adds unnecessary performance overhead to the event latency calculation.\
763+
Second, developers who are only interested in input delay might be forced to add new listeners to events that originally did not have them. This adds unnecessary performance overhead to the event latency calculation.\
767764
</li>
768765
<li>
769766
この~approachを介して[
@@ -1125,7 +1122,7 @@ <h3 title="When events are measured">1.5. ~eventは いつ測定されるか</h3
11251122
この値は、
11261123
粒度 8ms で供される。
11271124
1128-
The Event Timing API exposes a duration value, which is meant to be the time from when the physical user input occurs (estimated via the Event’s timeStamp) to the next time the rendering of the Event’s relevant global object’s associated Document’s is updated. This value is provided with 8 millisecond granularity.
1125+
The Event Timing API exposes a duration value, which is meant to be the time from when the physical user input occurs (estimated via the Event’s timeStamp) to the next time the rendering of the Event’s relevant global object’s associated Document is updated. This value is provided with 8 millisecond granularity.
11291126
</p>
11301127

11311128
<p>
@@ -1514,7 +1511,7 @@ <h3 title="PerformanceEventTiming interface">2.1. `PerformanceEventTiming^I ~int
15141511
この属性は、
15151512
`結付けられた~event$が ~OR↓ を満たさない場合には 0 になる:
15161513
1517-
The interactionId attribute’s getter returns the ID that uniquely identifies the user interaction which triggered the associated event. This attribute is 0 unless the associated event’s type attribute value is one of:
1514+
The interactionId attribute’s getter returns a number that uniquely identifies the user Interaction which triggered the associated event. This attribute is 0 unless the associated event’s type attribute value is one of:
15181515
</p>
15191516
<ul>
15201517
<li>
@@ -1532,7 +1529,7 @@ <h3 title="PerformanceEventTiming interface">2.1. `PerformanceEventTiming^I ~int
15321529
~scrollの終了における `pointerdown$et 【?】は除外されることに注意。
15331530
</p>
15341531
1535-
A pointerdown, pointerup, or click belonging to a user tap or drag. Note that pointerdown that ends in scroll is excluded.
1532+
A pointerdown, pointerup, or click, and belongs to a tap or drag gesture. Note that pointerdown that ends in scroll is excluded.
15361533
</li>
15371534
<li>
15381535
@@ -1541,7 +1538,7 @@ <h3 title="PerformanceEventTiming interface">2.1. `PerformanceEventTiming^I ~int
15411538
利用者-~UIkeyの押下げから生じた
15421539
15431540
1544-
A keydown or keyup belonging to a user key press.
1541+
A keydown or keyup, belongs to a user key press.
15451542
</li>
15461543
</ul>
15471544
</dd>
@@ -1723,7 +1720,7 @@ <h3 title="Modifications to the HTML specification">3.2. ~HTML仕様に対する
17231720
当の~page内で生じたヤリトリの回数
17241721
]用の真実を成す~sourceとして利用しなくなると見込まれる。
17251722
1726-
Note: the user interaction value is set to a random integer instead of 0 so that developers do not rely on it to count the number of interactions in the page. By starting at a random value, developers are less likely to use it as the source of truth for the number of interactions that have occurred in the page.
1723+
Note: The user interaction value is set to a random integer instead of 0 so that developers do not rely on it to count the number of interactions in the page. By starting at a random value, developers are less likely to use it as the source of truth for the number of interactions that have occurred in the page.
17271724
</p>
17281725
</li>
17291726
<li>
@@ -1927,7 +1924,7 @@ <h3 title="Should add PerformanceEventTiming">3.4. `PerformanceEventTiming^I を
19271924
ε ならば 104 /
19281925
~ELSE_ `max^op( 16, %最小~所要時間 )
19291926
1930-
If options is not present or if options’s durationThreshold is not present,let minDuration be 104.
1927+
If options is not present or if options’s durationThreshold is not present, let minDuration be 104.
19311928
19321929
Otherwise, let minDuration be the maximum between 16 and options’s durationThreshold value.
19331930
</li>
@@ -2208,7 +2205,7 @@ <h3 title="Computing interactionId">3.6. ヤリトリ~IDを算出する</h3>
22082205
改変された~text内容についてではない
22092206
]ものを除外するために行われる。
22102207
2211-
Note: this check is done to exclude Events for which the type is input but that are not about modified text content.
2208+
Note: This check is done to exclude Events for which the type is input but that are not about modified text content.
22122209
</p>
22132210
</li>
22142211
<li>
@@ -2416,7 +2413,7 @@ <h3 title="Computing interactionId">3.6. ヤリトリ~IDを算出する</h3>
24162413
この~algoは、
24172414
各~eventに対応するヤリトリ~ID( `interactionId$mET )をアテガうよう試みる:
24182415
2419-
Note: the algorithm attempts to assign events to the corresponding interactiond IDs.\
2416+
Note: The algorithm attempts to assign events to the corresponding interaction IDs.\
24202417
</p>
24212418
<ul>
24222419
<li>
@@ -2546,16 +2543,16 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
25462543
25472544
~RET
25482545
2549-
If timingEntry is null, return.
2546+
If timingEntry is null, then return.
25502547
</li>
25512548
<li>
2552-
%関連な大域~obj ~LET %~target に`関連な大域~obj$
2549+
%~window【!relevantGlobal】 ~LET %~target に`関連な大域~obj$
25532550
25542551
Let relevantGlobal be target’s relevant global object.
25552552
</li>
25562553
<li>
25572554
~IF[
2558-
%関連な大域~obj は `Window$I を`実装-$しない
2555+
%~window は `Window$I を`実装-$しない
25592556
25602557
25612558
~RET
@@ -2579,14 +2576,14 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
25792576
この表明は、
25802577
この~APIが~supportする~event型たちに因り,満たされる。
25812578
2582-
Note: this assertion holds due to the types of events supported by the Event Timing API.
2579+
Note: This assertion holds due to the types of events supported by the Event Timing API.
25832580
</p>
25842581
</li>
25852582
<li>
25862583
<p>
25872584
%計時~entry に`結付けられた~event~target$ ~SET %~target
25882585
2589-
Set timingEntry’s associated eventTarget to target.
2586+
Set timingEntry’s eventTarget to target.
25902587
</p>
25912588

25922589
<p class="note">注記:
@@ -2605,15 +2602,6 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
26052602
%計時~entry の `targetSelector$mET ~SET `~CSS選択子を生成する$( %~target )
26062603
26072604
Set timingEntry’s targetSelector to the result of running the algorithm to generate a CSS selector with target as input.
2608-
</li>
2609-
<li>
2610-
~IF[
2611-
%~event の `type$m 属性の値 ~NIN { `keydown$et, `pointerdown$et }
2612-
2613-
2614-
%関連な大域~obj の`~queueされることになる~entry群$wに %計時~entry を`付加する$
2615-
2616-
If event’s type attribute value is not keydown nor pointerdown, append timingEntry to relevantGlobal’s entries to be queued.
26172605
</li>
26182606
<li>
26192607
<p>
@@ -2625,7 +2613,7 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
26252613
</p>
26262614
<ol>
26272615
<li>
2628-
%処理待ちな~pointerdown~map ~LET %関連な大域~obj の`処理待ちな~pointerdown~map$w
2616+
%処理待ちな~pointerdown~map ~LET %~window の`処理待ちな~pointerdown~map$w
26292617
26302618
Let pendingPointerDowns be relevantGlobal’s pending pointer downs.
26312619
</li>
@@ -2643,7 +2631,7 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
26432631
%前回の~pointerdown~entry ~NEQ ε
26442632
26452633
2646-
%関連な大域~obj の`~queueされることになる~entry群$wに %前回の~pointerdown~entry を`付加する$【!add】
2634+
%~window の`~queueされることになる~entry群$wに %前回の~pointerdown~entry を`付加する$【!add】
26472635
26482636
If pendingPointerDowns[pointerId] exists:
26492637
• Let previousPointerDownEntry be pendingPointerDowns[pointerId].
@@ -2657,7 +2645,7 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
26572645
<li>
26582646
%~window の`~contextmenuを誘発したか$w ~SET ~F
26592647
2660-
Set window’s is contextmenu triggered to false.
2648+
Set relevantGlobal’s is contextmenu triggered to false.
26612649
</li>
26622650
</ol>
26632651
</li>
@@ -2680,7 +2668,7 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
26802668
</p>
26812669
<ol>
26822670
<li>
2683-
%関連な大域~obj の`~queueされることになる~entry群$wに %計時~entry を`付加する$
2671+
%~window の`~queueされることになる~entry群$wに %計時~entry を`付加する$
26842672
26852673
Append timingEntry to relevantGlobal’s entries to be queued.
26862674
</li>
@@ -2692,7 +2680,7 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
26922680
</ol>
26932681
</li>
26942682
<li>
2695-
%処理待ちな~keydown~map ~LET %関連な大域~obj の`処理待ちな~keydown~map$w
2683+
%処理待ちな~keydown~map ~LET %~window の`処理待ちな~keydown~map$w
26962684
26972685
Let pendingKeyDowns be relevantGlobal’s pending key downs.
26982686
</li>
@@ -2727,12 +2715,12 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
27272715
<li>
27282716
%~window の`利用者ヤリトリ値$w 値 ~INCBY ~UAにより選ばれる小さな無符号整数
27292717
2730-
Increase window’s user interaction value value by a small number chosen by the user agent.
2718+
Increase relevantGlobal’s user interaction value value by a small number chosen by the user agent.
27312719
</li>
27322720
<li>
27332721
%前回の~keydown~entry の `interactionId$mET ~SET %~window の`利用者ヤリトリ値$w
27342722
2735-
Set previousKeyDownEntry’s interactionId to window’s user interaction value.
2723+
Set previousKeyDownEntry’s interactionId to relevantGlobal’s user interaction value.
27362724
</li>
27372725
</ol>
27382726

@@ -2748,7 +2736,7 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
27482736
<li>
27492737
%~window の`~queueされることになる~entry群$wに %前回の~keydown~entry を`付加する$【!add】
27502738
2751-
Add previousKeyDownEntry to window’s entries to be queued.
2739+
Add previousKeyDownEntry to relevantGlobal’s entries to be queued.
27522740
</li>
27532741
</ol>
27542742
</li>
@@ -2762,7 +2750,7 @@ <h3 title="Finalize event timing">3.8. ~event計時を完結する</h3>
27622750
<li>
27632751
~ELSE
27642752
2765-
%関連な大域~obj の`~queueされることになる~entry群$w に %計時~entry を`付加する$
2753+
%~window の`~queueされることになる~entry群$w に %計時~entry を`付加する$
27662754
27672755
Otherwise:
27682756
• Append timingEntry to relevantGlobal’s entries to be queued.
@@ -2821,9 +2809,9 @@ <h3 title="Dispatch pending Event Timing entries">3.9. 処理待ちな各~event
28212809
</ol>
28222810
</li>
28232811
<li>
2824-
%~window の`~queueされることになる~entry群$wを`空にする$【!clear
2812+
%~window の`~queueされることになる~entry群$wを`空にする$【! SET « »
28252813
2826-
Clear window’s entries to be queued.
2814+
Set window’s entries to be queued to an empty list.
28272815
</li>
28282816
<li>
28292817
%~window の`処理待ちな~pointerdown~map$wの`値~群$mapを成す
@@ -2833,7 +2821,7 @@ <h3 title="Dispatch pending Event Timing entries">3.9. 処理待ちな各~event
28332821
`~event計時~entryの所要時間を設定する$( %処理待ち~pointerdown~entry, %~window, %描画~時刻印 )
28342822
28352823
For each pendingPointerDownEntry in the values from window’s pending pointer downs:
2836-
• Set event timing entry duration passing pendingDown, window, and renderingTimestamp.
2824+
• Set event timing entry duration passing pendingPointerDownEntry, window, and renderingTimestamp.
28372825
</li>
28382826
<li>
28392827
%~window の`処理待ちな~keydown~map$wの`値~群$mapを成す
@@ -3043,7 +3031,7 @@ <h2 title="Security &amp; privacy considerations">4. ~security/~privacyの考
30433031
~web開発者には可用でなかった新たな情報
30443032
— ~eventが処理された後に画素を描くまでの時間 —
30453033
を導入する。
3046-
時刻印を公開することに対する
3034+
時刻印を公開することに関する
30473035
~security/~privacy
30483036
]の懸念は
30493037
— とりわけ,この粒度の下では —
@@ -3053,7 +3041,7 @@ <h2 title="Security &amp; privacy considerations">4. ~security/~privacyの考
30533041
これは、
30543042
120Hz ~displayにおいても,それなりに精確な計時を許容する。
30553043
3056-
The duration has an 8 millisecond granularity (it is computed as such by performing rounding). Thus, a high resolution timer cannot be produced from this timestamps. However, it does introduce new information that is not readily available to web developers: the time pixels draw after an event has been processed. We do not find security or privacy concerns on exposing the timestamp, especially given its granularity. In an effort to expose the minimal amount of new information that is useful, we decided to pick 8 milliseconds as the granularity. This allows relatively precise timing even for 120Hz displays.
3044+
The duration has an 8 millisecond granularity (it is computed as such by performing rounding). Thus, a high resolution timer cannot be produced from these timestamps. However, it does introduce new information that is not readily available to web developers: the time pixels draw after an event has been processed. We do not find security or privacy concerns with exposing the timestamp, especially given its granularity. In an effort to expose the minimal amount of new information that is useful, we decided to pick 8 milliseconds as the granularity. This allows relatively precise timing even for 120Hz displays.
30573045
</p>
30583046

30593047
<p>

0 commit comments

Comments
 (0)