Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.
This specification defines a means to receive events that correspond to a light sensor detecting the presence of a light.
This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at http://www.w3.org/TR/.
The functionality described in this specification was initially specified as part of the Sensor API 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.
This document was published by the Device APIs Working Group as a First Public Working Draft. This document is intended to become a W3C Recommendation. If you wish to make comments regarding this document, please send them to public-device-apis@w3.org (subscribe, archives). All feedback is welcome.
Publication as a Working Draft does not imply endorsement by the W3C 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.
This document was produced by a group operating under the 5 February 2004 W3C Patent Policy. W3C maintains a public list of any patent disclosures 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 Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
This section is non-normative.
The DeviceLightEvent interface provides web developers
information about the ambient light levels near the hosting.
This is achieved by interrogating a photosensors or similar detectors of a device.
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.
The key words must, must not, required, should, should not, recommended, may, and optional in this specification are to be interpreted as described in [RFC2119].
This specification defines conformance criteria that apply to a single product: the user agent that implements the interfaces that it contains.
The
EventHandler interface represents a callback function used for event
handlers as defined in [HTML5].
The concepts queue a task and fires a simple event are defined in [HTML5].
The terms event handlers and event handler event types are defined in [HTML5].
The concepts create an event and fire an event are defined in [DOM4].
The value device light is a value that represents the ambient light levels around the hosting device in lux units.
The HTML5 specification [HTML5] defines a Window interface,
which this specification extends:
partial interface Window {
attribute EventHandler ondevicelight;
};ondevicelight of type EventHandler
The ondevicelight event handler and its corresponding
event handler event type devicelight must be supported
as an IDL attribute by all objects implementing the Window
interface.
DeviceLightEvent Interface[Constructor (DOMString type, optional DeviceLightEventInit eventInitDict)]
interface DeviceLightEvent : Event {
readonly attribute double value;
};
dictionary DeviceLightEventInit : EventInit {
double value;
};value of type double, readonlyDeviceLightEventInit Membersvalue of type doubleWhen a user agent is required to fire a device light event, the user agent must run the following steps:
DeviceLightEvent
interface, with the name devicelight, which
bubbles, is not cancelable, and has no default action, that also
meets the following conditions:
value
attribute to positive Infinity, otherwise initialize the
attribute to the current device light.
Window object.
When the current light changes, the user agent must fire a device light event.
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 |
|---|---|
ondevicelight |
devicelight |
Doug Turner for the initial prototype and Marcos Caceres for the test suite.
No informative references.