Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
cordova plugin for disabling screen dimming
Java Objective-C JavaScript
Branch: master
Failed to load latest commit information.
src android support
www initial commit with iOS support
README.md comment in example code
plugin.xml 1.0.0 release

README.md

ScreenDim

PhoneGap/Cordova plugin for enabling/disabling screen dim

Usage

<script src="cordova.js"></script>
<script src="screendim.js"></script>
<script>
    // turn off the default screen dimming
    document.getElementById('turnoff').addEventListener('touchstart', function (e) {
        cordova.screenDim.disable();
    });

    // turn it back on
    document.getElementById('turnon').addEventListener('touchstart', function (e) {
        cordova.screenDim.enable();
    });

    // toggle it
    document.getElementById('toggle').addEventListener('touchstart', function (e) {
        cordova.screenDim.toggle();
    });
</script>

Installation

Use pluginstall - https://github.com/alunny/pluginstall

What/Why

Mobile devices typically have an idle timer - a time limit when the screen will start to dim to conserve power.

By default this is a good thing - you don't want any old app keeping your screen on and killing your power. However, in certain cases you may want to disable this dimmer - for example, if you have a chess game where the user would be expected to think about her move, without touching the screen, for some extended period of time.

This plugin should be used for that purpose - disable the screen dimmer for some part of your app, and enable it again once you're done.

Supported Platforms

  • iOS
  • Android

LICENSE

MIT

Something went wrong with that request. Please try again.