Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

使用光線事件

這是一個實驗中的功能
此功能在某些瀏覽器尚在開發中,請參考兼容表格以得到不同瀏覽器用的前輟。

摘要

環境光源 (Ambient light) 事件,可告知 Apps 或網頁目前光線強度的變化,以利做出反應,例如改變使用者介面 (User Interface,UI) 的顏色對比,或在拍照時改變曝光程度

光源事件

只要裝置的光線感測器偵測到光線強度變化,隨即通知瀏覽器。一旦瀏覽器取得該通知,就會發出 DeviceLightEvent 事件而提供光線強度的確實資訊。

只要使用 addEventListener 函式 (使用 devicelight 事件名稱),或將事件處理器 (Event Handler) 附加至 window.ondevicelight 屬性,均可於 window 物件擷取到此事件。

一旦擷取完畢,則事件物件將透過 DeviceLightEvent.value 屬性,存取光線強度值 (以 Lux 為單位)。

範例

window.addEventListener('devicelight', function(event) {
  var html = document.getElementsByTagName('html')[0];

  if (event.value < 50) {
    html.classList.add('darklight');
    html.classList.remove('brightlight');
  } else {
    html.classList.add('brightlight');
    html.classList.remove('darklight');
  }
});

規格

Specification Status Comment
Ambient Light Events
The definition of 'Ambient Light Events' in that specification.
Candidate Recommendation Initial specification

瀏覽器相容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
DeviceLightEvent Not supported 22.0 (22.0) (Mac OS X only) Not supported Not supported Not supported
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
DeviceLightEvent Not supported Not supported 15.0 (15.0) Not supported Not supported Not supported

Gecko 說明

已建構 devicelight 事件,且在 Firefox Mobile for Android (15.0) 與 Firefox OS (B2G) 中均預設為開啟。從 Gecko 22.0 (Firefox 22.0 / Thunderbird 22.0 / SeaMonkey 2.19) 開始,亦提供 Mac OS X 的桌機支援。目前對 Windows 7 的支援功能仍開發中 (請見 bug 754199)。

另請參閱

文件標籤與貢獻者

 此頁面的貢獻者: teoli, MashKao
 最近更新: teoli,