- From: Mercurial notifier <cvsmail@w3.org>
- Date: Mon, 16 Jun 2014 07:14:20 +0000
- To: public-dap-commits@w3.org
changeset: 540:e7698057c562 user: Anssi Kostiainen <anssi.kostiainen@intel.com> date: Mon Jun 16 10:10:56 2014 +0300 files: light/LC2-diff.html light/Overview.html light/Overview.src.html description: Add CR to LC2 diff. diff -r e1adbc40c86a -r e7698057c562 light/LC2-diff.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/light/LC2-diff.html Mon Jun 16 10:10:56 2014 +0300 @@ -0,0 +1,3263 @@ +<!DOCTYPE html> +<html lang="en" dir="ltr" typeof="bibo:Document w3p:LastCall" about="" property="dcterms:language" content="en"> +<head> +<title>Ambient Light Events</title> +<meta charset="utf-8"> +<style type="text/css"> +/***************************************************************** + * 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: #ff4500; +} + +/* --- 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 type="text/css"> +/* --- 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 type="text/css"> +/* --- 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-WD" type="text/css"><!--[if lt IE 9]><script src='https://www.w3.org/2008/site/js/html5shiv.js'></script><![endif]--> +<style type='text/css'> +.diff-old-a { + font-size: smaller; + color: red; +} + +.diff-new { background-color: yellow; } +.diff-chg { background-color: lime; } +.diff-new:before, +.diff-new:after + { content: "\2191" } +.diff-chg:before, .diff-chg:after + { content: "\2195" } +.diff-old { text-decoration: line-through; background-color: #FBB; } +.diff-old:before, +.diff-old:after + { content: "\2193" } +:focus { border: thin red solid} +</style> +</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-06-18T21:00:00.000Z" id="w3c-last-call-working-draft-19-june-2014"> +<abbr title="World Wide Web Consortium"> +W3C +</abbr> +<del class="diff-old">Candidate +Recommendation +01 +October +2013 +</del> +<ins class="diff-chg">Last +Call +Working +Draft +</ins><time class="dt-published" datetime="2014-06-19"><ins class="diff-chg"> +19 +June +2014 +</ins> +</time> +</h2> +<dl> +<dt> +This +version: +</dt> +<dd> +<del class="diff-old">http://www.w3.org/TR/2013/CR-ambient-light-20131001/ +</del> +<a class="u-url" href="http://www.w3.org/TR/2014/WD-ambient-light-20140619/"> +<ins class="diff-chg">http://www.w3.org/TR/2014/WD-ambient-light-20140619/ +</ins> +</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> +<del class="diff-old">https://w3c-test.org/web-platform-tests/master/ambient-light/ +</del> +<a href="http://w3c-test.org/ambient-light/"> +<ins class="diff-chg">http://w3c-test.org/ambient-light/ +</ins> +</a> +</dd> +<dt> +Previous +version: +</dt> +<dd> +<del class="diff-old">http://www.w3.org/TR/2012/WD-ambient-light-20121213/ +</del> +<a rel="dcterms:replaces" href="http://www.w3.org/TR/2013/CR-ambient-light-20131001/"> +<ins class="diff-chg">http://www.w3.org/TR/2013/CR-ambient-light-20131001/ +</ins> +</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> +© +<del class="diff-old">2013 +</del> +<ins class="diff-chg">2014 +</ins> +<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 +<ins class="diff-new">following +changes +have +been +made +since +the +</ins><a href="http://www.w3.org/TR/2013/CR-ambient-light-20131001/"><abbr title="World Wide Web Consortium"><ins class="diff-new"> +W3C +</ins></abbr><ins class="diff-new"> +Candidate +Recommendation +01 +October +2013 +</ins></a>:</p><ul><li><ins class="diff-new"> +Removed +the +</ins><a href="http://www.w3.org/TR/2013/CR-ambient-light-20131001/#lightlevelevent-interface"><code><ins class="diff-new"> +LightLevelEvent +</ins></code></a><ins class="diff-new"> +interface +to +align +with +implementations. +</ins></li><li><ins class="diff-new"> +Updated +the +</ins><a href="#terminology"><ins class="diff-new"> +Terminology +</ins></a>,<a href="#security-and-privacy-considerations"><ins class="diff-new"> +Security +and +privacy +considerations +</ins></a><ins class="diff-new"> +and +</ins><a href="#introduction"><ins class="diff-new"> +Introduction +</ins></a><ins class="diff-new"> +sections +accordingly. +</ins></li></ul><p><ins class="diff-new"> +The +</ins> +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> +<del class="diff-old">Changes +since +Last +Call +include +addition +of +a +new +security +considerations +section, +clarification +of +lux +level +light +values, +clarifications +to +the +text +and +processing +description +and +updated +references +and +the +addition +of +a +WebIDL +reference. +These +changes +include +updates +to +address +Last +Call +comments +that +were +received +( +disposition +of +comments +). +A +diff +showing +changes +since +the +Last +Call +publication +is +available +( +diff +). +The +CR +exit +criterion +is +two +interoperable +deployed +implementations +of +each +feature, +with +no +features +marked +as +'at-risk'. +The +group +will +create +an +Implementation +Report +. +</del> +This +document +was +published +by +the +<a href="http://www.w3.org/2009/dap/"> +Device +APIs +Working +Group +</a> +as +a +<del class="diff-old">Candidate +Recommendation. +</del> +<ins class="diff-chg">Last +Call +Working +Draft. +</ins> +This +document +is +intended +to +become +a +<abbr title="World Wide Web Consortium"> +W3C +</abbr> +Recommendation. +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> +). +<del class="diff-old">W3C +publishes +a +Candidate +Recommendation +to +indicate +that +the +document +is +believed +to +be +stable +and +to +encourage +implementation +by +the +developer +community. +This +Candidate +Recommendation +is +expected +to +advance +to +Proposed +Recommendation +no +earlier +than +21 +November +2013. +</del> +<ins class="diff-chg">The +Last +Call +period +ends +24 +July +2014. +</ins> +All +comments +are +welcome. +</p> +<p> +Publication +as +a +<del class="diff-old">Candidate +Recommendation +</del> +<ins class="diff-chg">Last +Call +Working +Draft +</ins> +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 +<ins class="diff-new">is +a +Last +Call +Working +Draft +and +thus +the +Working +Group +has +determined +that +this +document +has +satisfied +the +relevant +technical +requirements +and +is +sufficiently +stable +to +advance +through +the +Technical +Recommendation +process. +</ins></p><p><ins class="diff-new"> +This +</ins> +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> +</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> +<ins class="diff-new">Extensions +to +</ins> +<span class="formerLink"> +<code> +<del class="diff-old">DeviceLightEvent +</del> +<ins class="diff-chg">Window +</ins> +</code> +</span> +Interface +</a> +<del class="diff-old">5.1.1 +Event +handlers +</del> +</li> +<del class="diff-old">6. +Light +Level +</del> +<li class="tocline"> +<a href="#devicelightevent-interface" class="tocxref"> +<span class="secno"> +<del class="diff-old">6.1 +</del> +<ins class="diff-chg">5.2 +</ins> +</span> +<span class="formerLink"> +<code> +<del class="diff-old">LightLevelEvent +</del> +<ins class="diff-chg">DeviceLightEvent +</ins> +</code> +</span> +Interface +</a> +<ul class="toc"> +<li class="tocline"> +<a href="#event-handlers" class="tocxref"> +<span class="secno"> +<del class="diff-old">6.1.1 +</del> +<ins class="diff-chg">5.2.1 +</ins> +</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"> +<ins class="diff-new">B.2 +</ins></span><ins class="diff-new"> +Informative +references +</ins></a></li> +</ul> +</li> +</ul> +</section> +<section class="informative" id="introduction"> +<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> +<del class="diff-old">This +specification +defines +events +that +provide +information +about +the +ambient +light +level, +as +measured +by +a +device's +light +sensor. +A +LightLevelEvent +describes +the +light +level +as +one +of +three +simple +categories +- +"dim", +"normal", +and +"bright" +- +while +a +</del> +<ins class="diff-chg">The +</ins> +<a href="#idl-def-DeviceLightEvent" class="idlType"> +<code> +DeviceLightEvent +</code> +</a> +<ins class="diff-new">interface +</ins> +provides +<del class="diff-old">a +more +granular +answer +</del> +<ins class="diff-chg">information +about +the +ambient +light +levels, +as +detected +</ins> +by +<del class="diff-old">describing +</del> +the +<ins class="diff-new">device's +</ins> +light +<del class="diff-old">level +</del> +<ins class="diff-chg">detector, +</ins> +in +terms +of +lux +units. +</p> +<p> +<ins class="diff-new">The +</ins><a href="http://dev.w3.org/csswg/mediaqueries4/#light-level"><ins class="diff-new"> +'light-level' +media +feature +</ins></a><ins class="diff-new"> +[ +</ins><cite><a class="bibref" href="#bib-mediaqueries4"><ins class="diff-new"> +mediaqueries4 +</ins></a></cite><ins class="diff-new"> +] +provides +more +granular, +less +precise, +information +about +the +ambient +light +level. +</ins></p> +</section> +<section id="conformance" typeof="bibo:Chapter" resource="#conformance" rel="bibo:Chapter"> +<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"> +<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> +<del class="diff-old">The +current +light +level +state +represents +the +ambient +light +level +around +the +hosting +device +as +a +human-readable +string. +</del> +</section> +<section class="informative" id="security-and-privacy-considerations"> +<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 +<del class="diff-old">only +using +the +less +precise +LightLevelState +of +'dim', +'normal', +and +'bright' +and +</del> +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 +<del class="diff-old">events +</del> +<ins class="diff-chg">event +</ins> +defined +in +this +specification +<del class="diff-old">are +</del> +<ins class="diff-chg">is +</ins> +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 +<del class="diff-old">these +events +</del> +<ins class="diff-chg">the +event +</ins> +on +the +active +tab, +and +not +on +the +background +tabs +or +within +iframes. +</p> +</section> +<section id="device-light"> +<h2 aria-level="1" role="heading" id="h2_device-light"> +<span class="secno"> +5. +</span> +Device +Light +</h2> +<del class="diff-old">The +</del> +<section id="extensions-to-window-interface"> +<h3 aria-level="2" role="heading" id="h3_extensions-to-window-interface"> +<span class="secno"> +<ins class="diff-chg">5.1 +</ins></span><ins class="diff-chg"> +Extensions +to +</ins><a href="#idl-def-Window" class="idlType"> +<code> +<del class="diff-old">DeviceLightEvent +</del> +<ins class="diff-chg">Window +</ins> +</code> +</a> +<del class="diff-old">interface +provides +information +about +the +ambient +light +levels, +as +detected +by +the +device's +light +detector, +in +terms +of +lux +units. +</del> +<ins class="diff-chg">Interface +</ins></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"> +<del class="diff-old">5.1 +</del> +<ins class="diff-chg">5.2 +</ins> +</span> +<a href="#idl-def-DeviceLightEvent" class="idlType"> +<code> +DeviceLightEvent +</code> +</a> +Interface +</h3> +<pre class="idl"> +<del class="diff-old"> { +</del> +<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>] +<del class="diff-old">interface { +</del> +<ins class="diff-chg">interface <span class="idlInterfaceID">DeviceLightEvent</span> : <span class="idlSuperclass">Event</span> { +</ins><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"> +<del class="diff-old">5.1.1 +</del> +<ins class="diff-chg">5.2.1 +</ins> +</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> +<del class="diff-old">6. +Light +Level +The +LightLevelEvent +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". +The +HTML5 +specification +[ +HTML5 +] +defines +a +Window +interface, +which +this +specification +extends: + { +}; +The +onlightlevel +event +handler +and +its +corresponding +event +handler +event +type +lightlevel +MUST +be +supported +as +an +IDL +attribute +by +all +objects +implementing +the +Window +interface. +6.1 +LightLevelEvent +Interface + { + "", + "", + "", + "" +}; { +};] +interface { +}; +The +value +attribute +of +the +LightLevelEvent +interface +MUST +return +the +value +it +was +initialized +to. +When +the +object +is +created, +this +attribute +MUST +be +initialized +to +an +empty +string +. +It +represents +the +current +light +level +state +. +When +a +user +agent +is +required +to +fire +a +light +level +event +, +the +user +agent +MUST +run +the +following +steps: +Create +an +event +that +uses +the +LightLevelEvent +interface, +with +the +name +lightlevel +, +which +bubbles, +is +not +cancelable, +and +has +no +default +action, +that +also +meets +the +following +conditions: +If +the +implementation +is +unable +to +report +the +current +light +level +state +, +initialize +the +value +attribute +to +an +empty +string +, +otherwise +initialize +the +attribute +to +the +current +light +level +state +, +which +MUST +be +one +of +the +following +values: +dim +normal +bright +Note +The +lux +ranges +that +map +to +the +current +light +level +state +s +are +left +to +the +implementation, +as +devices +with +different +sensitivities +could +map +them +slightly +differently. +However, +it +is +recommended +that +" +dim +" +correspond +to +ambient +light +below +50 +lux +(dark +enough +that +the +light +produced +by +a +white +background +is +eye-straining +or +distracting), +" +normal +" +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 +" +bright +" +correspond +to +light +above +10000 +lux +(direct +sunlight, +or +similarly +bright +conditions +that +make +it +hard +to +see +things +that +aren't +high-contrast). +When +the +current +light +level +state +changes, +the +user +agent +MUST +queue +a +task +to +fire +a +user +proximity +event +at +the +top-level +browsing +context +'s +Window +object. +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. +6.1.1 +Event +handlers +The +following +are +the +event +handlers +(and +their +corresponding +event +handler +event +types +) +that +MUST +be +supported +as +attributes +by +the +Window +object: +event +handler +event +handler +event +type +onlightlevel +lightlevel +</del> +<section class="appendix" id="acknowledgements"> +<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"> +<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; +<del class="diff-old">Lachlan +Hunt; +Ms2ger. +</del> +<ins class="diff-chg">Ms2ger; +Alex +Russell; +Robin +Berjon. +</ins> +<a href="http://www.w3.org/TR/dom/"> +<cite> +<ins class="diff-new">W3C +</ins> +DOM4 +</cite> +</a>. +<del class="diff-old">6 +December +2012. +</del> +<ins class="diff-chg">8 +May +2014. +</ins> +W3C +<del class="diff-old">Working +Draft. +</del> +<ins class="diff-chg">Candidate +Recommendation. +</ins> +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>. +<del class="diff-old">6 +August +2013. +</del> +<ins class="diff-chg">29 +April +2014. +</ins> +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 +<del class="diff-old">Levels. +</del> +<ins class="diff-chg">Levels +</ins> +</cite> +</a>. +March +1997. +<del class="diff-old">Internet +RFC +2119. +</del> +<ins class="diff-chg">Best +Current +Practice. +</ins> +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"> +<ins class="diff-new">B.2 +</ins></span><ins class="diff-new"> +Informative +references +</ins></h3><dl class="bibliography" about=""><dt id="bib-mediaqueries4"><ins class="diff-new"> +[mediaqueries4] +</ins></dt><dd rel="dcterms:references"><ins class="diff-new"> +Florian +Rivoal; +Tab +Atkins +Jr.. +</ins><a href="http://dev.w3.org/csswg/mediaqueries4/"><cite><ins class="diff-new"> +Media +Queries +Level +4 +</ins></cite></a>.<ins class="diff-new"> +W3C +Editor's +Draft. +URL: +</ins><a href="http://dev.w3.org/csswg/mediaqueries4/"><ins class="diff-new"> +http://dev.w3.org/csswg/mediaqueries4/ +</ins> +</a> +</dd> +</dl> +</section> +</section> +</body> +</html> + diff -r e1adbc40c86a -r e7698057c562 light/Overview.html --- a/light/Overview.html Mon Jun 16 10:02:58 2014 +0300 +++ b/light/Overview.html Mon Jun 16 10:10:56 2014 +0300 @@ -493,7 +493,8 @@ since the <a href="http://www.w3.org/TR/2013/CR-ambient-light-20131001/"> <abbr title="World Wide Web Consortium">W3C</abbr> - Candidate Recommendation 01 October 2013</a>: + Candidate Recommendation 01 October 2013</a> + (<a href="LC2-diff.html">diff</a>): </p> <ul> <li> diff -r e1adbc40c86a -r e7698057c562 light/Overview.src.html --- a/light/Overview.src.html Mon Jun 16 10:02:58 2014 +0300 +++ b/light/Overview.src.html Mon Jun 16 10:10:56 2014 +0300 @@ -60,7 +60,8 @@ since the <a href="http://www.w3.org/TR/2013/CR-ambient-light-20131001/"> <abbr title="World Wide Web Consortium">W3C</abbr> - Candidate Recommendation 01 October 2013</a>: + Candidate Recommendation 01 October 2013</a> + (<a href="LC2-diff.html">diff</a>): </p> <ul> <li>
Received on Monday, 16 June 2014 07:14:22 UTC