- From: Mercurial notifier <cvsmail@w3.org>
- Date: Fri, 06 Jun 2014 09:45:24 +0000
- To: public-dap-commits@w3.org
changeset: 518:3fd6477059d0
tag: tip
user: Anssi Kostiainen <anssi.kostiainen@intel.com>
date: Fri Jun 06 12:42:51 2014 +0300
files: light/Overview.html light/Overview.src.html
description:
Carve out extensions to Window Interface into its own section;
better introduction.
diff -r d9f7319be53f -r 3fd6477059d0 light/Overview.html
--- a/light/Overview.html Fri Jun 06 12:27:46 2014 +0300
+++ b/light/Overview.html Fri Jun 06 12:42:51 2014 +0300
@@ -397,7 +397,7 @@
</p>
<h1 class="title p-name" id="title" property="dcterms:title">Ambient Light Events</h1>
- <h2 property="dcterms:issued" datatype="xsd:dateTime" content="2014-04-28T08:06:54.000Z" id="w3c-editor-s-draft-28-april-2014"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2014-04-28">28 April 2014</time></h2>
+ <h2 property="dcterms:issued" datatype="xsd:dateTime" content="2014-06-06T06:36:13.000Z" id="w3c-editor-s-draft-06-june-2014"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2014-06-06">06 June 2014</time></h2>
<dl>
<dt>This version:</dt>
@@ -496,11 +496,6 @@
that could be implemented on its own merits without interference with
other features.
</p>
- <p>
- Changes in this document since the previously published First Public Working Draft
- include the addition of the Light Level section with the LightLevelEvent interface,
- editorial cleanup, and an update to the references.
- </p>
<p>
This document was published by the <a href="http://www.w3.org/2009/dap/">Device APIs Working Group</a> as an Editor's Draft.
@@ -554,19 +549,22 @@
-</section><section id="toc"><h2 class="introductory" aria-level="1" role="heading" id="h2_toc">Table of Contents</h2><ul class="toc" role="directory" id="respecContents"><li class="tocline"><a href="#introduction" class="tocxref"><span class="secno">1. </span>Introduction</a></li><li class="tocline"><a href="#conformance" class="tocxref"><span class="secno">2. </span>Conformance</a></li><li class="tocline"><a href="#terminology" class="tocxref"><span class="secno">3. </span>Terminology</a></li><li class="tocline"><a href="#security-and-privacy-considerations" class="tocxref"><span class="secno">4. </span>Security and privacy considerations</a></li><li class="tocline"><a href="#device-light" class="tocxref"><span class="secno">5. </span>Device Light</a><ul class="toc"><li class="tocline"><a href="#devicelightevent-interface" class="tocxref"><span class="secno">5.1 </span><span class="formerLink"><code>DeviceLightEvent</code></span> Interface</a><ul class="toc"><li class="tocline"><a href="#event-handlers" cass="tocxref"><span class="secno">5.1.1 </span>Event handlers</a></li></ul></li></ul></li><li class="tocline"><a href="#light-level" class="tocxref"><span class="secno">6. </span>Light Level</a><ul class="toc"><li class="tocline"><a href="#lightlevelevent-interface" class="tocxref"><span class="secno">6.1 </span><span class="formerLink"><code>LightLevelEvent</code></span> Interface</a><ul class="toc"><li class="tocline"><a href="#event-handlers-1" class="tocxref"><span class="secno">6.1.1 </span>Event handlers</a></li></ul></li></ul></li><li class="tocline"><a href="#acknowledgements" class="tocxref"><span class="secno">A. </span>Acknowledgements</a></li><li class="tocline"><a href="#references" class="tocxref"><span class="secno">B. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class="tocxref"><span class="secno">B.1 </span>Normative references</a></li></ul></li></ul></section>
+</section><section id="toc"><h2 class="introductory" aria-level="1" role="heading" id="h2_toc">Table of Contents</h2><ul class="toc" role="directory" id="respecContents"><li class="tocline"><a href="#introduction" class="tocxref"><span class="secno">1. </span>Introduction</a></li><li class="tocline"><a href="#conformance" class="tocxref"><span class="secno">2. </span>Conformance</a></li><li class="tocline"><a href="#terminology" class="tocxref"><span class="secno">3. </span>Terminology</a></li><li class="tocline"><a href="#security-and-privacy-considerations" class="tocxref"><span class="secno">4. </span>Security and privacy considerations</a></li><li class="tocline"><a href="#device-light" class="tocxref"><span class="secno">5. </span>Device Light</a><ul class="toc"><li class="tocline"><a href="#extensions-to-window-interface" class="tocxref"><span class="secno">5.1 </span>Extensions to <span class="formerLink"><code>Window</code></span> Interface</a></li><li class="tocline"><a href="#devicelightevent-intrface" class="tocxref"><span class="secno">5.2 </span><span class="formerLink"><code>DeviceLightEvent</code></span> Interface</a><ul class="toc"><li class="tocline"><a href="#event-handlers" class="tocxref"><span class="secno">5.2.1 </span>Event handlers</a></li></ul></li></ul></li><li class="tocline"><a href="#acknowledgements" class="tocxref"><span class="secno">A. </span>Acknowledgements</a></li><li class="tocline"><a href="#references" class="tocxref"><span class="secno">B. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class="tocxref"><span class="secno">B.1 </span>Normative references</a></li><li class="tocline"><a href="#informative-references" class="tocxref"><span class="secno">B.2 </span>Informative references</a></li></ul></li></ul></section>
<section class="informative" id="introduction">
<!--OddPage--><h2 aria-level="1" role="heading" id="h2_introduction"><span class="secno">1. </span>Introduction</h2><p><em>This section is non-normative.</em></p>
<p>
- This specification defines events that provide information about the
- ambient light level, as measured by a device's light sensor. A
- <a href="#idl-def-LightLevelEvent" class="idlType"><code>LightLevelEvent</code></a> describes the light level as one of three simple
- categories - "dim", "normal", and "bright" - while a
- <a href="#idl-def-DeviceLightEvent" class="idlType"><code>DeviceLightEvent</code></a> provides a more granular answer by describing
- the light level in terms of lux units.
+ The <a href="#idl-def-DeviceLightEvent" class="idlType"><code>DeviceLightEvent</code></a> interface provides information about the
+ ambient light levels, as detected by the device's light detector, in
+ terms of lux units.
+ </p>
+ <p>
+ The
+ <a href="http://dev.w3.org/csswg/mediaqueries4/#light-level">
+ 'light-level' media feature</a> [<cite><a class="bibref" href="#bib-mediaqueries4">mediaqueries4</a></cite>] provides more granular,
+ less precise, information about the ambient light level.
</p>
</section>
@@ -652,9 +650,8 @@
<p>
Variations in implementation light level values as well as event firing
rates offer the possibility of fingerprinting to identify users.
- Browser implementations may reduce the risk by only using the less
- precise <a href="#idl-def-LightLevelState" class="idlType"><code>LightLevelState</code></a> of 'dim', 'normal', and 'bright' and limiting
- event rates available to web application developers.
+ Browser implementations may reduce the risk by limiting event rates
+ available to web application developers.
</p>
<p>
If the same JavaScript code using the API can be used simultaneously in
@@ -673,38 +670,36 @@
application into consideration.
</p>
<p>
- The events defined in this specification are only fired in the
+ The event defined in this specification is only fired in the
<a href="#dfn-top-level-browsing-context" class="internalDFN">top-level browsing context</a> to avoid the privacy risk of
sharing the information defined in this specification with contexts
unfamiliar to the user. For example, a mobile device will only fire
- these events on the active tab, and not on the background tabs or
+ the event on the active tab, and not on the background tabs or
within iframes.
</p>
</section>
<section id="device-light">
<!--OddPage--><h2 aria-level="1" role="heading" id="h2_device-light"><span class="secno">5. </span>Device Light</h2>
- <p>
- The <a href="#idl-def-DeviceLightEvent" class="idlType"><code>DeviceLightEvent</code></a> interface provides information about the
- ambient light levels, as detected by the device's light detector, in
- terms of lux units.
- </p>
- <p>
- The HTML5 specification [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>] defines a <a href="#idl-def-Window" class="idlType"><code>Window</code></a> interface,
- which this specification extends:
- </p>
- <pre class="idl"><span class="idlInterface" id="idl-def-Window">partial interface <span class="idlInterfaceID">Window</span> {
+ <section id="extensions-to-window-interface">
+ <h3 aria-level="2" role="heading" id="h3_extensions-to-window-interface"><span class="secno">5.1 </span>Extensions to <a href="#idl-def-Window" class="idlType"><code>Window</code></a> Interface</h3>
+ <p>
+ The HTML5 specification [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>] defines a <a href="#idl-def-Window" class="idlType"><code>Window</code></a> interface,
+ which this specification extends:
+ </p>
+ <pre class="idl"><span class="idlInterface" id="idl-def-Window">partial interface <span class="idlInterfaceID">Window</span> {
<span class="idlAttribute"> attribute <span class="idlAttrType">EventHandler</span> <span class="idlAttrName"><a href="#widl-Window-ondevicelight">ondevicelight</a></span>;</span>
};</span></pre>
- <p>
- The <code id="widl-Window-ondevicelight">ondevicelight</code>
- event handler and its corresponding
- event handler event type <code>devicelight</code> <em class="rfc2119" title="MUST">MUST</em> be supported
- as an IDL attribute by all objects implementing the <a href="#idl-def-Window" class="idlType"><code>Window</code></a>
- interface.
- </p>
+ <p>
+ The <code id="widl-Window-ondevicelight">ondevicelight</code>
+ event handler and its corresponding
+ event handler event type <code>devicelight</code> <em class="rfc2119" title="MUST">MUST</em> be supported
+ as an IDL attribute by all objects implementing the <a href="#idl-def-Window" class="idlType"><code>Window</code></a>
+ interface.
+ </p>
+ </section>
<section id="devicelightevent-interface">
- <h3 aria-level="2" role="heading" id="h3_devicelightevent-interface"><span class="secno">5.1 </span><a href="#idl-def-DeviceLightEvent" class="idlType"><code>DeviceLightEvent</code></a> Interface</h3>
+ <h3 aria-level="2" role="heading" id="h3_devicelightevent-interface"><span class="secno">5.2 </span><a href="#idl-def-DeviceLightEvent" class="idlType"><code>DeviceLightEvent</code></a> Interface</h3>
<pre class="idl"><span class="idlInterface" id="idl-def-DeviceLightEvent"><span class="idlDictionary" id="idl-def-DeviceLightEventInit">dictionary <span class="idlDictionaryID">DeviceLightEventInit</span> : <span class="idlSuperclass">EventInit</span> {
<span class="idlMember"> <span class="idlMemberType">unrestricted double</span> <span class="idlMemberName"><a href="#widl-DeviceLightEventInit-value">value</a></span>;</span>
};</span><br><br>[<span class="extAttr">Constructor (DOMString type, optional DeviceLightEventInit eventInitDict)</span>]
@@ -758,7 +753,7 @@
fresh data.
</div></div>
<section id="event-handlers">
- <h4 aria-level="3" role="heading" id="h4_event-handlers"><span class="secno">5.1.1 </span>Event handlers</h4>
+ <h4 aria-level="3" role="heading" id="h4_event-handlers"><span class="secno">5.2.1 </span>Event handlers</h4>
<p>
The following are the <a href="#dfn-event-handlers" class="internalDFN">event handlers</a> (and their corresponding
<a href="#dfn-event-handler-event-types" class="internalDFN">event handler event types</a>) that <em class="rfc2119" title="MUST">MUST</em> be supported as
@@ -781,130 +776,7 @@
</section>
</section>
</section>
-
- <section id="light-level">
- <!--OddPage--><h2 aria-level="1" role="heading" id="h2_light-level"><span class="secno">6. </span>Light Level</h2>
- <p>
- The <a href="#idl-def-LightLevelEvent" class="idlType"><code>LightLevelEvent</code></a> interface provides information about the
- ambient light levels, as detected by the device's light detector, in
- terms of three general range: "dim", "normal", or "bright".
- </p>
- <p>
- The HTML5 specification [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>] defines a <a href="#idl-def-Window" class="idlType"><code>Window</code></a> interface,
- which this specification extends:
- </p>
- <pre class="idl"><span class="idlInterface" id="idl-def-Window-1">partial interface <span class="idlInterfaceID">Window</span> {
-<span class="idlAttribute"> attribute <span class="idlAttrType">EventHandler</span> <span class="idlAttrName"><a href="#widl-Window-onlightlevel">onlightlevel</a></span>;</span>
-};</span></pre>
- <p>
- The <code id="widl-Window-onlightlevel">onlightlevel</code>
- event handler and its corresponding
- event handler event type <code>lightlevel</code> <em class="rfc2119" title="MUST">MUST</em> be supported
- as an IDL attribute by all objects implementing the <a href="#idl-def-Window" class="idlType"><code>Window</code></a>
- interface.
- </p>
- <section id="lightlevelevent-interface">
- <h3 aria-level="2" role="heading" id="h3_lightlevelevent-interface"><span class="secno">6.1 </span><a href="#idl-def-LightLevelEvent" class="idlType"><code>LightLevelEvent</code></a> Interface</h3>
- <pre class="idl"><span class="idlInterface" id="idl-def-LightLevelEvent"><span class="idlEnum" id="idl-def-LightLevelState">enum <span class="idlEnumID">LightLevelState</span> {
- "<a href="#idl-def-LightLevelState.generatedID" class="idlEnumItem"></a>",
- "<a href="#idl-def-LightLevelState.dim" class="idlEnumItem">dim</a>",
- "<a href="#idl-def-LightLevelState.normal" class="idlEnumItem">normal</a>",
- "<a href="#idl-def-LightLevelState.bright" class="idlEnumItem">bright</a>"
-};</span><br><br><span class="idlDictionary" id="idl-def-LightLevelEventInit">dictionary <span class="idlDictionaryID">LightLevelEventInit</span> : <span class="idlSuperclass">EventInit</span> {
-<span class="idlMember"> <span class="idlMemberType"><a href="#idl-def-LightLevelState" class="idlType"><code>LightLevelState</code></a></span> <span class="idlMemberName"><a href="#widl-LightLevelEventInit-value">value</a></span>;</span>
-};</span><br><br>[<span class="extAttr">Constructor (DOMString type, optional LightLevelEventInit eventInitDict)</span>]
-interface <span class="idlInterfaceID">LightLevelEvent</span> : <span class="idlSuperclass">Event</span> {
-<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a href="#idl-def-LightLevelState" class="idlType"><code>LightLevelState</code></a></span> <span class="idlAttrName"><a href="#widl-LightLevelEvent-value">value</a></span>;</span>
-};</span></pre>
-
-
- <p>
- The <code id="widl-LightLevelEvent-value">value</code>
- <code id="widl-LightLevelEventInit-value"></code>
- attribute of the <a href="#idl-def-LightLevelEvent" class="idlType"><code>LightLevelEvent</code></a>
- interface <em class="rfc2119" title="MUST">MUST</em> return the value it was initialized to. When the
- object is created, this attribute <em class="rfc2119" title="MUST">MUST</em> be initialized to an empty
- string. It represents the <a href="#dfn-current-light-level-state" class="internalDFN">current light level state</a>.
- </p>
- <p>
- When a <a href="#dfn-user-agent" class="internalDFN">user agent</a> is required to <dfn id="dfn-fire-a-light-level-event">fire a light
- level event</dfn>, the <a href="#dfn-user-agent" class="internalDFN">user agent</a> <em class="rfc2119" title="MUST">MUST</em> run the
- following steps:
- </p>
- <ol class="rule">
- <li>
- <a href="#dfn-create-an-event" class="internalDFN">Create an event</a> that uses the <a href="#idl-def-LightLevelEvent" class="idlType"><code>LightLevelEvent</code></a>
- interface, with the name <code>lightlevel</code>, which
- bubbles, is not cancelable, and has no default action, that also
- meets the following conditions:
- <ol>
- <li>
- If the implementation is unable to report the <a href="#dfn-current-light-level-state" class="internalDFN">current
- light level state</a>, initialize the <code>value</code>
- attribute to an empty string, otherwise initialize the
- attribute to the <a href="#dfn-current-light-level-state" class="internalDFN">current light level state</a>, which <em class="rfc2119" title="MUST">MUST</em>
- be one of the following values:
- <ul>
- <li><code id="idl-def-LightLevelState.dim">dim</code></li>
- <li><code id="idl-def-LightLevelState.normal">normal</code></li>
- <li><code id="idl-def-LightLevelState.bright">bright</code></li>
- </ul>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_3"><span>Note</span></div><div class="">
- The lux ranges that map to the <a href="#dfn-current-light-level-state" class="internalDFN">current light level
- state</a>s are left to the implementation, as devices with
- different sensitivities could map them slightly differently.
- However, it is recommended that "<code>dim</code>" correspond
- to ambient light below 50 lux (dark enough that the light
- produced by a white background is eye-straining or
- distracting), "<code>normal</code>" correspond to light
- between 50 lux and 10000 lux (office building hallway, very
- dark overcast day, office lighting, sunrise or sunset on a
- clear day, overcast day, or similar), and
- "<code>bright</code>" correspond to light above 10000 lux
- (direct sunlight, or similarly bright conditions that make it
- hard to see things that aren't high-contrast).
- </div></div>
- </li>
- </ol>
- </li>
- </ol>
- <p>
- When the <a href="#dfn-current-light-level-state" class="internalDFN">current light level state</a> changes, the <a href="#dfn-user-agent" class="internalDFN">user agent</a>
- <em class="rfc2119" title="MUST">MUST</em> queue a task to <dfn id="dfn-fire-a-user-proximity-event">fire a user proximity event</dfn>
- at the <a href="#dfn-top-level-browsing-context" class="internalDFN">top-level browsing context</a>'s <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object.
- </p>
-
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_4"><span>Note</span></div><div class="">
- The definition of granularity i.e. how often the event is fired is
- left to the implementation. Implementations can fire the event if
- they have reason to believe that the page does not have sufficiently
- fresh data.
- </div></div>
- <section id="event-handlers-1">
- <h4 aria-level="3" role="heading" id="h4_event-handlers-1"><span class="secno">6.1.1 </span>Event handlers</h4>
- <p>
- The following are the <a href="#dfn-event-handlers" class="internalDFN">event handlers</a> (and their corresponding
- <a href="#dfn-event-handler-event-types" class="internalDFN">event handler event types</a>) that <em class="rfc2119" title="MUST">MUST</em> be supported as
- attributes by the <a href="#idl-def-Window" class="idlType"><code>Window</code></a> object:
- </p>
- <table class="simple">
- <thead>
- <tr>
- <th>event handler</th>
- <th>event handler event type</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><strong><code>onlightlevel</code></strong></td>
- <td><code>lightlevel</code></td>
- </tr>
- </tbody>
- </table>
- </section>
- </section>
- </section>
-
+
<section class="appendix" id="acknowledgements">
<!--OddPage--><h2 aria-level="1" role="heading" id="h2_acknowledgements"><span class="secno">A. </span>Acknowledgements</h2>
<p>
@@ -914,8 +786,9 @@
</section>
-<section id="references" class="appendix" typeof="bibo:Chapter" resource="#references" rel="bibo:Chapter"><!--OddPage--><h2 aria-level="1" role="heading" id="h2_references"><span class="secno">B. </span>References</h2><section id="normative-references" typeof="bibo:Chapter" resource="#normative-references" rel="bibo:Chapter"><h3 aria-level="2" role="heading" id="h3_normative-references"><span class="secno">B.1 </span>Normative references</h3><dl class="bibliography" about=""><dt id="bib-DOM4">[DOM4]</dt><dd rel="dcterms:requires">Anne van Kesteren; Aryeh Gregor; Ms2ger; Alex Russell; Robin Berjon. <a href="http://www.w3.org/TR/dom/"><cite>W3C DOM4</cite></a>. 4 February 2014. W3C Last Call Working Draft. URL: <a href="http://www.w3.org/TR/dom/">http://www.w3.org/TR/dom/</a>
-</dd><dt id="bib-HTML5">[HTML5]</dt><dd rel="dcterms:requires">Robin Berjon; Steve Faulkner; Travis Leithead; Erika Doyle Navara; Edward O'Connor; Silvia Pfeiffer. <a href="http://www.w3.org/TR/html5/"><cite>HTML5</cite></a>. 4 February 2014. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
+<section id="references" class="appendix" typeof="bibo:Chapter" resource="#references" rel="bibo:Chapter"><!--OddPage--><h2 aria-level="1" role="heading" id="h2_references"><span class="secno">B. </span>References</h2><section id="normative-references" typeof="bibo:Chapter" resource="#normative-references" rel="bibo:Chapter"><h3 aria-level="2" role="heading" id="h3_normative-references"><span class="secno">B.1 </span>Normative references</h3><dl class="bibliography" about=""><dt id="bib-DOM4">[DOM4]</dt><dd rel="dcterms:requires">Anne van Kesteren; Aryeh Gregor; Ms2ger; Alex Russell; Robin Berjon. <a href="http://www.w3.org/TR/dom/"><cite>W3C DOM4</cite></a>. 8 May 2014. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/dom/">http://www.w3.org/TR/dom/</a>
+</dd><dt id="bib-HTML5">[HTML5]</dt><dd rel="dcterms:requires">Robin Berjon; Steve Faulkner; Travis Leithead; Erika Doyle Navara; Edward O'Connor; Silvia Pfeiffer. <a href="http://www.w3.org/TR/html5/"><cite>HTML5</cite></a>. 29 April 2014. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
</dd><dt id="bib-RFC2119">[RFC2119]</dt><dd rel="dcterms:requires">S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key words for use in RFCs to Indicate Requirement Levels.</cite></a> March 1997. Internet RFC 2119. URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a>
</dd><dt id="bib-WEBIDL">[WEBIDL]</dt><dd rel="dcterms:requires">Cameron McCormack. <a href="http://www.w3.org/TR/WebIDL/"><cite>Web IDL</cite></a>. 19 April 2012. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/WebIDL/">http://www.w3.org/TR/WebIDL/</a>
+</dd></dl></section><section id="informative-references" typeof="bibo:Chapter" resource="#informative-references" rel="bibo:Chapter"><h3 aria-level="2" role="heading" id="h3_informative-references"><span class="secno">B.2 </span>Informative references</h3><dl class="bibliography" about=""><dt id="bib-mediaqueries4">[mediaqueries4]</dt><dd rel="dcterms:references">Florian Rivoal; Tab Atkins Jr.. <a href="http://dev.w3.org/csswg/mediaqueries4/"><cite>Media Queries Level 4</cite></a>. W3C Editor's Draft. URL: <a href="http://dev.w3.org/csswg/mediaqueries4/">http://dev.w3.org/csswg/mediaqueries4/</a>
</dd></dl></section></section></body></html>
\ No newline at end of file
diff -r d9f7319be53f -r 3fd6477059d0 light/Overview.src.html
--- a/light/Overview.src.html Fri Jun 06 12:27:46 2014 +0300
+++ b/light/Overview.src.html Fri Jun 06 12:42:51 2014 +0300
@@ -69,9 +69,12 @@
<section class="informative">
<h2>Introduction</h2>
<p>
- This specification defines an event that provide information about the
- ambient light level, as measured by a device's light sensor, in terms
- of lux units. The
+ The <a>DeviceLightEvent</a> interface provides information about the
+ ambient light levels, as detected by the device's light detector, in
+ terms of lux units.
+ </p>
+ <p>
+ The
<a href="http://dev.w3.org/csswg/mediaqueries4/#light-level">
'light-level' media feature</a> [[mediaqueries4]] provides more granular,
less precise, information about the ambient light level.
@@ -181,28 +184,26 @@
<section>
<h2>Device Light</h2>
- <p>
- The <a>DeviceLightEvent</a> interface provides information about the
- ambient light levels, as detected by the device's light detector, in
- terms of lux units.
- </p>
- <p>
- The HTML5 specification [[!HTML5]] defines a <a>Window</a> interface,
- which this specification extends:
- </p>
- <dl title="partial interface Window" class="idl">
- <dt>
- attribute EventHandler ondevicelight
- </dt>
- <dd></dd>
- </dl>
- <p>
- The <code id="widl-Window-ondevicelight">ondevicelight</code>
- event handler and its corresponding
- event handler event type <code>devicelight</code> MUST be supported
- as an IDL attribute by all objects implementing the <a>Window</a>
- interface.
- </p>
+ <section>
+ <h2>Extensions to <a>Window</a> Interface</h2>
+ <p>
+ The HTML5 specification [[!HTML5]] defines a <a>Window</a> interface,
+ which this specification extends:
+ </p>
+ <dl title="partial interface Window" class="idl">
+ <dt>
+ attribute EventHandler ondevicelight
+ </dt>
+ <dd></dd>
+ </dl>
+ <p>
+ The <code id="widl-Window-ondevicelight">ondevicelight</code>
+ event handler and its corresponding
+ event handler event type <code>devicelight</code> MUST be supported
+ as an IDL attribute by all objects implementing the <a>Window</a>
+ interface.
+ </p>
+ </section>
<section>
<h2><a>DeviceLightEvent</a> Interface</h2>
<dl title="[Constructor (DOMString type, optional DeviceLightEventInit eventInitDict)]
Received on Friday, 6 June 2014 09:45:26 UTC