Contents

# Various helpers available for use in your view
module Lightbox2Helpers::FormHelpers

  # Similar to link_to, but tweaked so it uses lightbox2
  #
  # == Signatures
  #
  #   link_to_lightbox2(name, options = {}, html_options = nil)
  #   link_to_libhgbox2(options = {}, html_options = nil) do
  #     # name
  #   end
  #
  # == Options
  # link_to_lightbox uses link_to internally, so it should accept all parameters accepted by link_to. Plus two new ones. 
  #
  # === :title
  # Used as a caption on the picture's image. Can be left blank.
  #
  #   <%= link_to_lightbox2 "Show the picture", "/images/picture.jpg", :title => "a nice picture" %>
  #
  # === :group
  # It will be possible to iterate over links of the same "group" (with "next", "previous" links)
  #
  #   <%= link_to_lightbox2(:group => "avatars") do %>
  #     This is also part of the link <%= image_tag "picture.jpg">
  #   <% end %> 
  #
  # == Warning about html_options :rel
  # * link_to_lightbox2 will override :rel if you use it as a parameter on html_options.
  def link_to_lightbox2(*args, &block)
    if block_given?
      options      = args.first || {}
      html_options = args.second || {}
    else
      name         = args.first
      options      = args.second || {}
      html_options = args.third || {}
    end
    
    if options.is_a? Hash and options.include? :group
      html_options[:rel] = "lightbox[#{options[:group]}]"
      options.delete :group
    elsif html_options.is_a? Hash and html_options.include? :group
      html_options[:rel] = "lightbox[#{html_options[:group]}]"
      html_options.delete :group
    else
      html_options[:rel] = "lightbox"
    end
    
    if options.is_a? Hash and options.include? :title
      html_options[:title] = options[:title]
      options.delete :title
    end
    
    if block_given?
      concat link_to(capture(&block), options, html_options)
    else
      link_to(name, options, html_options)
    end
  end

end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
splendeo-lightbox2_helpers-0.6.1	lib/lightbox2_helpers/form_helpers.rb
splendeo-lightbox2_helpers-0.6.2	lib/lightbox2_helpers/form_helpers.rb