visibilityjs 0.3 → 0.4

data/ChangeLog

@@ -1,3 +1,6 @@
+== 0.4 (Vanguard 1, alternative)
+* Add fallback API support by focus/blur hack to all browsers.
+
 == 0.3 (Explorer 1, answer)
 * Rename gem to visibilityjs.
 * Fix gem integration with Asset Pipeline paths.

data/README.md

@@ -21,8 +21,19 @@ actually supported in the browser as, if it does not, the library will just
 assume that the page is visible all the time, and your logic will still work
 correctly, albeit less effective in some cases.
 
+Page Visibility API is natively supported by Google Chrome and IE 10. You can
+add support to Firefox 5 by [MozVisibility] hack (include it before
+Visibility.js). For others browsers you can use `lib/visibility.fallback.js`
+with focus/blur hack (note that this hack have some issue,
+see falllback documentation).
+
 [Page Visibility API]: http://www.w3.org/TR/2011/WD-page-visibility-20110602/
-[prerendering]: http://code.google.com/chrome/whitepapers/prerender.html
+[prerendering]:        http://code.google.com/chrome/whitepapers/prerender.html
+[MozVisibility]:       https://github.com/private-face/mozvisibility
+
+## Translations
+
+Документация на русском: <http://habrahabr.ru/blogs/javascript/125833/>
 
 ## States
 
@@ -77,7 +88,7 @@ function. It cannot be passed to `clearInterval`, through, and you should use
 `Visibility.stop(id)` to stop the timer.
 
 ```js
-slideshow = Visibility.every(5 * 1000, function () {
+var slideshow = Visibility.every(5 * 1000, function () {
     nextSlide();
 });
 
@@ -237,6 +248,11 @@ If you don’t use Rails 3.1 or assets packaging manager you can use an already
 minified version of the library, located in repository as
 `lib/visibility.min.js`.
 
+## Alternatives
+
+If you need smaller and simpler wrapper (for example, just to hide vendor
+prefixes), you can use [visibly.js](https://github.com/addyosmani/visibly.js).
+
 ## Contributing
 
 To run project tests and minimize source you’ll need to have Ruby and Bundler

data/vendor/assets/javascripts/visibility.fallback.js

@@ -0,0 +1,75 @@
+/*
+ * Copyright 2011 Andrey “A.I.” Sitnik <andrey@sitnik.ru>,
+ * sponsored by Evil Martians.
+ * 
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+// Add Page Visibility API support to old browsers by focus/blur hack.
+//
+// Include this script _before_ Visibility.js.
+//
+// Note, that this hack doesn’t correctly emulate Page Visibility API:
+// when user change focus from browser to another window (browser and your
+// page may stay visible), this hack will decide, that you page is hidden.
+//
+// For Firefox 5 it will be better to use MozVisibility hack without this issue.
+// See <https://github.com/private-face/mozvisibility>.
+;(function() {
+    "use strict";
+
+    if ( document.visibilityState   || document.webkitVisibilityState ||
+         document.msVisibilityState || document.mozVisibilityState    ||
+         document.oVisibilityState ) {
+         return;
+    }
+
+    document.hidden = false;
+    document.visibilityState = 'visible';
+
+    var event = null
+    var i = 0
+    var fireEvent = function () {
+        if( document.createEvent ) {
+            if ( !event ) {
+                event = document.createEvent('HTMLEvents');
+                event.initEvent('visibilitychange', true, true);
+            }
+            document.dispatchEvent(event);
+        } else {
+            if ( typeof(Visibility) == 'object' ) {
+                Visibility._onVisibilityChange.call(Visibility, { })
+            }
+        }
+    }
+
+    var onfocus = function () {
+        document.hidden = false;
+        document.visibilityState = 'visible';
+        fireEvent();
+    };
+    var onblur  = function () {
+        document.hidden = true;
+        document.visibilityState = 'hidden';
+        fireEvent();
+    }
+
+    if ( document.addEventListener ) {
+        window.addEventListener('focus', onfocus, true);
+        window.addEventListener('blur',  onblur,  true);
+    } else {
+        document.attachEvent('onfocusin',  onfocus);
+        document.attachEvent('onfocusout', onblur);
+    }
+})();

data/vendor/assets/javascripts/visibility.js

@@ -147,9 +147,14 @@
                 return;
             }
             var event = this._prefix() + 'visibilitychange';
-            this._doc.addEventListener(event, function () {
+            var listener = function () {
                 Visibility._onVisibilityChange.apply(Visibility, arguments);
-            }, false);
+            };
+            if ( this._doc.addEventListener ) {
+                this._doc.addEventListener(event, listener, false);
+            } else {
+                this._doc.attachEvent(event, listener);
+            }
             this._listening = true;
             this._hiddenBefore = this.hidden();
         },

metadata

@@ -1,12 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: visibilityjs
 version: !ruby/object:Gem::Version 
-  hash: 13
+  hash: 3
   prerelease: false
   segments: 
   - 0
-  - 3
-  version: "0.3"
+  - 4
+  version: "0.4"
 platform: ruby
 authors: 
 - "Andrey \xE2\x80\x9CA.I.\xE2\x80\x9D Sitnik"
@@ -14,11 +14,10 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-31 00:00:00 +04:00
+date: 2011-09-11 00:00:00 +04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  prerelease: false
   version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -35,6 +34,7 @@ dependencies:
   requirement: *id001
   type: :runtime
   name: sprockets
+  prerelease: false
 description: Visibility.js allow you to determine whether your web page is visible to an user, is hidden in background tab or is prerendering. It allows you use the page visibility state in JavaScript logic and improve browser performance or improve user interface experience.
 email: 
 - andrey@sitnik.ru
@@ -48,6 +48,7 @@ extra_rdoc_files:
 - ChangeLog
 files: 
 - vendor/assets/javascripts/visibility.js
+- vendor/assets/javascripts/visibility.fallback.js
 - lib/visibilityjs.rb
 - LICENSE
 - README.md