---
title: Ambient Light Events
slug: orphaned/Web/API/Ambient_Light_Events
tags:
  - Ambiente de luz
  - Ambiente de luz API
  - Ambiente e luz HTML5 API
translation_of: Web/API/Ambient_Light_Events
original_slug: Web/API/Ambient_Light_Events
---
<div>Os eventos de luz ambiente são uma maneira útil de tornar uma página da Web ou uma aplicação consciente de qualquer alteração na intensidade da luz. Isso permite que eles reajam a tal mudança, por exemplo alterando o contraste de cores da interface do usuário (UI) ou alterando a exposição necessária para tirar uma foto.</div>

<div> </div>

<h2 id="Eventos_de_luz">Eventos de  luz</h2>

<p>Quando o sensor de luz de um dispositivo detecta uma mudança no nível de luz, ele notifica o navegador dessa alteração. Quando o navegador obtém tal notificação, ele dispara um evento <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceLightEvent">DeviceLightEvent </a>que fornece informações sobre a intensidade da luz exata.</p>

<p>Este evento pode ser capturado no nível do objeto da janela usando o método <a href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener">addEventListener </a>(usando o nome do evento <a href="https://developer.mozilla.org/en-US/docs/Web/Events/devicelight">devicelight</a>) ou anexando um manipulador de eventos à propriedade <a href="https://developer.mozilla.org/en-US/docs/Web/API/Window/ondevicelight">window.ondevicelight</a>.</p>

<p>Uma vez capturado, o objeto de evento dá acesso à intensidade da luz expressa em <a href="http://en.wikipedia.org/wiki/Lux">lux </a>através da propriedade <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceLightEvent/value">DeviceLightEvent.value</a>.</p>

<h2 id="Exemplo">Exemplo</h2>

<pre class="brush: js">window.addEventListener('devicelight', function(event) {
  var html = document.getElementsByTagName('html')[0];

  if (event.value &lt; 50) {
    html.classList.add('darklight');
    html.classList.remove('brightlight');
  } else {
    html.classList.add('brightlight');
    html.classList.remove('darklight');
  }
});</pre>

<h2 id="Especificações">Especificações</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Estatus</th>
   <th scope="col">Comentário</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><a href="https://w3c.github.io/ambient-light/">Sensor de luz ambiente A definição de "Ambient Light Events" nessa especificação</a>.</td>
   <td>
    <p>Rascunho do Editor</p>
   </td>
   <td>Definição inicial</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilidade_do_navegador">Compatibilidade do navegador</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>{{domxref("DeviceLightEvent")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatGeckoDesktop("22.0")}}<sup>[1]</sup></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Chrome for Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>{{domxref("DeviceLightEvent")}}</td>
   <td>{{CompatNo}}</td>
   <td>support</td>
   <td>{{CompatGeckoMobile("15.0")}}<sup>[1]</sup></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] O evento "<a href="https://developer.mozilla.org/en-US/docs/Web/Events/devicelight">devicelight</a>" é implementado e a preferência ativada por padrão no Firefox Mobile para Android (15.0) e no Firefox OS (B2G). Começando com Gecko 22.0 geckoRelease ("22.0"), uma implementação de desktop para Mac OS X também está disponível. O suporte para o Windows 7 está em andamento (veja <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=754199">bug (754199)</a>).</p>

<h2 id="Veja_também">Veja também</h2>

<ul>
 <li><a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceLightEvent">DeviceLightEvent</a></li>
 <li><a href="https://developer.mozilla.org/en-US/docs/Web/Events/devicelight">event("devicelight")</a></li>
</ul>