[html5] r7437 - [giow] (3) Define when events are trusted and when they're not. Hopefully I got [...]
whatwg at whatwg.org
whatwg at whatwg.org
Sat Oct 6 11:04:38 PDT 2012
Author: ianh
Date: 2012-10-06 11:04:36 -0700 (Sat, 06 Oct 2012)
New Revision: 7437
Modified:
complete.html
index
source
Log:
[giow] (3) Define when events are trusted and when they're not. Hopefully I got all the places that create and dispatch events...
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=18423
Affected topics: DOM APIs, HTML, Server-Sent Events, Web Workers, WebSocket API
Modified: complete.html
===================================================================
--- complete.html 2012-10-05 23:02:56 UTC (rev 7436)
+++ complete.html 2012-10-06 18:04:36 UTC (rev 7437)
@@ -249,7 +249,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 5 October 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 6 October 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -12856,8 +12856,8 @@
<li><p><a href=#run-pre-click-activation-steps>Run pre-click activation steps</a> on the
element.</li>
- <li><p><a href=#fire-a-click-event>Fire a <code title=event-click>click</code>
- event</a> at the element.</li>
+ <li><p><a href=#fire-a-click-event>Fire a <code title=event-click>click</code> event</a> at the element. If the
+ <a href=#run-synthetic-click-activation-steps>run synthetic click activation steps</a> algorithm was invoked because the <code title=dom-click><a href=#dom-click>click()</a></code> method was invoked, then the <code title=dom-event-isTrusted><a href=#dom-event-istrusted>isTrusted</a></code> attribute must be initialized to false.</li>
<li>
@@ -42450,32 +42450,17 @@
<p>The <a href=#activation-behavior>activation behavior</a> of <code><a href=#the-area-element>area</a></code>
elements is to run the following steps:</p>
- <ol><li><p>If the <code title=event-click><a href=#event-click>click</a></code> event in
- question is not <a href=#concept-events-trusted title=concept-events-trusted>trusted</a>
- (i.e. a <code title=dom-click><a href=#dom-click>click()</a></code> method call was the
- reason for the event being dispatched), and the <code><a href=#the-area-element>area</a></code>
-<!--DOWNLOAD-->
- element has a <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute or the
-<!--DOWNLOAD-->
- element's <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>
- attribute is present and applying <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a
- browsing context given a browsing context name</a>, using the
- value of the <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>
- attribute as the browsing context name, would result in there not
- being a chosen browsing context, then throw an
- <code><a href=#invalidaccesserror>InvalidAccessError</a></code> exception and abort these
- steps.</li>
+ <ol><li><p>If the <code title=event-click><a href=#event-click>click</a></code> event in question is not <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> (i.e. a <code title=dom-click><a href=#dom-click>click()</a></code>
+ method call was the reason for the event being dispatched), and the <code><a href=#the-area-element>area</a></code> element has
+ a <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute or the element's <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code> attribute is present and applying <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for
+ choosing a browsing context given a browsing context name</a>, using the value of the <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code> attribute as the browsing context name, would result
+ in there not being a chosen browsing context, then throw an <code><a href=#invalidaccesserror>InvalidAccessError</a></code>
+ exception and abort these steps.</li>
- <li><p>Otherwise, the user agent must <a href=#following-hyperlinks title="following
- hyperlinks">follow the hyperlink</a>
-<!--DOWNLOAD-->
- or <a href=#downloading-hyperlinks title="downloading hyperlinks">download the hyperlink</a>
-<!--DOWNLOAD-->
- created by the <code><a href=#the-area-element>area</a></code> element, if any, and as determined by
-<!--DOWNLOAD-->
- the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute and
-<!--DOWNLOAD-->
- any expressed user preference.</li>
+ <li><p>Otherwise, the user agent must <a href=#following-hyperlinks title="following hyperlinks">follow the
+ hyperlink</a> or <a href=#downloading-hyperlinks title="downloading hyperlinks">download the hyperlink</a> created by
+ the <code><a href=#the-area-element>area</a></code> element, if any, and as determined by the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute and any expressed user
+ preference.</li>
</ol><p>The IDL attributes <dfn id=dom-area-alt title=dom-area-alt><code>alt</code></dfn>, <dfn id=dom-area-coords title=dom-area-coords><code>coords</code></dfn>, <dfn id=dom-area-href title=dom-area-href><code>href</code></dfn>, <dfn id=dom-area-target title=dom-area-target><code>target</code></dfn>,
<!--DOWNLOAD--><!--PING-->
@@ -71862,9 +71847,8 @@
<li><p>Increase the <code><a href=#document>Document</a></code>'s
<a href=#ignore-opens-during-unload-counter>ignore-opens-during-unload counter</a> by one.</li>
- <li><p>Let <var title="">event</var> be a new
- <code><a href=#beforeunloadevent>BeforeUnloadEvent</a></code> event object with the name <code title=event-beforeunload>beforeunload</code>, which does not
- bubble but is cancelable.</li>
+ <li><p>Let <var title="">event</var> be a new <a href=#concept-events-trusted title=concept-events-trusted>trusted</a>
+ <code><a href=#beforeunloadevent>BeforeUnloadEvent</a></code> event object with the name <code title=event-beforeunload>beforeunload</code>, which does not bubble but is cancelable.</li>
<li><p><i>Dispatch</i>: Dispatch <var title="">event</var> at the
<code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object.</li>
@@ -75870,29 +75854,23 @@
firing a <code title=event-click><a href=#event-click>click</a></code> event on the
element. <a href=#refsDOMEVENTS>[DOMEVENTS]</a></p>
- <p><dfn id=fire-a-simple-event title="fire a simple event">Firing a simple event named <var title="">e</var></dfn> means that an event with the name <var title="">e</var>, which does not bubble (except where otherwise
- stated) and is not cancelable (except where otherwise stated), and
- which uses the <code><a href=#event>Event</a></code> interface, must be created and
- dispatched at the given target.</p>
+ <p><dfn id=fire-a-simple-event title="fire a simple event">Firing a simple event named <var title="">e</var></dfn> means
+ that a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event with the name <var title="">e</var>, which does not bubble (except where otherwise stated) and is not cancelable
+ (except where otherwise stated), and which uses the <code><a href=#event>Event</a></code> interface, must be created
+ and dispatched at the given target.</p>
- <p><dfn id=fire-a-synthetic-mouse-event title="fire a synthetic mouse event">Firing a synthetic
- mouse event named <var title="">e</var></dfn> means that an event
- with the name <var title="">e</var>, which does not bubble (except
- where otherwise stated) and is not cancelable (except where
- otherwise stated), and which uses the <code><a href=#mouseevent>MouseEvent</a></code>
- interface, must be created and dispatched at the given target. The
- event object must have its <code title="">screenX</code>, <code title="">screenY</code>, <code title="">clientX</code>, <code title="">clientY</code>, and <code title="">button</code> attributes
- initialized to 0, its <code title="">ctrlKey</code>, <code title="">shiftKey</code>, <code title="">altKey</code>, and <code title="">metaKey</code> attributes initialized according to the
- current state of the key input device, if any (false for any keys
- that are not available), its <code title="">detail</code> attribute
- initialized to 1, and its <code title="">relatedTarget</code>
- attribute initialized to null. The <code title="">getModifierState()</code> method on the object must return
- values appropriately describing the state of the key input device at
- the time the event is created.</p>
+ <p><dfn id=fire-a-synthetic-mouse-event title="fire a synthetic mouse event">Firing a synthetic mouse event named <var title="">e</var></dfn> means that an event with the name <var title="">e</var>, which is <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> (except where otherwise stated), does not bubble
+ (except where otherwise stated), is not cancelable (except where otherwise stated), and which uses
+ the <code><a href=#mouseevent>MouseEvent</a></code> interface, must be created and dispatched at the given target. The
+ event object must have its <code title="">screenX</code>, <code title="">screenY</code>, <code title="">clientX</code>, <code title="">clientY</code>, and <code title="">button</code>
+ attributes initialized to 0, its <code title="">ctrlKey</code>, <code title="">shiftKey</code>,
+ <code title="">altKey</code>, and <code title="">metaKey</code> attributes initialized according
+ to the current state of the key input device, if any (false for any keys that are not available),
+ its <code title="">detail</code> attribute initialized to 1, and its <code title="">relatedTarget</code> attribute initialized to null. The <code title="">getModifierState()</code> method on the object must return values appropriately
+ describing the state of the key input device at the time the event is created.</p>
- <p><dfn id=fire-a-click-event title="fire a click event">Firing a <code title=event-click>click</code> event</dfn> means <a href=#fire-a-synthetic-mouse-event title="fire
- a synthetic mouse event">firing a synthetic mouse event named <code title=event-click>click</code></a>, which bubbles and is
- cancelable.</p>
+ <p><dfn id=fire-a-click-event title="fire a click event">Firing a <code title=event-click>click</code> event</dfn>
+ means <a href=#fire-a-synthetic-mouse-event title="fire a synthetic mouse event">firing a synthetic mouse event named <code title=event-click>click</code></a>, which bubbles and is cancelable.</p>
<p>The default action of these events is to do nothing except where
otherwise stated.</p>
@@ -80387,15 +80365,12 @@
<li>
- <p>Create a <code><a href=#dragevent>DragEvent</a></code> object and initialize it to
- have the given name <var title="">e</var>, to bubble, to be
- cancelable unless <var title="">e</var> is <code title=event-dragleave><a href=#event-dragleave>dragleave</a></code> or <code title=event-dragend><a href=#event-dragend>dragend</a></code>, and to have the <code title=dom-UIEvent-detail><a href=#dom-uievent-detail>detail</a></code> attribute initialized to
- zero, the mouse and key attributes initialized according to the
- state of the input devices as they would be for user interaction
- events, the <code title="">relatedTarget</code> attribute
- initialized to null, and the <code title=dom-DragEvent-dataTransfer><a href=#dom-dragevent-datatransfer>dataTransfer</a></code> attribute
- initialized to <var title="">dataTransfer</var>, the
- <code><a href=#datatransfer>DataTransfer</a></code> object created above.</p>
+ <p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> <code><a href=#dragevent>DragEvent</a></code> object
+ and initialize it to have the given name <var title="">e</var>, to bubble, to be cancelable
+ unless <var title="">e</var> is <code title=event-dragleave><a href=#event-dragleave>dragleave</a></code> or <code title=event-dragend><a href=#event-dragend>dragend</a></code>, and to have the <code title=dom-UIEvent-detail><a href=#dom-uievent-detail>detail</a></code> attribute initialized to zero, the mouse and key
+ attributes initialized according to the state of the input devices as they would be for user
+ interaction events, the <code title="">relatedTarget</code> attribute initialized to null, and
+ the <code title=dom-DragEvent-dataTransfer><a href=#dom-dragevent-datatransfer>dataTransfer</a></code> attribute initialized to <var title="">dataTransfer</var>, the <code><a href=#datatransfer>DataTransfer</a></code> object created above.</p>
<!-- interaction event spec point -->
@@ -83615,15 +83590,13 @@
<li><p>Return <var title="">worker</var> and perform the next
step asynchronously.</li>
- <li><p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code>
- interface, with the name <code title=event-connect>connect</code>, which does not bubble, is
- not cancelable, has no default action, has a <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute whose value
- is initialized to the empty string, has a <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute whose
- value is initialized to a <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array containing
- only the newly created port, and has a <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute whose
- value is initialized to the newly created port, and <a href=#queue-a-task>queue
- a task</a> to dispatch the event at <var title="">worker
- global scope</var>.</li>
+ <li><p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the
+ <code><a href=#messageevent>MessageEvent</a></code> interface, with the name <code title=event-connect>connect</code>, which does not bubble, is not cancelable, has no
+ default action, has a <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute whose value
+ is initialized to the empty string, has a <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code>
+ attribute whose value is initialized to a <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a>
+ array containing only the newly created port, and has a <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute whose value is initialized to the
+ newly created port, and <a href=#queue-a-task>queue a task</a> to dispatch the event at <var title="">worker global scope</var>.</li>
<li>
@@ -83672,16 +83645,14 @@
<li><p>Return <var title="">worker</var> and perform the remaining
steps asynchronously.</li>
- <li><p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code>
- interface, with the name <code title=event-connect>connect</code>, which does not bubble, is not
- cancelable, has no default action, has a <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute whose value is
- initialized to the empty string, has a <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute whose value
- is initialized to a <a href=#dfn-read-only-array title=dfn-read-only-array>read
- only</a> array containing only the newly created port, and has a
- <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute whose
- value is initialized to the newly created port, and <a href=#queue-a-task>queue a
- task</a> to dispatch the event at <var title="">worker global
- scope</var>.</li>
+ <li><p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the
+ <code><a href=#messageevent>MessageEvent</a></code> interface, with the name <code title=event-connect>connect</code>,
+ which does not bubble, is not cancelable, has no default action, has a <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute whose value is initialized to the empty
+ string, has a <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute whose value is
+ initialized to a <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array containing only the
+ newly created port, and has a <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute whose
+ value is initialized to the newly created port, and <a href=#queue-a-task>queue a task</a> to dispatch the
+ event at <var title="">worker global scope</var>.</li>
<li>
@@ -84605,17 +84576,13 @@
U+000A LINE FEED (LF) character, then remove the last character
from the <var title="">data</var> buffer.</li>
- <li><p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code>
- interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is not
- cancelable, and has no default action. The <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute must be
- initialized to the value of the <var title="">data</var> buffer,
- the <code title=dom-MessageEvent-origin><a href=#dom-messageevent-origin>origin</a></code> attribute
- must be initialized to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
- origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
- the event stream's final URL (i.e. the URL after redirects), and
- the <code title=dom-MessageEvent-lastEventId><a href=#dom-messageevent-lasteventid>lastEventId</a></code>
- attribute must be initialized to the <a href=#concept-event-stream-last-event-id title=concept-event-stream-last-event-id>last event ID
- string</a> of the event source.</li>
+ <li><p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code> interface, with the event type
+ <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is not cancelable, and has no
+ default action. The <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute must be initialized
+ to the value of the <var title="">data</var> buffer, the <code title=dom-MessageEvent-origin><a href=#dom-messageevent-origin>origin</a></code> attribute must be initialized to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an origin">Unicode serialization</a> of the
+ <a href=#origin>origin</a> of the event stream's final URL (i.e. the URL after redirects), and the <code title=dom-MessageEvent-lastEventId><a href=#dom-messageevent-lasteventid>lastEventId</a></code> attribute must be initialized to the
+ <a href=#concept-event-stream-last-event-id title=concept-event-stream-last-event-id>last event ID string</a> of the event source.
+ This event is not <a href=#concept-events-trusted title=concept-events-trusted>trusted</a>.</li>
<li><p>If the <var title="">event type</var> buffer has a value
other than the empty string, change the <a href=#concept-event-type title=concept-event-type>type</a> of the newly created event
@@ -85488,9 +85455,9 @@
<li>
- <p>Let <var title="">event</var> be an event that uses the
- <code><a href=#messageevent>MessageEvent</a></code> interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is
- not cancelable, and has no default action.
+ <p>Let <var title="">event</var> be a newly created <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the <code><a href=#messageevent>MessageEvent</a></code>
+ interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not
+ bubble, is not cancelable, and has no default action.
</p>
</li>
@@ -85576,16 +85543,13 @@
<a href=#fire-a-simple-event>fire a simple event</a> named <code title="">error</code>
at the <code><a href=#websocket>WebSocket</a></code> object. <a href=#refsWSP>[WSP]</a></li>
- <li><p>Create an event that uses the <code><a href=#closeevent>CloseEvent</a></code>
- interface, with the event type <code title=event-socket-close>close</code>, which does not bubble, is not
- cancelable, has no default action, whose <code title=dom-CloseEvent-wasClean><a href=#dom-closeevent-wasclean>wasClean</a></code> attribute is initialized to
- true if the connection closed <i title="">cleanly</i> and false
- otherwise, whose <code title=dom-CloseEvent-code><a href=#dom-closeevent-code>code</a></code>
- attribute is initialized to <i><a href=#the-websocket-connection-close-code>the WebSocket connection close code</a></i>, and
- whose <code title=dom-CloseEvent-reason><a href=#dom-closeevent-reason>reason</a></code> attribute
- is initialized to <i><a href=#the-websocket-connection-close-reason>the WebSocket connection close reason</a></i>
- <a href=#decoded-as-utf-8,-with-error-handling>decoded as UTF-8, with error handling</a>, and dispatch
- the event at the <code><a href=#websocket>WebSocket</a></code> object. <a href=#refsWSP>[WSP]</a></li>
+ <li><p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the
+ <code><a href=#closeevent>CloseEvent</a></code> interface, with the event type <code title=event-socket-close>close</code>, which does not bubble, is not cancelable, has no default
+ action, whose <code title=dom-CloseEvent-wasClean><a href=#dom-closeevent-wasclean>wasClean</a></code> attribute is initialized to
+ true if the connection closed <i title="">cleanly</i> and false otherwise, whose <code title=dom-CloseEvent-code><a href=#dom-closeevent-code>code</a></code> attribute is initialized to <i><a href=#the-websocket-connection-close-code>the WebSocket connection
+ close code</a></i>, and whose <code title=dom-CloseEvent-reason><a href=#dom-closeevent-reason>reason</a></code> attribute is
+ initialized to <i><a href=#the-websocket-connection-close-reason>the WebSocket connection close reason</a></i> <a href=#decoded-as-utf-8,-with-error-handling>decoded as UTF-8, with error
+ handling</a>, and dispatch the event at the <code><a href=#websocket>WebSocket</a></code> object. <a href=#refsWSP>[WSP]</a></li>
</ol><div class=warning>
@@ -86114,17 +86078,12 @@
<li>
- <p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code>
- interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is
- not cancelable, and has no default action. The <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute must be
- initialized to the value of <var title="">message clone</var>, the
- <code title=dom-MessageEvent-origin><a href=#dom-messageevent-origin>origin</a></code> attribute must
- be initialized to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
- origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
- the script that invoked the method, the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
- initialized to the <a href="#script's-global-object">script's global object</a>'s
- <code><a href=#windowproxy>WindowProxy</a></code> object, and the <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute must be
- initialized to the <var title="">new ports</var> array.
+ <p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the
+ <code><a href=#messageevent>MessageEvent</a></code> interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is not cancelable, and has no
+ default action. The <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute must be
+ initialized to the value of <var title="">message clone</var>, the <code title=dom-MessageEvent-origin><a href=#dom-messageevent-origin>origin</a></code> attribute must be initialized to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an origin">Unicode serialization</a> of the
+ <a href=#origin>origin</a> of the script that invoked the method, the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be initialized to the
+ <a href="#script's-global-object">script's global object</a>'s <code><a href=#windowproxy>WindowProxy</a></code> object, and the <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute must be initialized to the <var title="">new ports</var> array.
</p> <!-- invariant: the global object is always a Window if the
script can see this method -->
Modified: index
===================================================================
--- index 2012-10-05 23:02:56 UTC (rev 7436)
+++ index 2012-10-06 18:04:36 UTC (rev 7437)
@@ -249,7 +249,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 5 October 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 6 October 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -12856,8 +12856,8 @@
<li><p><a href=#run-pre-click-activation-steps>Run pre-click activation steps</a> on the
element.</li>
- <li><p><a href=#fire-a-click-event>Fire a <code title=event-click>click</code>
- event</a> at the element.</li>
+ <li><p><a href=#fire-a-click-event>Fire a <code title=event-click>click</code> event</a> at the element. If the
+ <a href=#run-synthetic-click-activation-steps>run synthetic click activation steps</a> algorithm was invoked because the <code title=dom-click><a href=#dom-click>click()</a></code> method was invoked, then the <code title=dom-event-isTrusted><a href=#dom-event-istrusted>isTrusted</a></code> attribute must be initialized to false.</li>
<li>
@@ -42450,32 +42450,17 @@
<p>The <a href=#activation-behavior>activation behavior</a> of <code><a href=#the-area-element>area</a></code>
elements is to run the following steps:</p>
- <ol><li><p>If the <code title=event-click><a href=#event-click>click</a></code> event in
- question is not <a href=#concept-events-trusted title=concept-events-trusted>trusted</a>
- (i.e. a <code title=dom-click><a href=#dom-click>click()</a></code> method call was the
- reason for the event being dispatched), and the <code><a href=#the-area-element>area</a></code>
-<!--DOWNLOAD-->
- element has a <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute or the
-<!--DOWNLOAD-->
- element's <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>
- attribute is present and applying <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a
- browsing context given a browsing context name</a>, using the
- value of the <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>
- attribute as the browsing context name, would result in there not
- being a chosen browsing context, then throw an
- <code><a href=#invalidaccesserror>InvalidAccessError</a></code> exception and abort these
- steps.</li>
+ <ol><li><p>If the <code title=event-click><a href=#event-click>click</a></code> event in question is not <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> (i.e. a <code title=dom-click><a href=#dom-click>click()</a></code>
+ method call was the reason for the event being dispatched), and the <code><a href=#the-area-element>area</a></code> element has
+ a <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute or the element's <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code> attribute is present and applying <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for
+ choosing a browsing context given a browsing context name</a>, using the value of the <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code> attribute as the browsing context name, would result
+ in there not being a chosen browsing context, then throw an <code><a href=#invalidaccesserror>InvalidAccessError</a></code>
+ exception and abort these steps.</li>
- <li><p>Otherwise, the user agent must <a href=#following-hyperlinks title="following
- hyperlinks">follow the hyperlink</a>
-<!--DOWNLOAD-->
- or <a href=#downloading-hyperlinks title="downloading hyperlinks">download the hyperlink</a>
-<!--DOWNLOAD-->
- created by the <code><a href=#the-area-element>area</a></code> element, if any, and as determined by
-<!--DOWNLOAD-->
- the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute and
-<!--DOWNLOAD-->
- any expressed user preference.</li>
+ <li><p>Otherwise, the user agent must <a href=#following-hyperlinks title="following hyperlinks">follow the
+ hyperlink</a> or <a href=#downloading-hyperlinks title="downloading hyperlinks">download the hyperlink</a> created by
+ the <code><a href=#the-area-element>area</a></code> element, if any, and as determined by the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute and any expressed user
+ preference.</li>
</ol><p>The IDL attributes <dfn id=dom-area-alt title=dom-area-alt><code>alt</code></dfn>, <dfn id=dom-area-coords title=dom-area-coords><code>coords</code></dfn>, <dfn id=dom-area-href title=dom-area-href><code>href</code></dfn>, <dfn id=dom-area-target title=dom-area-target><code>target</code></dfn>,
<!--DOWNLOAD--><!--PING-->
@@ -71862,9 +71847,8 @@
<li><p>Increase the <code><a href=#document>Document</a></code>'s
<a href=#ignore-opens-during-unload-counter>ignore-opens-during-unload counter</a> by one.</li>
- <li><p>Let <var title="">event</var> be a new
- <code><a href=#beforeunloadevent>BeforeUnloadEvent</a></code> event object with the name <code title=event-beforeunload>beforeunload</code>, which does not
- bubble but is cancelable.</li>
+ <li><p>Let <var title="">event</var> be a new <a href=#concept-events-trusted title=concept-events-trusted>trusted</a>
+ <code><a href=#beforeunloadevent>BeforeUnloadEvent</a></code> event object with the name <code title=event-beforeunload>beforeunload</code>, which does not bubble but is cancelable.</li>
<li><p><i>Dispatch</i>: Dispatch <var title="">event</var> at the
<code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object.</li>
@@ -75870,29 +75854,23 @@
firing a <code title=event-click><a href=#event-click>click</a></code> event on the
element. <a href=#refsDOMEVENTS>[DOMEVENTS]</a></p>
- <p><dfn id=fire-a-simple-event title="fire a simple event">Firing a simple event named <var title="">e</var></dfn> means that an event with the name <var title="">e</var>, which does not bubble (except where otherwise
- stated) and is not cancelable (except where otherwise stated), and
- which uses the <code><a href=#event>Event</a></code> interface, must be created and
- dispatched at the given target.</p>
+ <p><dfn id=fire-a-simple-event title="fire a simple event">Firing a simple event named <var title="">e</var></dfn> means
+ that a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event with the name <var title="">e</var>, which does not bubble (except where otherwise stated) and is not cancelable
+ (except where otherwise stated), and which uses the <code><a href=#event>Event</a></code> interface, must be created
+ and dispatched at the given target.</p>
- <p><dfn id=fire-a-synthetic-mouse-event title="fire a synthetic mouse event">Firing a synthetic
- mouse event named <var title="">e</var></dfn> means that an event
- with the name <var title="">e</var>, which does not bubble (except
- where otherwise stated) and is not cancelable (except where
- otherwise stated), and which uses the <code><a href=#mouseevent>MouseEvent</a></code>
- interface, must be created and dispatched at the given target. The
- event object must have its <code title="">screenX</code>, <code title="">screenY</code>, <code title="">clientX</code>, <code title="">clientY</code>, and <code title="">button</code> attributes
- initialized to 0, its <code title="">ctrlKey</code>, <code title="">shiftKey</code>, <code title="">altKey</code>, and <code title="">metaKey</code> attributes initialized according to the
- current state of the key input device, if any (false for any keys
- that are not available), its <code title="">detail</code> attribute
- initialized to 1, and its <code title="">relatedTarget</code>
- attribute initialized to null. The <code title="">getModifierState()</code> method on the object must return
- values appropriately describing the state of the key input device at
- the time the event is created.</p>
+ <p><dfn id=fire-a-synthetic-mouse-event title="fire a synthetic mouse event">Firing a synthetic mouse event named <var title="">e</var></dfn> means that an event with the name <var title="">e</var>, which is <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> (except where otherwise stated), does not bubble
+ (except where otherwise stated), is not cancelable (except where otherwise stated), and which uses
+ the <code><a href=#mouseevent>MouseEvent</a></code> interface, must be created and dispatched at the given target. The
+ event object must have its <code title="">screenX</code>, <code title="">screenY</code>, <code title="">clientX</code>, <code title="">clientY</code>, and <code title="">button</code>
+ attributes initialized to 0, its <code title="">ctrlKey</code>, <code title="">shiftKey</code>,
+ <code title="">altKey</code>, and <code title="">metaKey</code> attributes initialized according
+ to the current state of the key input device, if any (false for any keys that are not available),
+ its <code title="">detail</code> attribute initialized to 1, and its <code title="">relatedTarget</code> attribute initialized to null. The <code title="">getModifierState()</code> method on the object must return values appropriately
+ describing the state of the key input device at the time the event is created.</p>
- <p><dfn id=fire-a-click-event title="fire a click event">Firing a <code title=event-click>click</code> event</dfn> means <a href=#fire-a-synthetic-mouse-event title="fire
- a synthetic mouse event">firing a synthetic mouse event named <code title=event-click>click</code></a>, which bubbles and is
- cancelable.</p>
+ <p><dfn id=fire-a-click-event title="fire a click event">Firing a <code title=event-click>click</code> event</dfn>
+ means <a href=#fire-a-synthetic-mouse-event title="fire a synthetic mouse event">firing a synthetic mouse event named <code title=event-click>click</code></a>, which bubbles and is cancelable.</p>
<p>The default action of these events is to do nothing except where
otherwise stated.</p>
@@ -80387,15 +80365,12 @@
<li>
- <p>Create a <code><a href=#dragevent>DragEvent</a></code> object and initialize it to
- have the given name <var title="">e</var>, to bubble, to be
- cancelable unless <var title="">e</var> is <code title=event-dragleave><a href=#event-dragleave>dragleave</a></code> or <code title=event-dragend><a href=#event-dragend>dragend</a></code>, and to have the <code title=dom-UIEvent-detail><a href=#dom-uievent-detail>detail</a></code> attribute initialized to
- zero, the mouse and key attributes initialized according to the
- state of the input devices as they would be for user interaction
- events, the <code title="">relatedTarget</code> attribute
- initialized to null, and the <code title=dom-DragEvent-dataTransfer><a href=#dom-dragevent-datatransfer>dataTransfer</a></code> attribute
- initialized to <var title="">dataTransfer</var>, the
- <code><a href=#datatransfer>DataTransfer</a></code> object created above.</p>
+ <p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> <code><a href=#dragevent>DragEvent</a></code> object
+ and initialize it to have the given name <var title="">e</var>, to bubble, to be cancelable
+ unless <var title="">e</var> is <code title=event-dragleave><a href=#event-dragleave>dragleave</a></code> or <code title=event-dragend><a href=#event-dragend>dragend</a></code>, and to have the <code title=dom-UIEvent-detail><a href=#dom-uievent-detail>detail</a></code> attribute initialized to zero, the mouse and key
+ attributes initialized according to the state of the input devices as they would be for user
+ interaction events, the <code title="">relatedTarget</code> attribute initialized to null, and
+ the <code title=dom-DragEvent-dataTransfer><a href=#dom-dragevent-datatransfer>dataTransfer</a></code> attribute initialized to <var title="">dataTransfer</var>, the <code><a href=#datatransfer>DataTransfer</a></code> object created above.</p>
<!-- interaction event spec point -->
@@ -83615,15 +83590,13 @@
<li><p>Return <var title="">worker</var> and perform the next
step asynchronously.</li>
- <li><p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code>
- interface, with the name <code title=event-connect>connect</code>, which does not bubble, is
- not cancelable, has no default action, has a <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute whose value
- is initialized to the empty string, has a <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute whose
- value is initialized to a <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array containing
- only the newly created port, and has a <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute whose
- value is initialized to the newly created port, and <a href=#queue-a-task>queue
- a task</a> to dispatch the event at <var title="">worker
- global scope</var>.</li>
+ <li><p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the
+ <code><a href=#messageevent>MessageEvent</a></code> interface, with the name <code title=event-connect>connect</code>, which does not bubble, is not cancelable, has no
+ default action, has a <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute whose value
+ is initialized to the empty string, has a <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code>
+ attribute whose value is initialized to a <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a>
+ array containing only the newly created port, and has a <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute whose value is initialized to the
+ newly created port, and <a href=#queue-a-task>queue a task</a> to dispatch the event at <var title="">worker global scope</var>.</li>
<li>
@@ -83672,16 +83645,14 @@
<li><p>Return <var title="">worker</var> and perform the remaining
steps asynchronously.</li>
- <li><p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code>
- interface, with the name <code title=event-connect>connect</code>, which does not bubble, is not
- cancelable, has no default action, has a <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute whose value is
- initialized to the empty string, has a <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute whose value
- is initialized to a <a href=#dfn-read-only-array title=dfn-read-only-array>read
- only</a> array containing only the newly created port, and has a
- <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute whose
- value is initialized to the newly created port, and <a href=#queue-a-task>queue a
- task</a> to dispatch the event at <var title="">worker global
- scope</var>.</li>
+ <li><p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the
+ <code><a href=#messageevent>MessageEvent</a></code> interface, with the name <code title=event-connect>connect</code>,
+ which does not bubble, is not cancelable, has no default action, has a <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute whose value is initialized to the empty
+ string, has a <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute whose value is
+ initialized to a <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array containing only the
+ newly created port, and has a <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute whose
+ value is initialized to the newly created port, and <a href=#queue-a-task>queue a task</a> to dispatch the
+ event at <var title="">worker global scope</var>.</li>
<li>
@@ -84605,17 +84576,13 @@
U+000A LINE FEED (LF) character, then remove the last character
from the <var title="">data</var> buffer.</li>
- <li><p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code>
- interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is not
- cancelable, and has no default action. The <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute must be
- initialized to the value of the <var title="">data</var> buffer,
- the <code title=dom-MessageEvent-origin><a href=#dom-messageevent-origin>origin</a></code> attribute
- must be initialized to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
- origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
- the event stream's final URL (i.e. the URL after redirects), and
- the <code title=dom-MessageEvent-lastEventId><a href=#dom-messageevent-lasteventid>lastEventId</a></code>
- attribute must be initialized to the <a href=#concept-event-stream-last-event-id title=concept-event-stream-last-event-id>last event ID
- string</a> of the event source.</li>
+ <li><p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code> interface, with the event type
+ <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is not cancelable, and has no
+ default action. The <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute must be initialized
+ to the value of the <var title="">data</var> buffer, the <code title=dom-MessageEvent-origin><a href=#dom-messageevent-origin>origin</a></code> attribute must be initialized to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an origin">Unicode serialization</a> of the
+ <a href=#origin>origin</a> of the event stream's final URL (i.e. the URL after redirects), and the <code title=dom-MessageEvent-lastEventId><a href=#dom-messageevent-lasteventid>lastEventId</a></code> attribute must be initialized to the
+ <a href=#concept-event-stream-last-event-id title=concept-event-stream-last-event-id>last event ID string</a> of the event source.
+ This event is not <a href=#concept-events-trusted title=concept-events-trusted>trusted</a>.</li>
<li><p>If the <var title="">event type</var> buffer has a value
other than the empty string, change the <a href=#concept-event-type title=concept-event-type>type</a> of the newly created event
@@ -85488,9 +85455,9 @@
<li>
- <p>Let <var title="">event</var> be an event that uses the
- <code><a href=#messageevent>MessageEvent</a></code> interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is
- not cancelable, and has no default action.
+ <p>Let <var title="">event</var> be a newly created <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the <code><a href=#messageevent>MessageEvent</a></code>
+ interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not
+ bubble, is not cancelable, and has no default action.
</p>
</li>
@@ -85576,16 +85543,13 @@
<a href=#fire-a-simple-event>fire a simple event</a> named <code title="">error</code>
at the <code><a href=#websocket>WebSocket</a></code> object. <a href=#refsWSP>[WSP]</a></li>
- <li><p>Create an event that uses the <code><a href=#closeevent>CloseEvent</a></code>
- interface, with the event type <code title=event-socket-close>close</code>, which does not bubble, is not
- cancelable, has no default action, whose <code title=dom-CloseEvent-wasClean><a href=#dom-closeevent-wasclean>wasClean</a></code> attribute is initialized to
- true if the connection closed <i title="">cleanly</i> and false
- otherwise, whose <code title=dom-CloseEvent-code><a href=#dom-closeevent-code>code</a></code>
- attribute is initialized to <i><a href=#the-websocket-connection-close-code>the WebSocket connection close code</a></i>, and
- whose <code title=dom-CloseEvent-reason><a href=#dom-closeevent-reason>reason</a></code> attribute
- is initialized to <i><a href=#the-websocket-connection-close-reason>the WebSocket connection close reason</a></i>
- <a href=#decoded-as-utf-8,-with-error-handling>decoded as UTF-8, with error handling</a>, and dispatch
- the event at the <code><a href=#websocket>WebSocket</a></code> object. <a href=#refsWSP>[WSP]</a></li>
+ <li><p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the
+ <code><a href=#closeevent>CloseEvent</a></code> interface, with the event type <code title=event-socket-close>close</code>, which does not bubble, is not cancelable, has no default
+ action, whose <code title=dom-CloseEvent-wasClean><a href=#dom-closeevent-wasclean>wasClean</a></code> attribute is initialized to
+ true if the connection closed <i title="">cleanly</i> and false otherwise, whose <code title=dom-CloseEvent-code><a href=#dom-closeevent-code>code</a></code> attribute is initialized to <i><a href=#the-websocket-connection-close-code>the WebSocket connection
+ close code</a></i>, and whose <code title=dom-CloseEvent-reason><a href=#dom-closeevent-reason>reason</a></code> attribute is
+ initialized to <i><a href=#the-websocket-connection-close-reason>the WebSocket connection close reason</a></i> <a href=#decoded-as-utf-8,-with-error-handling>decoded as UTF-8, with error
+ handling</a>, and dispatch the event at the <code><a href=#websocket>WebSocket</a></code> object. <a href=#refsWSP>[WSP]</a></li>
</ol><div class=warning>
@@ -86114,17 +86078,12 @@
<li>
- <p>Create an event that uses the <code><a href=#messageevent>MessageEvent</a></code>
- interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is
- not cancelable, and has no default action. The <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute must be
- initialized to the value of <var title="">message clone</var>, the
- <code title=dom-MessageEvent-origin><a href=#dom-messageevent-origin>origin</a></code> attribute must
- be initialized to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an
- origin">Unicode serialization</a> of the <a href=#origin>origin</a> of
- the script that invoked the method, the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be
- initialized to the <a href="#script's-global-object">script's global object</a>'s
- <code><a href=#windowproxy>WindowProxy</a></code> object, and the <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute must be
- initialized to the <var title="">new ports</var> array.
+ <p>Create a <a href=#concept-events-trusted title=concept-events-trusted>trusted</a> event that uses the
+ <code><a href=#messageevent>MessageEvent</a></code> interface, with the event type <code title=event-message><a href=#event-message>message</a></code>, which does not bubble, is not cancelable, and has no
+ default action. The <code title=dom-MessageEvent-data><a href=#dom-messageevent-data>data</a></code> attribute must be
+ initialized to the value of <var title="">message clone</var>, the <code title=dom-MessageEvent-origin><a href=#dom-messageevent-origin>origin</a></code> attribute must be initialized to the <a href=#unicode-serialization-of-an-origin title="Unicode serialization of an origin">Unicode serialization</a> of the
+ <a href=#origin>origin</a> of the script that invoked the method, the <code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> attribute must be initialized to the
+ <a href="#script's-global-object">script's global object</a>'s <code><a href=#windowproxy>WindowProxy</a></code> object, and the <code title=dom-MessageEvent-ports><a href=#dom-messageevent-ports>ports</a></code> attribute must be initialized to the <var title="">new ports</var> array.
</p> <!-- invariant: the global object is always a Window if the
script can see this method -->
Modified: source
===================================================================
--- source 2012-10-05 23:02:56 UTC (rev 7436)
+++ source 2012-10-06 18:04:36 UTC (rev 7437)
@@ -13433,8 +13433,10 @@
<li><p><span>Run pre-click activation steps</span> on the
element.</p></li>
- <li><p><span>Fire a <code title="event-click">click</code>
- event</span> at the element.</p></li>
+ <li><p><span>Fire a <code title="event-click">click</code> event</span> at the element. If the
+ <span>run synthetic click activation steps</span> algorithm was invoked because the <code
+ title="dom-click">click()</code> method was invoked, then the <code
+ title="dom-event-isTrusted">isTrusted</code> attribute must be initialized to false.</p></li>
<li>
@@ -49582,32 +49584,21 @@
<ol>
- <li><p>If the <code title="event-click">click</code> event in
- question is not <span title="concept-events-trusted">trusted</span>
- (i.e. a <code title="dom-click">click()</code> method call was the
- reason for the event being dispatched), and the <code>area</code>
-<!--END w3c-html--><!--DOWNLOAD-->
- element has a <code title="attr-hyperlink-download">download</code> attribute or the
-<!--START w3c-html--><!--DOWNLOAD-->
- element's <code title="attr-hyperlink-target">target</code>
- attribute is present and applying <span>the rules for choosing a
- browsing context given a browsing context name</span>, using the
- value of the <code title="attr-hyperlink-target">target</code>
- attribute as the browsing context name, would result in there not
- being a chosen browsing context, then throw an
- <code>InvalidAccessError</code> exception and abort these
- steps.</p></li>
+ <li><p>If the <code title="event-click">click</code> event in question is not <span
+ title="concept-events-trusted">trusted</span> (i.e. a <code title="dom-click">click()</code>
+ method call was the reason for the event being dispatched), and the <code>area</code> element has
+ a <code title="attr-hyperlink-download">download</code> attribute or the element's <code
+ title="attr-hyperlink-target">target</code> attribute is present and applying <span>the rules for
+ choosing a browsing context given a browsing context name</span>, using the value of the <code
+ title="attr-hyperlink-target">target</code> attribute as the browsing context name, would result
+ in there not being a chosen browsing context, then throw an <code>InvalidAccessError</code>
+ exception and abort these steps.</p></li>
- <li><p>Otherwise, the user agent must <span title="following
- hyperlinks">follow the hyperlink</span>
-<!--END w3c-html--><!--DOWNLOAD-->
- or <span title="downloading hyperlinks">download the hyperlink</span>
-<!--START w3c-html--><!--DOWNLOAD-->
- created by the <code>area</code> element, if any, and as determined by
-<!--END w3c-html--><!--DOWNLOAD-->
- the <code title="attr-hyperlink-download">download</code> attribute and
-<!--START w3c-html--><!--DOWNLOAD-->
- any expressed user preference.</p></li>
+ <li><p>Otherwise, the user agent must <span title="following hyperlinks">follow the
+ hyperlink</span> or <span title="downloading hyperlinks">download the hyperlink</span> created by
+ the <code>area</code> element, if any, and as determined by the <code
+ title="attr-hyperlink-download">download</code> attribute and any expressed user
+ preference.</p></li>
</ol>
@@ -84022,10 +84013,9 @@
<li><p>Increase the <code>Document</code>'s
<span>ignore-opens-during-unload counter</span> by one.</p></li>
- <li><p>Let <var title="">event</var> be a new
+ <li><p>Let <var title="">event</var> be a new <span title="concept-events-trusted">trusted</span>
<code>BeforeUnloadEvent</code> event object with the name <code
- title="event-beforeunload">beforeunload</code>, which does not
- bubble but is cancelable.</p></li>
+ title="event-beforeunload">beforeunload</code>, which does not bubble but is cancelable.</p></li>
<li><p><i>Dispatch</i>: Dispatch <var title="">event</var> at the
<code>Document</code>'s <code>Window</code> object.</p></li>
@@ -88733,38 +88723,30 @@
firing a <code title="event-click">click</code> event on the
element. <a href="#refsDOMEVENTS">[DOMEVENTS]</a></p>
- <p><dfn title="fire a simple event">Firing a simple event named <var
- title="">e</var></dfn> means that an event with the name <var
- title="">e</var>, which does not bubble (except where otherwise
- stated) and is not cancelable (except where otherwise stated), and
- which uses the <code>Event</code> interface, must be created and
- dispatched at the given target.</p>
+ <p><dfn title="fire a simple event">Firing a simple event named <var title="">e</var></dfn> means
+ that a <span title="concept-events-trusted">trusted</span> event with the name <var
+ title="">e</var>, which does not bubble (except where otherwise stated) and is not cancelable
+ (except where otherwise stated), and which uses the <code>Event</code> interface, must be created
+ and dispatched at the given target.</p>
- <p><dfn title="fire a synthetic mouse event">Firing a synthetic
- mouse event named <var title="">e</var></dfn> means that an event
- with the name <var title="">e</var>, which does not bubble (except
- where otherwise stated) and is not cancelable (except where
- otherwise stated), and which uses the <code>MouseEvent</code>
- interface, must be created and dispatched at the given target. The
- event object must have its <code title="">screenX</code>, <code
- title="">screenY</code>, <code title="">clientX</code>, <code
- title="">clientY</code>, and <code title="">button</code> attributes
- initialized to 0, its <code title="">ctrlKey</code>, <code
- title="">shiftKey</code>, <code title="">altKey</code>, and <code
- title="">metaKey</code> attributes initialized according to the
- current state of the key input device, if any (false for any keys
- that are not available), its <code title="">detail</code> attribute
- initialized to 1, and its <code title="">relatedTarget</code>
- attribute initialized to null. The <code
- title="">getModifierState()</code> method on the object must return
- values appropriately describing the state of the key input device at
- the time the event is created.</p>
+ <p><dfn title="fire a synthetic mouse event">Firing a synthetic mouse event named <var
+ title="">e</var></dfn> means that an event with the name <var title="">e</var>, which is <span
+ title="concept-events-trusted">trusted</span> (except where otherwise stated), does not bubble
+ (except where otherwise stated), is not cancelable (except where otherwise stated), and which uses
+ the <code>MouseEvent</code> interface, must be created and dispatched at the given target. The
+ event object must have its <code title="">screenX</code>, <code title="">screenY</code>, <code
+ title="">clientX</code>, <code title="">clientY</code>, and <code title="">button</code>
+ attributes initialized to 0, its <code title="">ctrlKey</code>, <code title="">shiftKey</code>,
+ <code title="">altKey</code>, and <code title="">metaKey</code> attributes initialized according
+ to the current state of the key input device, if any (false for any keys that are not available),
+ its <code title="">detail</code> attribute initialized to 1, and its <code
+ title="">relatedTarget</code> attribute initialized to null. The <code
+ title="">getModifierState()</code> method on the object must return values appropriately
+ describing the state of the key input device at the time the event is created.</p>
- <p><dfn title="fire a click event">Firing a <code
- title="event-click">click</code> event</dfn> means <span title="fire
- a synthetic mouse event">firing a synthetic mouse event named <code
- title="event-click">click</code></span>, which bubbles and is
- cancelable.</p>
+ <p><dfn title="fire a click event">Firing a <code title="event-click">click</code> event</dfn>
+ means <span title="fire a synthetic mouse event">firing a synthetic mouse event named <code
+ title="event-click">click</code></span>, which bubbles and is cancelable.</p>
<p>The default action of these events is to do nothing except where
otherwise stated.</p>
@@ -93974,19 +93956,15 @@
<li>
- <p>Create a <code>DragEvent</code> object and initialize it to
- have the given name <var title="">e</var>, to bubble, to be
- cancelable unless <var title="">e</var> is <code
- title="event-dragleave">dragleave</code> or <code
+ <p>Create a <span title="concept-events-trusted">trusted</span> <code>DragEvent</code> object
+ and initialize it to have the given name <var title="">e</var>, to bubble, to be cancelable
+ unless <var title="">e</var> is <code title="event-dragleave">dragleave</code> or <code
title="event-dragend">dragend</code>, and to have the <code
- title="dom-UIEvent-detail">detail</code> attribute initialized to
- zero, the mouse and key attributes initialized according to the
- state of the input devices as they would be for user interaction
- events, the <code title="">relatedTarget</code> attribute
- initialized to null, and the <code
- title="dom-DragEvent-dataTransfer">dataTransfer</code> attribute
- initialized to <var title="">dataTransfer</var>, the
- <code>DataTransfer</code> object created above.</p>
+ title="dom-UIEvent-detail">detail</code> attribute initialized to zero, the mouse and key
+ attributes initialized according to the state of the input devices as they would be for user
+ interaction events, the <code title="">relatedTarget</code> attribute initialized to null, and
+ the <code title="dom-DragEvent-dataTransfer">dataTransfer</code> attribute initialized to <var
+ title="">dataTransfer</var>, the <code>DataTransfer</code> object created above.</p>
<!-- interaction event spec point -->
@@ -97034,20 +97012,16 @@
<li><p>Return <var title="">worker</var> and perform the next
step asynchronously.</p></li>
- <li><p>Create an event that uses the <code>MessageEvent</code>
- interface, with the name <code
- title="event-connect">connect</code>, which does not bubble, is
- not cancelable, has no default action, has a <code
- title="dom-MessageEvent-data">data</code> attribute whose value
- is initialized to the empty string, has a <code
- title="dom-MessageEvent-ports">ports</code> attribute whose
- value is initialized to a <span
- title="dfn-read-only-array">read only</span> array containing
- only the newly created port, and has a <code
- title="dom-MessageEvent-source">source</code> attribute whose
- value is initialized to the newly created port, and <span>queue
- a task</span> to dispatch the event at <var title="">worker
- global scope</var>.</p></li>
+ <li><p>Create a <span title="concept-events-trusted">trusted</span> event that uses the
+ <code>MessageEvent</code> interface, with the name <code
+ title="event-connect">connect</code>, which does not bubble, is not cancelable, has no
+ default action, has a <code title="dom-MessageEvent-data">data</code> attribute whose value
+ is initialized to the empty string, has a <code title="dom-MessageEvent-ports">ports</code>
+ attribute whose value is initialized to a <span title="dfn-read-only-array">read only</span>
+ array containing only the newly created port, and has a <code
+ title="dom-MessageEvent-source">source</code> attribute whose value is initialized to the
+ newly created port, and <span>queue a task</span> to dispatch the event at <var
+ title="">worker global scope</var>.</p></li>
<li>
@@ -97105,19 +97079,15 @@
<li><p>Return <var title="">worker</var> and perform the remaining
steps asynchronously.</p></li>
- <li><p>Create an event that uses the <code>MessageEvent</code>
- interface, with the name <code
- title="event-connect">connect</code>, which does not bubble, is not
- cancelable, has no default action, has a <code
- title="dom-MessageEvent-data">data</code> attribute whose value is
- initialized to the empty string, has a <code
- title="dom-MessageEvent-ports">ports</code> attribute whose value
- is initialized to a <span title="dfn-read-only-array">read
- only</span> array containing only the newly created port, and has a
- <code title="dom-MessageEvent-source">source</code> attribute whose
- value is initialized to the newly created port, and <span>queue a
- task</span> to dispatch the event at <var title="">worker global
- scope</var>.</p></li>
+ <li><p>Create a <span title="concept-events-trusted">trusted</span> event that uses the
+ <code>MessageEvent</code> interface, with the name <code title="event-connect">connect</code>,
+ which does not bubble, is not cancelable, has no default action, has a <code
+ title="dom-MessageEvent-data">data</code> attribute whose value is initialized to the empty
+ string, has a <code title="dom-MessageEvent-ports">ports</code> attribute whose value is
+ initialized to a <span title="dfn-read-only-array">read only</span> array containing only the
+ newly created port, and has a <code title="dom-MessageEvent-source">source</code> attribute whose
+ value is initialized to the newly created port, and <span>queue a task</span> to dispatch the
+ event at <var title="">worker global scope</var>.</p></li>
<li>
@@ -98217,20 +98187,16 @@
U+000A LINE FEED (LF) character, then remove the last character
from the <var title="">data</var> buffer.</p></li>
- <li><p>Create an event that uses the <code>MessageEvent</code>
- interface, with the event type <code
- title="event-message">message</code>, which does not bubble, is not
- cancelable, and has no default action. The <code
- title="dom-MessageEvent-data">data</code> attribute must be
- initialized to the value of the <var title="">data</var> buffer,
- the <code title="dom-MessageEvent-origin">origin</code> attribute
- must be initialized to the <span title="Unicode serialization of an
- origin">Unicode serialization</span> of the <span>origin</span> of
- the event stream's final URL (i.e. the URL after redirects), and
- the <code title="dom-MessageEvent-lastEventId">lastEventId</code>
- attribute must be initialized to the <span
- title="concept-event-stream-last-event-id">last event ID
- string</span> of the event source.</p></li>
+ <li><p>Create an event that uses the <code>MessageEvent</code> interface, with the event type
+ <code title="event-message">message</code>, which does not bubble, is not cancelable, and has no
+ default action. The <code title="dom-MessageEvent-data">data</code> attribute must be initialized
+ to the value of the <var title="">data</var> buffer, the <code
+ title="dom-MessageEvent-origin">origin</code> attribute must be initialized to the <span
+ title="Unicode serialization of an origin">Unicode serialization</span> of the
+ <span>origin</span> of the event stream's final URL (i.e. the URL after redirects), and the <code
+ title="dom-MessageEvent-lastEventId">lastEventId</code> attribute must be initialized to the
+ <span title="concept-event-stream-last-event-id">last event ID string</span> of the event source.
+ This event is not <span title="concept-events-trusted">trusted</span>.</p></li>
<li><p>If the <var title="">event type</var> buffer has a value
other than the empty string, change the <span
@@ -99277,10 +99243,10 @@
<li>
- <p>Let <var title="">event</var> be an event that uses the
- <code>MessageEvent</code> interface, with the event type <code
- title="event-message">message</code>, which does not bubble, is
- not cancelable, and has no default action.
+ <p>Let <var title="">event</var> be a newly created <span
+ title="concept-events-trusted">trusted</span> event that uses the <code>MessageEvent</code>
+ interface, with the event type <code title="event-message">message</code>, which does not
+ bubble, is not cancelable, and has no default action.
<!--END complete-->
<a href="#refsHTML">[HTML]</a>
<!--START complete-->
@@ -99396,18 +99362,15 @@
at the <code>WebSocket</code> object. <a
href="#refsWSP">[WSP]</a></p></li>
- <li><p>Create an event that uses the <code>CloseEvent</code>
- interface, with the event type <code
- title="event-socket-close">close</code>, which does not bubble, is not
- cancelable, has no default action, whose <code
- title="dom-CloseEvent-wasClean">wasClean</code> attribute is initialized to
- true if the connection closed <i title="">cleanly</i> and false
- otherwise, whose <code title="dom-CloseEvent-code">code</code>
- attribute is initialized to <i>the WebSocket connection close code</i>, and
- whose <code title="dom-CloseEvent-reason">reason</code> attribute
- is initialized to <i>the WebSocket connection close reason</i>
- <span>decoded as UTF-8, with error handling</span>, and dispatch
- the event at the <code>WebSocket</code> object. <a
+ <li><p>Create a <span title="concept-events-trusted">trusted</span> event that uses the
+ <code>CloseEvent</code> interface, with the event type <code
+ title="event-socket-close">close</code>, which does not bubble, is not cancelable, has no default
+ action, whose <code title="dom-CloseEvent-wasClean">wasClean</code> attribute is initialized to
+ true if the connection closed <i title="">cleanly</i> and false otherwise, whose <code
+ title="dom-CloseEvent-code">code</code> attribute is initialized to <i>the WebSocket connection
+ close code</i>, and whose <code title="dom-CloseEvent-reason">reason</code> attribute is
+ initialized to <i>the WebSocket connection close reason</i> <span>decoded as UTF-8, with error
+ handling</span>, and dispatch the event at the <code>WebSocket</code> object. <a
href="#refsWSP">[WSP]</a></p></li>
</ol>
@@ -100030,21 +99993,18 @@
<li>
- <p>Create an event that uses the <code>MessageEvent</code>
- interface, with the event type <code
- title="event-message">message</code>, which does not bubble, is
- not cancelable, and has no default action. The <code
- title="dom-MessageEvent-data">data</code> attribute must be
- initialized to the value of <var title="">message clone</var>, the
- <code title="dom-MessageEvent-origin">origin</code> attribute must
- be initialized to the <span title="Unicode serialization of an
- origin">Unicode serialization</span> of the <span>origin</span> of
- the script that invoked the method, the <code
- title="dom-MessageEvent-source">source</code> attribute must be
- initialized to the <span>script's global object</span>'s
- <code>WindowProxy</code> object, and the <code
- title="dom-MessageEvent-ports">ports</code> attribute must be
- initialized to the <var title="">new ports</var> array.
+ <p>Create a <span title="concept-events-trusted">trusted</span> event that uses the
+ <code>MessageEvent</code> interface, with the event type <code
+ title="event-message">message</code>, which does not bubble, is not cancelable, and has no
+ default action. The <code title="dom-MessageEvent-data">data</code> attribute must be
+ initialized to the value of <var title="">message clone</var>, the <code
+ title="dom-MessageEvent-origin">origin</code> attribute must be initialized to the <span
+ title="Unicode serialization of an origin">Unicode serialization</span> of the
+ <span>origin</span> of the script that invoked the method, the <code
+ title="dom-MessageEvent-source">source</code> attribute must be initialized to the
+ <span>script's global object</span>'s <code>WindowProxy</code> object, and the <code
+ title="dom-MessageEvent-ports">ports</code> attribute must be initialized to the <var
+ title="">new ports</var> array.
<!--END complete-->
<a href="#refsHTML">[HTML]</a>
<!--START complete-->
More information about the Commit-Watchers
mailing list