jquelpers 0.0.1

data/CHANGELOG

@@ -0,0 +1,26 @@
+== 18-11-2010
+ Major Commit
+ * Support for Ajax in Tabs
+ * javascript is genarated by the helper, no need to add extra code in views.
+ * Add datepicker helper for the date picker provided in jQuery UI
+
+== 16-11-2010
+ * Prevent dom id overriding.
+	create() do's not require an id anymore.
+
+== 03-07-2009
+
+ * big change: removed the 2nd param for concat, rails no longer requires the binding be passed.
+ * added a helper for creating accordions
+
+== 09-04-2008
+
+ * big change: renamed classes, and helper 'tabs_for' now requires a block
+
+== 08-28-2008 
+ 
+ * added the ability to call TabsRenderer.new with a block parameter
+
+== 06-22-2008 initial import
+ 
+ * TabsRenderer added

data/Manifest

@@ -0,0 +1,8 @@
+CHANGELOG
+Manifest
+README.textile
+Rakefile
+lib/jquelpers.rb
+lib/jquelpers/accordion_helper.rb
+lib/jquelpers/datepicker_helper.rb
+lib/jquelpers/tabs_helper.rb

data/README.textile

@@ -0,0 +1,111 @@
+h1. What Is It?
+
+These are some view helpers I use in Rails to better integrate jQuery UI into my sites.
+
+I hope you find them useful.
+
+original work by CodeOfficer
+https://github.com/CodeOfficer/jquery-ui-rails-helpers
+
+h2. Warning !
+This fork is not anymore compatible with the original plugin.
+If you decide to use this fork, you will have to rewrite your apps (for the best !)
+
+
+h2. TabsHelper
+
+This helper simplifies the code required to use the jQuery UI Tab plugin.
+
+<pre><code>
+<% tabs_for :tabs_container :jquery => "collapsible = true" do |tab| %>
+	<% tab.create('Tab 1') do %>
+    # ... insert tab contents
+	<% end %>
+	<% tab.create('Tab 2', :ajax => any_path) do %>
+	<% end %>
+<% end %>
+</code></pre>
+
+The above will generate this HTML in your view: ( to be corrected with the new behaviours)
+
+<pre><code>
+<div id="tabs">
+  <ul>
+    <li><a href="#tabs_container_0"><span>Tab 1</span></a></li>
+    <li><a href="#tabs_container_1"><span>Tab 2</span></a></li>
+  </ul>
+  <div id="tabs_container_0">
+    # ... insert tab contents
+  </div>
+  <div id="tabs_container_1">
+    # ... insert tab contents
+  </div>
+</div>
+</code></pre>
+  
+Tabs will be rendered in the order you create them.
+
+You can easily render a tab conditionally by appending your condition to the end of 
+the 'create' block as such ... (Cancan gem in this exemple)
+
+<pre><code>
+<% tab.create('My Profile') do %>
+	# ... insert tab contents
+<% end can? :read, Profile %>
+</code></pre>
+
+You can pass HTML options or JQuery options to either the parent DIV or any individual tab's
+DIV (there is no JQuery options for each tab.) as you like ...
+
+<pre><code>
+<% tabs_for :tabs_container :jquery => "collapsible = true", :class => 'zippy' do |tab| %>
+	<% tab.create('Tab 1', :style => 'background: #FFF') do %>
+    # ... insert tab contents
+	<% end %>
+<% end %>
+</code></pre>
+<strike>
+The default DOM ID for the parent div is ... id="tabs" ... unless you pass in an HTML
+option with a different value. And you SHOULD pass an id.
+</strike>
+Dom id's are automaticaly genrated, but you can override them (I told you, you can pass html options)
+
+h2. AccordionsHelper
+
+This helper simplifies the code required to use JQuery UIs Accordion plugin.
+
+Usage is identical to the Tabs helper.
+
+<pre><code>
+<% accordions_for do |accordion| %>
+	<% accordion.create("accordion_title") do %>
+		# ... insert accordion contents
+	<% end %>
+<% end %>
+</code></pre>
+
+h2. DatepickerHelper
+
+This helper simplifies the code required to use JQuery UIs Datepicker plugin.
+
+Usage is identical to others helpers.
+
+<pre><code>
+<% form_for do |f| %>
+	<% f.datepicker :date, :jquery => "any option" %>
+<% end %>
+</code></pre>
+
+or outside a form_for :
+<pre><code>
+	<% datepicker_tag :object_name, :date, :jquery => "any option" %>
+</code></pre>
+
+h2. Todo.
+h3. Gemification (will come soon)
+h3. I18n the DatepickerHelper
+h3. Autoload Jquery and Jquery UI
+h3. write documentation
+h3. Write tests (if some body explain me why and how)
+h3. Other helpers (Autocompletion will come, ... any idea ?)
+

