twitter_bootstrap_combo 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in twitter_bootstrap_combo.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Romain Tartière
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,51 @@
+# TwitterBootstrapCombo
+
+Advanced combo-box using Twitter-Bootstrap
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'twitter_bootstrap_combo'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install twitter_bootstrap_combo
+
+## Usage
+
+Add this line to `app/assets/javascripts/application.js`:
+
+~~~js
+//= twitter_bootstrap_combo
+~~~
+
+Then in your views, use:
+
+~~~erb
+<%= combo_box(:calendar, :parent_id, Calendar.all.collect { |c| [ (content_tag(:i, "", :class => "icon-angle-right") * c.level + c.name).html_safe, c.id ] }, :include_blank => true) %>
+~~~
+
+to produce:
+
+~~~html
+<input id="calendar_parent_id" name="calendar[parent_id]" type="hidden" value="6" /><div class="btn-group"><a href="#" class="btn dropdown-toggle" data-toggle="dropdown"><span class="combo_box_text">Child 1</span> <i class="icon-caret-down"></i></a><ul class="dropdown-menu" data-for="calendar_parent_id"><li class=""><a href="#" class="combo_box_item">(None)</a></li><li class=""><a href="#" class="combo_box_item" data-value="5">Root</a></li><li class="active"><a href="#" class="combo_box_item" data-value="6"><i class="icon-angle-right"></i>Child 1</a></li><li class=""><a href="#" class="combo_box_item" data-value="8"><i class="icon-angle-right"></i><i class="icon-angle-right"></i>SubChild 1</a></li><li class=""><a href="#" class="combo_box_item" data-value="9"><i class="icon-angle-right"></i><i class="icon-angle-right"></i>SubChild 2</a></li><li class=""><a href="#" class="combo_box_item" data-value="7"><i class="icon-angle-right"></i>Child 2</a></li></ul></div>
+~~~
+
+which render like this:
+
+![combo-closed](http://img11.hostingpics.net/pics/892421comboboxclosed.png)
+
+![combo-opened](http://img11.hostingpics.net/pics/781716comboboxopened.png)
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/twitter_bootstrap_combo.rb

@@ -0,0 +1,11 @@
+require "rails"
+
+module TwitterBootstrapCombo
+  module Rails
+    if ::Rails.version < "3.1"
+      require 'twitter_bootstrap_combo/railties'
+    else
+      require 'twitter_bootstrap_combo/engine'
+    end
+  end
+end

data/lib/twitter_bootstrap_combo/engine.rb

@@ -0,0 +1,11 @@
+require "twitter_bootstrap_combo/view_helpers"
+
+module TwitterBootstrapCombo
+  module Rails
+    class Engine < ::Rails::Engine
+      initializer "twitter_bootstrap_combo" do |app|
+        ActionView::Base.send :include, TwitterBootstrapCombo::ViewHelpers
+      end
+    end
+  end
+end

data/lib/twitter_bootstrap_combo/railtie.rb

@@ -0,0 +1,9 @@
+require "twitter_bootstrap_combo/view_helpers"
+
+module TwitterBootstrapCombo
+  class Railtie < Rails::Railtie
+    initializer "twitter_bootstrap_combo" do |app|
+      ActionView::Base.send :include, ViewHelpers
+    end
+  end
+end

data/lib/twitter_bootstrap_combo/version.rb

@@ -0,0 +1,3 @@
+module TwitterBootstrapCombo
+  VERSION = "0.0.1"
+end

data/lib/twitter_bootstrap_combo/view_helpers.rb

@@ -0,0 +1,89 @@
+module TwitterBootstrapCombo
+  module ViewHelpers
+    # Accepts a container and return a string of combo_box items. If +selected+
+    # is specified, the corresponding item is marked as active.
+    def options_for_combo_box(container, selected = nil)
+      return container if String === container
+
+      container.map do |element|
+        if Array === element then
+          text, value = element
+        else
+          text, value = element, element
+        end
+        css_class = []
+        if selected == value then
+          css_class << "active"
+        end
+        content_tag(:li, :class => css_class.join(" ")) do
+          link_to(text, '#', :class => "combo_box_item", :data => { :value => value })
+        end
+      end.join().html_safe
+    end
+
+    # Returns a string of combo_box items that have been compiled by iterating
+    # over the +collection+ and assigning the result of the call to the
+    # +value_method+ as the item value and the +text_method+ as the item text.
+    # If +selected+ is specified, the item with the corresponding value is
+    # marked as selected.
+    def options_from_collection_for_combo_box(collection, value_method, text_method, selected = nil)
+      options = collection.map do |element|
+        [ element.send(text_method), element.send(value_method) ]
+      end
+
+      options_for_combo_box(options, selected)
+    end
+
+    # Returns a complete Twitter Bootstrap widget tailored for accessing a
+    # specified attribute (identified by +method+) on an object assigned to the
+    # template (identified by +object+) using a Twitter Bootstrap menu with
+    # +choices+. Additional options can be passed as a hash with +options+ and
+    # +html_options+.
+    #
+    # Supported +options+:
+    # - <tt>:include_blank</tt> - If set to true, an empty option will be created.
+    #
+    # Supported +html_options+:
+    # - None yet
+    #
+    # Examples:
+    #   combo_box(:event, :calendar_id, [ [ "Calendar 1", 1 ], [ "Calendar 2", 2] ])
+    #
+    #   container(:event, :calendar_id, options_from_collection_for_combo_box(Calendar.all, :id, :name, @event.calendar_id), :include_blank => true)
+    def combo_box(object, method, choices, options = {}, html_options = {})
+      current_value = self.instance_variable_get("@#{object}").instance_variable_get("@attributes")[method.to_s].to_i
+
+      current_text = "(None)"
+      if Array === choices then
+        if ! Array === choices[0] then
+          current_text = current_value
+        else
+          choices.each do |element|
+            if current_value == element[1] then
+              current_text = element[0]
+            end
+          end
+        end
+      end
+
+      hidden_field(object, method) +
+      content_tag(:div, :class => "btn-group") do
+        link_to(content_tag(:span, strip_tags(current_text), :class => "combo_box_text") + " " + content_tag(:i, "", :class => "icon-caret-down"), "#", :class => "btn dropdown-toggle", :data => { :toggle => "dropdown" }) +
+        content_tag(:ul, :class => "dropdown-menu", :data => { :for => "#{object}_#{method}" }) do
+          if options[:include_blank] then
+            css_class = []
+            if current_value == 0 then
+              css_class << "active"
+            end
+            content_tag(:li, :class => css_class.join(" ")) do
+              link_to("(None)", '#', :class => "combo_box_item")
+            end
+          else
+            "".html_safe
+          end +
+          options_for_combo_box(choices, current_value)
+        end
+      end
+    end
+  end
+end

data/twitter_bootstrap_combo.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'twitter_bootstrap_combo/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "twitter_bootstrap_combo"
+  gem.version       = TwitterBootstrapCombo::VERSION
+  gem.authors       = ["Romain Tartiere"]
+  gem.email         = ["romain@blogreen.org"]
+  gem.description   = %q{Advanced combo-box using Twitter-Bootstrap}
+  gem.summary       = %q{twitter_bootstrap_combo workarounds limitation of SELECT tags in Rails application and provide a coherent look & feel through Twitter-Bootstraped applications.}
+  gem.homepage      = "https://github.com/smortex/twitter_bootstrap_combo"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

data/vendor/assets/javascripts/twitter_bootstrap_combo.js.coffee

@@ -0,0 +1,11 @@
+jQuery ->
+  $(".combo_box_text").each( ->
+    $(this).text($(this).closest("div.btn-group").find("ul").find("li.active").text())
+  )
+  $('a.combo_box_item').click( ->
+    $("#" + $(this).parent("li").parent("ul").attr("data-for")).val($(this).attr("data-value"))
+    $(this).closest(".btn-group").find(".combo_box_text").text($(this).text())
+    $('a.combo_box_item').parent("li").removeClass("active")
+    $(this).parent("li").addClass("active")
+    true
+  )

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: twitter_bootstrap_combo
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Romain Tartiere
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-02-02 00:00:00 Z
+dependencies: []
+
+description: Advanced combo-box using Twitter-Bootstrap
+email: 
+- romain@blogreen.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/twitter_bootstrap_combo.rb
+- lib/twitter_bootstrap_combo/engine.rb
+- lib/twitter_bootstrap_combo/railtie.rb
+- lib/twitter_bootstrap_combo/version.rb
+- lib/twitter_bootstrap_combo/view_helpers.rb
+- twitter_bootstrap_combo.gemspec
+- vendor/assets/javascripts/twitter_bootstrap_combo.js.coffee
+homepage: https://github.com/smortex/twitter_bootstrap_combo
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: twitter_bootstrap_combo workarounds limitation of SELECT tags in Rails application and provide a coherent look & feel through Twitter-Bootstraped applications.
+test_files: []
+