lazyload-rails 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9bea9d89fb6ecb8a0218753ab51a6a6aa39e31a613b9c943c8562957c3fbb28a
-  data.tar.gz: 7cda2a364ee6b450965eacba99085a670b4e0f0f09d51e6c7003657903c65e18
+  metadata.gz: 33d389cb78112e751d38adcc205bb19d234aa3b0c0c846c599f681473ca22659
+  data.tar.gz: f99fb92895fffc33bac83c651115e255c39cba145048fab053f9b94244fbab85
 SHA512:
-  metadata.gz: da29205ffe57d1de0eabc3ebf82cadff46484306fea78046ee6089912bd13dc1b17de9c37399d44c54049476c7e51596652e9da037bec2e8a8271dedf10f1e13
-  data.tar.gz: 75ad188919cb37d8297d0b898687f4332177a152600183839cd6d928dc41a85baaeee2bc58222f5d884fddcf8f5008c4618fd98f6a27087512f005f8bd493452
+  metadata.gz: ef51c77c1e513d95e72e1be6042b5dfde4e3992cc01363bb006cfbd27da1061fbc699d5f6dbc40e63f4e5146f26ab5772e44114fb977d5d8de033e9f44545bb2
+  data.tar.gz: 5e2d800ea43a8120dfe08e1d74bf3e02e1d4aa60b79c308e91965c979ae7451bcdab8c880cab903958c33a9a7cbd67b110938e3ac6cac493104afa0f56d1e019

data/README.md

@@ -18,18 +18,32 @@ See [example](http://backbonejs.org/#examples) (scroll down to see images load)
 ### Features
 
 * Add `lazy: true` option to Rails `image_tag` helpers to render lazyload-friendly img tags.
+* Global config available to make them lazy by default.
 * Simple (really). That's pretty much it.
 
 ### Example
 
 ```erb
-<%= image_tag "kittenz.png", alt: "OMG a cat!", lazy: true %>
+<%= image_tag "kittenz.png", lazy: true %>
+```
+
+or
+
+```ruby
+# config/initializers/lazyload.rb
+Lazyload::Rails.configure do |config|
+  config.lazy_by_default = true
+end
+```
+```erb
+<%= image_tag "kittenz.png" %>
 ```
 
 Equals:
 
 ```html
-<img alt="OMG a cat!" data-original="/images/kittenz.png" src="http://www.appelsiini.net/projects/lazyload/img/grey.gif">
+<img src="data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs="
+     data-original="/images/kittenz.png" />
 ```
 
 **PRO TIP!** You must set image dimensions either as width and height attributes or in CSS. Otherwise plugin might not work properly.
@@ -57,12 +71,16 @@ Lazy Load can be customized, [see more options](http://www.appelsiini.net/projec
 
 ## Configuration
 
-By default, a 1x1 grey gif is used as placeholder (from [http://appelsiini.net/projects/lazyload/img/grey.gif](http://www.appelsiini.net/projects/lazyload/img/grey.gif)). This can be easily customized:
-
 ```ruby
 # config/initializers/lazyload.rb
 Lazyload::Rails.configure do |config|
+  # By default, a 1x1 grey gif is used as placeholder ("data:image/gif;base64,...").
+  # This can be easily customized:
   config.placeholder = "/public/img/grey.gif"
+
+  # image_tag can return lazyload-friendly images by default,
+  # no need to pass the { lazy: true } option
+  config.lazy_by_default = true
 end
 ```
 

data/lib/lazyload-rails.rb

@@ -37,8 +37,10 @@ ActionView::Helpers::AssetTagHelper.module_eval do
     options, args = extract_options_and_args(*attrs)
     image_html = rails_image_tag(*args)
 
-    if options[:lazy]
-      to_lazy_image(image_html)
+    is_lazy = options.fetch(:lazy) { Lazyload::Rails.configuration.lazy_by_default }
+
+    if is_lazy
+      to_lazy(image_html)
     else
       image_html
     end
@@ -46,7 +48,7 @@ ActionView::Helpers::AssetTagHelper.module_eval do
 
   private
 
-  def to_lazy_image(image_html)
+  def to_lazy(image_html)
     img = Nokogiri::HTML::DocumentFragment.parse(image_html).at_css("img")
 
     img["data-original"] = img["src"]

data/lib/lazyload-rails/config.rb

@@ -20,9 +20,18 @@ module Lazyload
         @placeholder = new_placeholder
       end
 
+      # When set to true every image_tag will include { lazy: true } by default
+      def lazy_by_default=(lazy_by_default)
+        @lazy_by_default = !!lazy_by_default
+      end
+      def lazy_by_default
+        @lazy_by_default
+      end
+
       # Set default settings
       def initialize
         @placeholder = "data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs="
+        @lazy_by_default = false
       end
     end
   end

data/lib/lazyload-rails/version.rb

@@ -1,5 +1,5 @@
 module Lazyload
   module Rails
-    VERSION = "0.4.0"
+    VERSION = "0.5.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lazyload-rails
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Javier Trevino Saldana