--- a/light/Overview.html Thu Sep 04 09:50:53 2014 +0200
+++ b/light/Overview.html Mon Sep 29 12:31:02 2014 +0300
@@ -1,803 +1,12 @@
<!DOCTYPE html>
-<html lang="en" dir="ltr" typeof="bibo:Document " about="" property="dcterms:language" content="en">
-<head>
+<html xmlns='http://www.w3.org/1999/xhtml' lang='en'>
+ <head>
+ <meta charset='utf-8'/>
+ <meta http-equiv="refresh" content="0; url=http://w3c.github.io/ambient-light/">
+ <link rel="canonical" href="http://w3c.github.io/ambient-light/">
<title>Ambient Light Events</title>
- <meta charset="utf-8">
-
-
- <style>/*****************************************************************
- * ReSpec 3 CSS
- * Robin Berjon - http://berjon.com/
- *****************************************************************/
-
-/* --- INLINES --- */
-em.rfc2119 {
- text-transform: lowercase;
- font-variant: small-caps;
- font-style: normal;
- color: #900;
-}
-
-h1 acronym, h2 acronym, h3 acronym, h4 acronym, h5 acronym, h6 acronym, a acronym,
-h1 abbr, h2 abbr, h3 abbr, h4 abbr, h5 abbr, h6 abbr, a abbr {
- border: none;
-}
-
-dfn {
- font-weight: bold;
-}
-
-a.internalDFN {
- color: inherit;
- border-bottom: 1px solid #99c;
- text-decoration: none;
-}
-
-a.externalDFN {
- color: inherit;
- border-bottom: 1px dotted #ccc;
- text-decoration: none;
-}
-
-a.bibref {
- text-decoration: none;
-}
-
-cite .bibref {
- font-style: normal;
-}
-
-code {
- color: #C83500;
-}
-
-/* --- TOC --- */
-.toc a, .tof a {
- text-decoration: none;
-}
-
-a .secno, a .figno {
- color: #000;
-}
-
-ul.tof, ol.tof {
- list-style: none outside none;
-}
-
-.caption {
- margin-top: 0.5em;
- font-style: italic;
-}
-
-/* --- TABLE --- */
-table.simple {
- border-spacing: 0;
- border-collapse: collapse;
- border-bottom: 3px solid #005a9c;
-}
-
-.simple th {
- background: #005a9c;
- color: #fff;
- padding: 3px 5px;
- text-align: left;
-}
-
-.simple th[scope="row"] {
- background: inherit;
- color: inherit;
- border-top: 1px solid #ddd;
-}
-
-.simple td {
- padding: 3px 10px;
- border-top: 1px solid #ddd;
-}
-
-.simple tr:nth-child(even) {
- background: #f0f6ff;
-}
-
-/* --- DL --- */
-.section dd > p:first-child {
- margin-top: 0;
-}
-
-.section dd > p:last-child {
- margin-bottom: 0;
-}
-
-.section dd {
- margin-bottom: 1em;
-}
-
-.section dl.attrs dd, .section dl.eldef dd {
- margin-bottom: 0;
-}
-
-@media print {
- .removeOnSave {
- display: none;
- }
-}
-</style><style>/* --- ISSUES/NOTES --- */
-div.issue-title, div.note-title {
- padding-right: 1em;
- min-width: 7.5em;
- color: #b9ab2d;
-}
-div.issue-title { color: #e05252; }
-div.note-title { color: #2b2; }
-div.issue-title span, div.note-title span {
- text-transform: uppercase;
-}
-div.note, div.issue {
- margin-top: 1em;
- margin-bottom: 1em;
-}
-.note > p:first-child, .issue > p:first-child { margin-top: 0 }
-.issue, .note {
- padding: .5em;
- border-left-width: .5em;
- border-left-style: solid;
-}
-div.issue, div.note {
- padding: 1em 1.2em 0.5em;
- margin: 1em 0;
- position: relative;
- clear: both;
-}
-span.note, span.issue { padding: .1em .5em .15em; }
-
-.issue {
- border-color: #e05252;
- background: #fbe9e9;
-}
-.note {
- border-color: #52e052;
- background: #e9fbe9;
-}
-
-
-</style><style>/* --- WEB IDL --- */
-pre.idl {
- border-top: 1px solid #90b8de;
- border-bottom: 1px solid #90b8de;
- padding: 1em;
- line-height: 120%;
-}
-
-pre.idl::before {
- content: "WebIDL";
- display: block;
- width: 150px;
- background: #90b8de;
- color: #fff;
- font-family: initial;
- padding: 3px;
- font-weight: bold;
- margin: -1em 0 1em -1em;
-}
-
-.idlType {
- color: #ff4500;
- font-weight: bold;
- text-decoration: none;
-}
-
-/*.idlModule*/
-/*.idlModuleID*/
-/*.idlInterface*/
-.idlInterfaceID, .idlDictionaryID, .idlCallbackID, .idlEnumID {
- font-weight: bold;
- color: #005a9c;
-}
-a.idlEnumItem {
- color: #000;
- border-bottom: 1px dotted #ccc;
- text-decoration: none;
-}
-
-.idlSuperclass {
- font-style: italic;
- color: #005a9c;
-}
-
-/*.idlAttribute*/
-.idlAttrType, .idlFieldType, .idlMemberType {
- color: #005a9c;
-}
-.idlAttrName, .idlFieldName, .idlMemberName {
- color: #ff4500;
-}
-.idlAttrName a, .idlFieldName a, .idlMemberName a {
- color: #ff4500;
- border-bottom: 1px dotted #ff4500;
- text-decoration: none;
-}
-
-/*.idlMethod*/
-.idlMethType, .idlCallbackType {
- color: #005a9c;
-}
-.idlMethName {
- color: #ff4500;
-}
-.idlMethName a {
- color: #ff4500;
- border-bottom: 1px dotted #ff4500;
- text-decoration: none;
-}
-
-/*.idlCtor*/
-.idlCtorName {
- color: #ff4500;
-}
-.idlCtorName a {
- color: #ff4500;
- border-bottom: 1px dotted #ff4500;
- text-decoration: none;
-}
-
-/*.idlParam*/
-.idlParamType {
- color: #005a9c;
-}
-.idlParamName, .idlDefaultValue {
- font-style: italic;
-}
-
-.extAttr {
- color: #666;
-}
-
-/*.idlSectionComment*/
-.idlSectionComment {
- color: gray;
-}
-
-/*.idlConst*/
-.idlConstType {
- color: #005a9c;
-}
-.idlConstName {
- color: #ff4500;
-}
-.idlConstName a {
- color: #ff4500;
- border-bottom: 1px dotted #ff4500;
- text-decoration: none;
-}
-
-/*.idlException*/
-.idlExceptionID {
- font-weight: bold;
- color: #c00;
-}
-
-.idlTypedefID, .idlTypedefType {
- color: #005a9c;
-}
-
-.idlRaises, .idlRaises a.idlType, .idlRaises a.idlType code, .excName a, .excName a code {
- color: #c00;
- font-weight: normal;
-}
-
-.excName a {
- font-family: monospace;
-}
-
-.idlRaises a.idlType, .excName a.idlType {
- border-bottom: 1px dotted #c00;
-}
-
-.excGetSetTrue, .excGetSetFalse, .prmNullTrue, .prmNullFalse, .prmOptTrue, .prmOptFalse {
- width: 45px;
- text-align: center;
-}
-.excGetSetTrue, .prmNullTrue, .prmOptTrue { color: #0c0; }
-.excGetSetFalse, .prmNullFalse, .prmOptFalse { color: #c00; }
-
-.idlImplements a {
- font-weight: bold;
-}
-
-dl.attributes, dl.methods, dl.constants, dl.constructors, dl.fields, dl.dictionary-members {
- margin-left: 2em;
-}
-
-.attributes dt, .methods dt, .constants dt, .constructors dt, .fields dt, .dictionary-members dt {
- font-weight: normal;
-}
-
-.attributes dt code, .methods dt code, .constants dt code, .constructors dt code, .fields dt code, .dictionary-members dt code {
- font-weight: bold;
- color: #000;
- font-family: monospace;
-}
-
-.attributes dt code, .fields dt code, .dictionary-members dt code {
- background: #ffffd2;
-}
-
-.attributes dt .idlAttrType code, .fields dt .idlFieldType code, .dictionary-members dt .idlMemberType code {
- color: #005a9c;
- background: transparent;
- font-family: inherit;
- font-weight: normal;
- font-style: italic;
-}
-
-.methods dt code {
- background: #d9e6f8;
-}
-
-.constants dt code {
- background: #ddffd2;
-}
-
-.constructors dt code {
- background: #cfc;
-}
-
-.attributes dd, .methods dd, .constants dd, .constructors dd, .fields dd, .dictionary-members dd {
- margin-bottom: 1em;
-}
-
-table.parameters, table.exceptions {
- border-spacing: 0;
- border-collapse: collapse;
- margin: 0.5em 0;
- width: 100%;
-}
-table.parameters { border-bottom: 1px solid #90b8de; }
-table.exceptions { border-bottom: 1px solid #deb890; }
-
-.parameters th, .exceptions th {
- color: #fff;
- padding: 3px 5px;
- text-align: left;
- font-family: initial;
- font-weight: normal;
- text-shadow: #666 1px 1px 0;
-}
-.parameters th { background: #90b8de; }
-.exceptions th { background: #deb890; }
-
-.parameters td, .exceptions td {
- padding: 3px 10px;
- border-top: 1px solid #ddd;
- vertical-align: top;
-}
-
-.parameters tr:first-child td, .exceptions tr:first-child td {
- border-top: none;
-}
-
-.parameters td.prmName, .exceptions td.excName, .exceptions td.excCodeName {
- width: 100px;
-}
-
-.parameters td.prmType {
- width: 120px;
-}
-
-table.exceptions table {
- border-spacing: 0;
- border-collapse: collapse;
- width: 100%;
-}
-</style><link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/W3C-ED"><!--[if lt IE 9]><script src='https://www.w3.org/2008/site/js/html5shiv.js'></script><![endif]--></head>
- <body class="h-entry" role="document" id="respecDocument"><div class="head" role="contentinfo" id="respecHeader">
- <p>
-
- <a href="http://www.w3.org/"><img width="72" height="48" src="https://www.w3.org/Icons/w3c_home" alt="W3C"></a>
-
- </p>
- <h1 class="title p-name" id="title" property="dcterms:title">Ambient Light Events</h1>
-
- <h2 property="dcterms:issued" datatype="xsd:dateTime" content="2014-09-02T08:09:11.000Z" id="w3c-editor-s-draft-02-september-2014"><abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft <time class="dt-published" datetime="2014-09-02">02 September 2014</time></h2>
- <dl>
-
- <dt>This version:</dt>
- <dd><a class="u-url" href="http://dvcs.w3.org/hg/dap/raw-file/default/light/Overview.html">http://dvcs.w3.org/hg/dap/raw-file/default/light/Overview.html</a></dd>
- <dt>Latest published version:</dt>
- <dd><a href="http://www.w3.org/TR/ambient-light/">http://www.w3.org/TR/ambient-light/</a></dd>
-
-
- <dt>Latest editor's draft:</dt>
- <dd><a href="http://dvcs.w3.org/hg/dap/raw-file/default/light/Overview.html">http://dvcs.w3.org/hg/dap/raw-file/default/light/Overview.html</a></dd>
-
-
- <dt>Test suite:</dt>
- <dd><a href="http://w3c-test.org/ambient-light/">http://w3c-test.org/ambient-light/</a></dd>
-
-
- <dt>Implementation report:</dt>
- <dd><a href="http://www.w3.org/2009/dap/wiki/ImplementationStatus">http://www.w3.org/2009/dap/wiki/ImplementationStatus</a></dd>
-
-
-
-
-
-
-
- <dt>Editors:</dt>
- <dd class="p-author h-card vcard" rel="bibo:editor" inlist=""><span typeof="foaf:Person"><span property="foaf:name" class="p-name fn">Doug Turner</span>, <a rel="foaf:workplaceHomepage" class="p-org org h-org h-card" href="http://mozilla.com/">Mozilla Corporation</a></span>
-</dd>
-<dd class="p-author h-card vcard" rel="bibo:editor" inlist=""><span typeof="foaf:Person"><span property="foaf:name" class="p-name fn">Anssi Kostiainen</span>, <a rel="foaf:workplaceHomepage" class="p-org org h-org h-card" href="http://intel.com/">Intel</a></span>
-</dd>
-
-
-
-
-
- <dt>Revision history:</dt>
-
-
-
- <dd>
- <a href="https://dvcs.w3.org/hg/dap/log/default/light/Overview.src.html">
- https://dvcs.w3.org/hg/dap/log/default/light/Overview.src.html
- </a>
- </dd>
-
-
-
-
-
-
- </dl>
-
-
-
-
-
- <p class="copyright">
- <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> ©
- 2014
-
- <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup>
- (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>,
- <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>,
- <a href="http://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>),
-
- All Rights Reserved.
-
- <abbr title="World Wide Web Consortium">W3C</abbr> <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
- <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and
-
- <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
-
- rules apply.
- </p>
-
-
- <hr>
-</div>
- <section id="abstract" class="introductory" property="dcterms:abstract" datatype="" typeof="bibo:Chapter" resource="#abstract" rel="bibo:Chapter"><h2 aria-level="1" role="heading" id="h2_abstract">Abstract</h2><p>
- This specification defines a means to receive events that correspond to
- a light sensor detecting the presence of a light.
- </p></section><section id="sotd" class="introductory" typeof="bibo:Chapter" resource="#sotd" rel="bibo:Chapter"><h2 aria-level="1" role="heading" id="h2_sotd">Status of This Document</h2>
-
-
-
- <p>
- <em>This section describes the status of this document at the time of its publication.
- Other documents may supersede this document. A list of current <abbr title="World Wide Web Consortium">W3C</abbr> publications and the
- latest revision of this technical report can be found in the <a href="http://www.w3.org/TR/"><abbr title="World Wide Web Consortium">W3C</abbr> technical reports index</a> at
- http://www.w3.org/TR/.</em>
- </p>
-
- <p>
- The functionality described in this specification was initially
- specified as part of the
- <a href="http://dvcs.w3.org/hg/dap/raw-file/default/sensor-api/Overview.html">
- Sensor API</a> but has been extracted in order to be more
- straightforward to implement, and in order to produce a specification
- that could be implemented on its own merits without interference with
- other features.
- </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.
-
-
- If you wish to make comments regarding this document, please send them to
- <a href="mailto:public-device-apis@w3.org">public-device-apis@w3.org</a>
- (<a href="mailto:public-device-apis-request@w3.org?subject=subscribe">subscribe</a>,
- <a href="http://lists.w3.org/Archives/Public/public-device-apis/">archives</a>).
-
-
-
-
- All comments are welcome.
-
- </p>
-
- <p>
- Please see the Working Group's <a href="http://www.w3.org/2009/dap/wiki/ImplementationStatus">implementation
- report</a>.
- </p>
-
-
- <p>
- Publication as an Editor's Draft does not imply endorsement by the <abbr title="World Wide Web Consortium">W3C</abbr>
- Membership. This is a draft document and may be updated, replaced or obsoleted by other
- documents at any time. It is inappropriate to cite this document as other than work in
- progress.
- </p>
-
-
-
- <p>
-
- This document was produced by a group operating under the
- <a id="sotd_patent" about="" rel="w3p:patentRules" href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 <abbr title="World Wide Web Consortium">W3C</abbr> Patent
- Policy</a>.
-
-
-
-
- <abbr title="World Wide Web Consortium">W3C</abbr> maintains a <a href="http://www.w3.org/2004/01/pp-impl/43696/status" rel="disclosure">public list of any patent
- disclosures</a>
-
- made in connection with the deliverables of the group; that page also includes
- instructions for disclosing a patent. An individual who has actual knowledge of a patent
- which the individual believes contains
- <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential
- Claim(s)</a> must disclose the information in accordance with
- <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
- 6 of the <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>.
-
-
- </p>
-
- <p>
- This document is governed by the <a id="w3c_process_revision" href="http://www.w3.org/2005/10/Process-20051014/">14 October 2005 <abbr title="World Wide Web Consortium">W3C</abbr> Process Document</a>.
- </p>
-
-
-
-
-
-</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-interface" 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>
- 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>
-
- <section id="conformance" typeof="bibo:Chapter" resource="#conformance" rel="bibo:Chapter"><!--OddPage--><h2 aria-level="1" role="heading" id="h2_conformance"><span class="secno">2. </span>Conformance</h2>
-<p>
- As well as sections marked as non-normative, all authoring guidelines, diagrams, examples,
- and notes in this specification are non-normative. Everything else in this specification is
- normative.
-</p>
-<p>
- The key words <em class="rfc2119" title="MUST">MUST</em>, <em class="rfc2119" title="MUST NOT">MUST NOT</em>, <em class="rfc2119" title="REQUIRED">REQUIRED</em>, <em class="rfc2119" title="SHOULD">SHOULD</em>, <em class="rfc2119" title="SHOULD NOT">SHOULD NOT</em>, <em class="rfc2119" title="RECOMMENDED">RECOMMENDED</em>, <em class="rfc2119" title="MAY">MAY</em>,
- and <em class="rfc2119" title="OPTIONAL">OPTIONAL</em> in this specification are to be interpreted as described in [<cite><a class="bibref" href="#bib-RFC2119">RFC2119</a></cite>].
-</p>
-
- <p>
- This specification defines conformance criteria that apply to a single
- product: the <dfn id="dfn-user-agent">user agent</dfn> that implements the
- interfaces that it contains.
- </p>
- <p>
- Implementations that use ECMAScript to implement the APIs
- defined in this specification must implement them in a manner
- consistent with the ECMAScript Bindings defined in the Web IDL
- specification [<cite><a class="bibref" href="#bib-WEBIDL">WEBIDL</a></cite>], as this specification uses that
- specification and terminology.
- </p>
- </section>
-
- <section id="terminology">
- <!--OddPage--><h2 aria-level="1" role="heading" id="h2_terminology"><span class="secno">3. </span>Terminology</h2>
- <p>
- The <code><a href="http://dev.w3.org/html5/spec/webappapis.html#eventhandler">
- EventHandler</a></code> interface represents a <a href="http://www.w3.org/TR/WebIDL/#idl-callback-functions">callback function</a> used for <a href="http://dev.w3.org/html5/spec/webappapis.html#event-handlers">event
- handlers</a> as defined in [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>]. </p>
- <p>
- The concepts <dfn id="dfn-queue-a-task"><a href="http://dev.w3.org/html5/spec/webappapis.html#queue-a-task">
- queue a task</a></dfn>,
- <dfn id="dfn-fires-a-simple-event"><a href="http://dev.w3.org/html5/spec/webappapis.html#fire-a-simple-event">
- fires a simple event</a></dfn>, and <dfn id="dfn-top-level-browsing-context">
- <a href="http://dev.w3.org/html5/spec/browsers.html#top-level-browsing-context">
- top-level browsing context</a></dfn> are defined in [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>].
- </p>
- <p>
- The terms <dfn id="dfn-event-handlers"><a href="http://dev.w3.org/html5/spec/webappapis.html#event-handlers">
- event handlers</a></dfn> and
- <dfn id="dfn-event-handler-event-types"><a href="http://dev.w3.org/html5/spec/webappapis.html#event-handler-event-type">
- event handler event types</a></dfn> are defined in [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>].
- </p>
- <p>
- Event constructor behavior is defined in
- <dfn id="dfn-constructing-events"><a href="http://dom.spec.whatwg.org/#constructing-events">
- constructing events</a></dfn> chapter in [<cite><a class="bibref" href="#bib-DOM4">DOM4</a></cite>].
- </p>
- <p>
- The concepts <dfn id="dfn-create-an-event">
- <a href="http://dom.spec.whatwg.org/#constructing-events">
- create an event</a></dfn> and <dfn id="dfn-fire-an-event">
- <a href="http://dom.spec.whatwg.org/#firing-events">
- fire an event</a></dfn> are defined in [<cite><a class="bibref" href="#bib-DOM4">DOM4</a></cite>].
- </p>
- <p>
- The <dfn id="dfn-current-light-level">current light level</dfn> is a value that represents the ambient
- light levels around the hosting device in lux units.
- </p>
- </section>
-
- <section class="informative" id="security-and-privacy-considerations">
- <!--OddPage--><h2 aria-level="1" role="heading" id="h2_security-and-privacy-considerations"><span class="secno">4. </span>Security and privacy considerations</h2><p><em>This section is non-normative.</em></p>
- <p>
- Privacy risks can arise when this specification is used in
- combination with other functionality or when used over time,
- specifically with the risk of correlation of data and user
- identification through fingerprinting. Web application developers
- using these JavaScript APIs should consider how this information might
- be correlated with other information and the privacy risks that might
- be created. The potential risks of collection of such data over a
- longer period of time should also be considered.
- </p>
- <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 limiting event rates
- available to web application developers.
- </p>
- <p>
- If the same JavaScript code using the API can be used simultaneously in
- different window contexts on the same device it may be possible for
- that code to correlate the user across those two contexts, creating
- unanticipated tracking mechanisms.
- </p>
- <p>
- Browser implementations should consider providing the user an
- indication of when the sensor is used and allowing the user to disable
- sensing.
- </p>
- <p>
- Web application developers that use this specification should perform a
- privacy assessment of their application taking all aspects of their
- application into consideration.
- </p>
- <p>
- 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
- 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>
- <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>
- </section>
- <section id="devicelightevent-interface">
- <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>]
-interface <span class="idlInterfaceID">DeviceLightEvent</span> : <span class="idlSuperclass">Event</span> {
-<span class="idlAttribute"> readonly attribute <span class="idlAttrType">unrestricted double</span> <span class="idlAttrName"><a href="#widl-DeviceLightEvent-value">value</a></span>;</span>
-};</span></pre>
-
- <p>
- The <code id="widl-DeviceLightEvent-value">value</code>
- <code id="widl-DeviceLightEventInit-value"></code>
- attribute of the <a href="#idl-def-DeviceLightEvent" class="idlType"><code>DeviceLightEvent</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 positive
- Infinity. It represents the <a href="#dfn-current-light-level" class="internalDFN">current light level</a>.
- </p>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_1"><span>Note</span></div><div class="">
- The precise lux value reported by different devices in the same light
- can be different, due to differences in detection method, sensor
- construction etc.
- </div></div>
- <p>
- When a <a href="#dfn-user-agent" class="internalDFN">user agent</a> is required to <dfn id="dfn-fire-a-device-light-event">fire a device
- light 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-DeviceLightEvent" class="idlType"><code>DeviceLightEvent</code></a>
- interface, with the name <code>devicelight</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" class="internalDFN">current
- light level</a>, initialize the <code>value</code>
- attribute to positive Infinity, otherwise initialize the
- attribute to the <a href="#dfn-current-light-level" class="internalDFN">current light level</a>.
- </li>
- </ol>
- </li>
- </ol>
- <p>
- When the <a href="#dfn-current-light-level" class="internalDFN">current light level</a> changes, the <a href="#dfn-user-agent" class="internalDFN">user agent</a>
- <em class="rfc2119" title="MUST">MUST</em> queue a task to <a href="#dfn-fire-a-device-light-event" class="internalDFN">fire a device light event</a>
- 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_2"><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">
- <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
- 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>ondevicelight</code></strong></td>
- <td><code>devicelight</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>
- Doug Turner for the initial prototype and Marcos Caceres for the
- test suite.
- </p>
- </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>. 10 July 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">Ian Hickson; 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>. 31 July 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. Best Current Practice. 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
+ </head>
+ <body>
+ <p>This document has <a href="http://w3c.github.io/ambient-light/">moved to GitHub</a>.</p>
+ </body>
+</html>
--- a/light/Overview.src.html Thu Sep 04 09:50:53 2014 +0200
+++ b/light/Overview.src.html Mon Sep 29 12:31:02 2014 +0300
@@ -1,299 +1,12 @@
<!DOCTYPE html>
-<html>
+<html xmlns='http://www.w3.org/1999/xhtml' lang='en'>
<head>
+ <meta charset='utf-8'/>
+ <meta http-equiv="refresh" content="0; url=http://w3c.github.io/ambient-light/">
+ <link rel="canonical" href="http://w3c.github.io/ambient-light/">
<title>Ambient Light Events</title>
- <meta charset="utf-8"/>
- <script src='https://www.w3.org/Tools/respec/respec-w3c-common' class='remove' async></script>
- <script class="remove">
- var respecConfig = {
- specStatus: "ED",
- shortName: "ambient-light",
- // publishDate: "2014-08-28",
- previousPublishDate: "2014-06-19",
- previousMaturity: "LC",
- edDraftURI: "http://dvcs.w3.org/hg/dap/raw-file/default/light/Overview.html",
- // crEnd: "2014-11-01",
- editors: [
- { name: "Doug Turner", company: "Mozilla Corporation", companyURL: "http://mozilla.com/" },
- { name: "Anssi Kostiainen", company: "Intel", companyURL: "http://intel.com/" }
- ],
- inlineCSS: true,
- noIDLIn: true,
- noLegacyStyle: true,
- wg: "Device APIs Working Group",
- wgURI: "http://www.w3.org/2009/dap/",
- wgPublicList: "public-device-apis",
- wgPatentURI: "http://www.w3.org/2004/01/pp-impl/43696/status",
- testSuiteURI: "http://w3c-test.org/ambient-light/",
- scheme: "https",
- implementationReportURI: "http://www.w3.org/2009/dap/wiki/ImplementationStatus",
- otherLinks: [{
- key: "Revision history",
- data: [{
- value: "https://dvcs.w3.org/hg/dap/log/default/light/Overview.src.html",
- href: "https://dvcs.w3.org/hg/dap/log/default/light/Overview.src.html"
- }]
- }],
- localBiblio: {
- "MEDIAQUERIES4": {
- title: "Media Queries Level 4",
- href: "http://dev.w3.org/csswg/mediaqueries4/",
- authors: [
- "Florian Rivoal",
- "Tab Atkins Jr."
- ],
- status: "ED",
- publisher: "W3C"
- }
- },
- processVersion: 2005
- };
- </script>
</head>
<body>
- <section id="abstract">
- This specification defines a means to receive events that correspond to
- a light sensor detecting the presence of a light.
- </section>
-
- <section id="sotd">
- <p>
- The functionality described in this specification was initially
- specified as part of the
- <a href="http://dvcs.w3.org/hg/dap/raw-file/default/sensor-api/Overview.html">
- Sensor API</a> but has been extracted in order to be more
- straightforward to implement, and in order to produce a specification
- that could be implemented on its own merits without interference with
- other features.
- </p>
- </section>
-
- <section class="informative">
- <h2>Introduction</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
- <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.
- </p>
- </section>
-
- <section id="conformance">
- <p>
- This specification defines conformance criteria that apply to a single
- product: the <dfn>user agent</dfn> that implements the
- interfaces that it contains.
- </p>
- <p>
- Implementations that use ECMAScript to implement the APIs
- defined in this specification must implement them in a manner
- consistent with the ECMAScript Bindings defined in the Web IDL
- specification [[!WEBIDL]], as this specification uses that
- specification and terminology.
- </p>
- </section>
-
- <section>
- <h2>Terminology</h2>
- <p>
- The <code><a href="http://dev.w3.org/html5/spec/webappapis.html#eventhandler">
- EventHandler</a></code> interface represents a <a href="http://www.w3.org/TR/WebIDL/#idl-callback-functions">callback function</a> used for <a href="http://dev.w3.org/html5/spec/webappapis.html#event-handlers">event
- handlers</a> as defined in [[!HTML5]]. </p>
- <p>
- The concepts <dfn><a href="http://dev.w3.org/html5/spec/webappapis.html#queue-a-task">
- queue a task</a></dfn>,
- <dfn><a href="http://dev.w3.org/html5/spec/webappapis.html#fire-a-simple-event">
- fires a simple event</a></dfn>, and <dfn>
- <a href="http://dev.w3.org/html5/spec/browsers.html#top-level-browsing-context">
- top-level browsing context</a></dfn> are defined in [[!HTML5]].
- </p>
- <p>
- The terms <dfn><a href="http://dev.w3.org/html5/spec/webappapis.html#event-handlers">
- event handlers</a></dfn> and
- <dfn><a href="http://dev.w3.org/html5/spec/webappapis.html#event-handler-event-type">
- event handler event types</a></dfn> are defined in [[!HTML5]].
- </p>
- <p>
- Event constructor behavior is defined in
- <dfn><a href="http://dom.spec.whatwg.org/#constructing-events">
- constructing events</a></dfn> chapter in [[!DOM4]].
- </p>
- <p>
- The concepts <dfn>
- <a href="http://dom.spec.whatwg.org/#constructing-events">
- create an event</a></dfn> and <dfn>
- <a href="http://dom.spec.whatwg.org/#firing-events">
- fire an event</a></dfn> are defined in [[!DOM4]].
- </p>
- <p>
- The <dfn>current light level</dfn> is a value that represents the ambient
- light levels around the hosting device in lux units.
- </p>
- </section>
-
- <section class="informative">
- <h2>Security and privacy considerations</h2>
- <p>
- Privacy risks can arise when this specification is used in
- combination with other functionality or when used over time,
- specifically with the risk of correlation of data and user
- identification through fingerprinting. Web application developers
- using these JavaScript APIs should consider how this information might
- be correlated with other information and the privacy risks that might
- be created. The potential risks of collection of such data over a
- longer period of time should also be considered.
- </p>
- <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 limiting event rates
- available to web application developers.
- </p>
- <p>
- If the same JavaScript code using the API can be used simultaneously in
- different window contexts on the same device it may be possible for
- that code to correlate the user across those two contexts, creating
- unanticipated tracking mechanisms.
- </p>
- <p>
- Browser implementations should consider providing the user an
- indication of when the sensor is used and allowing the user to disable
- sensing.
- </p>
- <p>
- Web application developers that use this specification should perform a
- privacy assessment of their application taking all aspects of their
- application into consideration.
- </p>
- <p>
- The event defined in this specification is only fired in the
- <a>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
- the event on the active tab, and not on the background tabs or
- within iframes.
- </p>
- </section>
-
- <section>
- <h2>Device Light</h2>
- <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)]
- interface DeviceLightEvent : Event"
- class="idl" data-merge='DeviceLightEventInit'>
- <dt>
- readonly attribute unrestricted double value
- </dt>
- <dd></dd>
- </dl>
- <dl title="dictionary DeviceLightEventInit : EventInit" class='idl'>
- <dt>
- unrestricted double value
- </dt>
- <dd></dd>
- </dl>
- <p>
- The <code id="widl-DeviceLightEvent-value">value</code>
- <code id="widl-DeviceLightEventInit-value"></code>
- attribute of the <a>DeviceLightEvent</a>
- interface MUST return the value it was initialized to. When the
- object is created, this attribute MUST be initialized to positive
- Infinity. It represents the <a>current light level</a>.
- </p>
- <div class="note">
- The precise lux value reported by different devices in the same light
- can be different, due to differences in detection method, sensor
- construction etc.
- </div>
- <p>
- When a <a>user agent</a> is required to <dfn>fire a device
- light event</dfn>, the <a>user agent</a> MUST run the
- following steps:
- </p>
- <ol class="rule">
- <li>
- <a>Create an event</a> that uses the <a>DeviceLightEvent</a>
- interface, with the name <code>devicelight</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>current
- light level</a>, initialize the <code>value</code>
- attribute to positive Infinity, otherwise initialize the
- attribute to the <a>current light level</a>.
- </li>
- </ol>
- </li>
- </ol>
- <p>
- When the <a>current light level</a> changes, the <a>user agent</a>
- MUST queue a task to <a>fire a device light event</a>
- at the <a>top-level browsing context</a>'s <a>Window</a> object.
- </p>
- <div class="note">
- 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>
- <section>
- <h2>Event handlers</h2>
- <p>
- The following are the <a>event handlers</a> (and their corresponding
- <a>event handler event types</a>) that MUST be supported as
- attributes by the <a>Window</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>ondevicelight</code></strong></td>
- <td><code>devicelight</code></td>
- </tr>
- </tbody>
- </table>
- </section>
- </section>
- </section>
-
- <section class="appendix">
- <h2>Acknowledgements</h2>
- <p>
- Doug Turner for the initial prototype and Marcos Caceres for the
- test suite.
- </p>
- </section>
+ <p>This document has <a href="http://w3c.github.io/ambient-light/">moved to GitHub</a>.</p>
</body>
</html>