data/Rakefile

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('jquelpers') do |p|
+  p.description    = "Provide Rails helpers for jquery-UI plugins"
+  p.url            = "http://github.com/elmatou/jquery-ui-rails-helpers/"
+  p.author         = "El Matou"
+  p.email          = "elmatou@gmail.com"
+  p.version        = "0.0.1"
+  p.changes        = "First release (testing)"
+  p.development_dependencies = []
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/jquelpers.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{jquelpers}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["El Matou"]
+  s.date = %q{2010-11-19}
+  s.description = %q{Provide Rails helpers for jquery-UI plugins}
+  s.email = %q{elmatou@gmail.com}
+  s.extra_rdoc_files = ["CHANGELOG", "README.textile", "lib/jquelpers.rb", "lib/jquelpers/accordion_helper.rb", "lib/jquelpers/datepicker_helper.rb", "lib/jquelpers/tabs_helper.rb"]
+  s.files = ["CHANGELOG", "Manifest", "README.textile", "Rakefile", "lib/jquelpers.rb", "lib/jquelpers/accordion_helper.rb", "lib/jquelpers/datepicker_helper.rb", "lib/jquelpers/tabs_helper.rb", "jquelpers.gemspec"]
+  s.homepage = %q{http://github.com/elmatou/jquery-ui-rails-helpers/}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Jquelpers", "--main", "README.textile"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{jquelpers}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Provide Rails helpers for jquery-UI plugins}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/jquelpers/accordion_helper.rb

@@ -0,0 +1,56 @@
+module AccordionHelper
+  
+  def accordion_for(method, options ={}, &block )
+    raise ArgumentError, "Missing block" unless block_given?
+    
+    options = {:id => method.to_s }.merge!(options)
+    concat javascript_tag "$(document).ready(function() {$(\"##{options[:id]}\").accordion({#{options.delete(:jquery)}}); });"
+    concat AccordionHelper::AccordionRenderer.new( options, &block ).render
+  end
+  
+  class AccordionRenderer
+    
+    def initialize( options={}, &block )
+      raise ArgumentError, "Missing block" unless block_given?
+
+      @template = eval( 'self', block.binding )
+      @options = options
+      @accordions = []
+
+      yield self
+    end
+    
+    def create( accordion_text, options={}, &block )
+      raise "Block needed for AccordionsRenderer#CREATE" unless block_given?
+      @accordions << [ @options[:id].to_s + "_" + @accordions.count.to_s, accordion_text, options, block ]
+    end
+    
+    def render      
+      content_tag :div, { :id => :accordions }.merge( @options ) do
+        @accordions.collect do |accordion|
+          accordion_head(accordion) + accordion_body(accordion)
+        end.join
+      end
+    end
+    
+    private #  ---------------------------------------------------------------------------
+    
+    def accordion_head(accordion)
+      content_tag :h3, :id => accordion[0] do
+        link_to accordion[1], '#'
+      end
+    end
+    
+    def accordion_body(accordion)
+      content_tag :div do
+        capture( &accordion[3] )
+      end
+    end
+    
+    def method_missing( *args, &block )
+      @template.send( *args, &block )
+    end
+    
+  end
+
+end

data/lib/jquelpers/datepicker_helper.rb

@@ -0,0 +1,17 @@
+module DatepickerHelper
+  def datepicker_tag(object, method, options = {})
+    jquery = options.delete(:jquery)
+    concat text_field(object.class.name.downcase, method, options)
+    javascript_tag "$(document).ready(function() {$(#{object.class.name.downcase}_#{method.to_s}).datepicker({#{jquery}}); });"
+  end
+end
+
+module ActionView
+  module Helpers
+    class FormBuilder
+      def datepicker(method, options = {})
+        @template.datepicker_tag(@object, method, options.merge(:object => @object))
+      end
+    end
+  end
+end

data/lib/jquelpers/tabs_helper.rb

@@ -0,0 +1,55 @@
+module TabsHelper
+  
+  def tabs_for(method, options = {}, &block )
+    raise ArgumentError, "Missing block" unless block_given?
+    
+    options = {:id => method.to_s }.merge!(options)
+    concat javascript_tag "$(document).ready(function() {$(\"##{options[:id]}\").tabs({#{options.delete(:jquery)}}); });"
+    concat TabsHelper::TabsRenderer.new(options, &block ).render
+  end
+  
+  class TabsRenderer
+    
+    def initialize( options={}, &block )
+      raise ArgumentError, "Missing block" unless block_given?
+
+      @template = eval( 'self', block.binding )
+      @options = options
+      @tabs = []
+
+      yield self
+    end
+    
+    def create( title, options={}, &block )
+      raise "Block needed for TabsRenderer#CREATE" unless block_given?
+      ajax = options.delete(:ajax)
+      @tabs << [ @options[:id].to_s + "_" + @tabs.count.to_s, title, options, block, ajax ]
+    end
+    
+    def render
+      content_tag( :div, [render_tabs, render_bodies], { :id => @options[:id] })
+    end
+    
+    private #  ---------------------------------------------------------------------------
+    
+    def render_tabs
+      content_tag :ul do
+        @tabs.collect do |tab|
+          content_tag( :li, link_to( content_tag( :span, tab[1] ), tab[4] || "##{tab[0]}" ) )
+        end.join
+      end
+    end
+    
+    def  render_bodies
+      @tabs.collect do |tab| 
+        content_tag( :div, capture( &tab[3] ), tab[2].merge( :id => tab[0] ) ) 
+      end.join.to_s
+    end
+    
+    def method_missing( *args, &block )
+      @template.send( *args, &block )
+    end
+    
+  end
+
+end

data/lib/jquelpers.rb

@@ -0,0 +1,4 @@
+require 'jquelpers/accordion_helper'
+require 'jquelpers/tabs_helper'
+require 'jquelpers/datepicker_helper'
+

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: jquelpers
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- El Matou
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-19 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: Provide Rails helpers for jquery-UI plugins
+email: elmatou@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- README.textile
+- lib/jquelpers.rb
+- lib/jquelpers/accordion_helper.rb
+- lib/jquelpers/datepicker_helper.rb
+- lib/jquelpers/tabs_helper.rb
+files: 
+- CHANGELOG
+- Manifest
+- README.textile
+- Rakefile
+- lib/jquelpers.rb
+- lib/jquelpers/accordion_helper.rb
+- lib/jquelpers/datepicker_helper.rb
+- lib/jquelpers/tabs_helper.rb
+- jquelpers.gemspec
+has_rdoc: true
+homepage: http://github.com/elmatou/jquery-ui-rails-helpers/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Jquelpers
+- --main
+- README.textile
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 11
+      segments: 
+      - 1
+      - 2
+      version: "1.2"
+requirements: []
+
+rubyforge_project: jquelpers
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Provide Rails helpers for jquery-UI plugins
+test_files: []
+