ISSUE-159: Clarify ctrlKey


Clarify ctrlKey

HISTORICAL: DOM3 Events [All Bugs and Issues use Bugzilla:]
Raised by:
Doug Schepers
Opened on:
David Flanagan <>:
4) When you are describing the altKey, ctrlKey and similar attributes of
"KeyboardEvent" you use the word "activated" to mean "in effect". Just
above that, in the list of constants, you use the word "activation" to
mean "the key press or release that triggered this event". This wording
is confusing because it could be read to mean that ctrlKey, for example,
will only be true when the key is first pressed down. I suggest you
avoid "activated" here and use language like this:

"true if the control (Ctrl) modifier was active when this event

I realize now that I actually don't know whether ctrlKey should be true
for the event generated when Ctrl is first pressed down. Or whether it
should be true when the Ctrl key is released. So maybe you could clarify
that here, too. Guessing at the proper settings for this modifier, you
might say something like:

"If this KeyboardEvent describes the press of a control key, then
this property will be true. If this KeyboardEvent describes the release
of a control key, and if no other control modifier is active, then this
property will be false."

Related Actions Items:
No related actions
Related emails:
  1. RE: Re: ISSUE-161 ISSUE-160 ISSUE-159 ISSUE-158 ISSUE-156 (from on 2011-07-29)
  2. Re: ISSUE-161 ISSUE-160 ISSUE-159 ISSUE-158 (from on 2011-07-29)
  3. ISSUE-159 (ctrlKey): Clarify ctrlKey [DOM3 Events] (from on 2010-10-20)

Related notes:

Revision 1.158 covered this.

Jacob Rossi, 2 May 2011, 06:43:34

Display change log ATOM feed

Chair, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <>.
$Id: 159.html,v 1.1 2016/01/25 10:26:16 carine Exp $