Class: Liquid::Drop

Inherits:
Object
  • Object
show all
Defined in:
lib/liquid/drop.rb

Overview

A drop in liquid is a class which allows you to to export DOM like things to liquid Methods of drops are callable. The main use for liquid drops is the implement lazy loaded objects. If you would like to make data available to the web designers which you don’t want loaded unless needed then a drop is a great way to do that

Example:

class ProductDrop < Liquid::Drop

def top_sales
   Shop.current.products.find(:all, :order => 'sales', :limit => 10 )
end

end

tmpl = Liquid::Template.parse( ‘ for product in product.top_sales % product.name } %endfor% ’ ) tmpl.render(‘product’ => ProductDrop.new ) # will invoke top_sales query.

Your drop can either implement the methods sans any parameters or implement the before_method(name) method which is a catch all

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#context=(value) ⇒ Object (writeonly)

Sets the attribute context

Parameters:

  • value —

    the value to set the attribute context to.



23
24
25
 
# File 'lib/liquid/drop.rb', line 23

def context=(value)
  @context = value
end

Instance Method Details

#before_method(method) ⇒ Object

Catch all for the method



26
27
28
 
# File 'lib/liquid/drop.rb', line 26

def before_method(method)
  nil
end

#has_key?(name) ⇒ Boolean

Returns:

  • (Boolean) 


41
42
43
 
# File 'lib/liquid/drop.rb', line 41

def has_key?(name)
  true
end

#invoke_drop(method) ⇒ Object Also known as: []

called by liquid to invoke a drop



31
32
33
34
35
36
37
38
39
 
# File 'lib/liquid/drop.rb', line 31

def invoke_drop(method)
  # for backward compatibility with Ruby 1.8
  methods = self.class.public_instance_methods.map { |m| m.to_s }
  if methods.include?(method.to_s)
    send(method.to_sym)
  else
    before_method(method)
  end
end

#to_liquid ⇒ Object 



45
46
47
 
# File 'lib/liquid/drop.rb', line 45

def to_liquid
  self
end