bootstrap_rails_helper 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 YOURNAME
+
+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,4 @@
+bootstrap_rails_helper
+======================
+
+Simple rails helper to construct bootstrap components

data/Rakefile

@@ -0,0 +1,33 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ActAsAdmin'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+# install rspec rake task
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = "--format d --color"
+end
+task :default => :spec
+
+
+Bundler::GemHelper.install_tasks
+

data/app/helpers/bootstrap_form_helper.rb

@@ -0,0 +1,116 @@
+module BootstrapFormHelper
+
+  def control_group form, field, opts={}, &block
+    errors = opts.delete(:errors)
+    label = opts.delete(:label) || field_name(field)
+    content_tag(:div, :class=>"control-group") do
+      concat content_tag(:label, label, :class=>"control-label")
+      concat(content_tag(:div, :class=>"controls"){
+        if(block_given?)
+         concat yield(form, field, opts)
+        else
+         concat form_field(form, field, opts)
+        end
+        concat content_tag(:span, errors.join(","), :class=>"help-inline error-help") if (errors && errors.count >0)
+      })
+    end
+  end
+
+  def form_action form, opts, &block
+    content_tag(:div, :class=>"form-actions") do
+      if block_given?
+        concat yield(form, opts)
+      else
+        submit_label = opts.delete(:submit)
+        concat form.submit(submit_label, :class=>'btn btn-primary')
+
+        cancel = opts.delete(:cancel)
+        if (cancel)
+          label = cancel[0]
+          url = cancel[1]
+          concat content_tag(:span, "OR")
+          concat link_to(label, url, :class=>"cancel")
+        end
+      end
+    end
+  end
+
+  def form_field form, field, opts
+    type = opts.delete :type
+    raise "No type defined for #{field} field" if type.nil?
+
+    cls =  opts.delete(:class)
+    size = opts.delete(:size)
+    help = opts.delete(:help)
+
+    opts = opts.merge(:class=>[cls, size].compact.join(" "))
+    opts = opts.merge(:title=>help, :"data-toggle"=>"tooltip", :"data-trigger"=>"focus", :"data-placement"=>"bottom") if help.present?
+
+    field_of(form, field) do |f, field|
+      case type
+      when :select
+        f.select(field, selection_values(opts), opts)
+
+      when :radio_button
+        render_radio_button(f, field, selection_values(opts))
+
+      when :check_box
+        render_check_box(f, field, selection_values(opts))  
+
+      else
+        f.send(type.to_sym, field, opts)
+      end
+    end
+  end
+
+
+  def field_of form, field
+
+    nested_fields = field.to_s.split(".")
+    if (nested_fields.size == 2)
+      form.fields_for(nested_fields[0].to_sym) {|fields|
+        yield(fields, nested_fields[1].to_sym)
+      }
+    else
+      yield(form, field)
+    end
+  end
+
+ 
+
+  def render_fileupload(file_field, extra=nil)
+    extra ||= ""
+    render :partial=>"components/bootstrap/fileupload", :locals=>{file_field: file_field, extra:extra}
+  end
+
+  def render_check_box form, field, selection
+    check_boxes = selection.collect do |item|
+      content_tag(:label, :class=>"checkbox") do
+        concat form.check_box(field, {}, item[1], nil)
+        concat item[0]
+      end
+    end
+    check_boxes.join("\n").html_safe
+  end
+
+  def render_radio_button form, field, selection
+    radio_buttons = selection.collect do |item|
+      content_tag(:label, :class=>"radio") do
+        concat form.radio_button(field, item[1])
+        concat item[0]
+      end
+    end
+    radio_buttons.join("\n").html_safe
+  end
+
+  private 
+  def selection_values opts
+    selection = opts.delete(:selection)
+    if selection.respond_to? :keys
+      selection.collect{|k,v| [v,k]}
+    else
+      selection.collect{|i| [i,i]}
+    end
+  end
+
+end

data/app/helpers/bootstrap_helper.rb

@@ -0,0 +1,197 @@
+module BootstrapHelper
+
+ class TabBuilder
+    attr_accessor :tabs
+
+    def tab name, opts={}, &block
+      @tabs ||= []
+      @tabs << {:name=>name, :opts=>opts, :proc=>block}
+    end
+
+    def tabs
+      return @tabs || []
+    end
+  end
+
+  def bootstrap_form_fields form, model, &block
+    BootstrapFormBuilder.render_items(form, model, self, &block)
+  end
+
+  # Render a standard bootstrap sidebar panel with nav-stacked, nav-pills content
+  # 
+  # opts:: Options that will be passed to the yieled block
+  def bootstrap_sidebar opts={}
+    content_tag(:div, :class=>"section sidebar-nav") do
+      nav_class = opts.delete(:nav_class) || "nav-pills nav-stacked"
+      content_tag(:ul, :class=>"nav #{nav_class}") do
+        header = opts.delete(:header)
+        concat(content_tag :li, header.html_safe, :class=>"nav-header") if header.present?
+        yield(opts) if block_given?
+      end
+    end
+  end
+  
+
+  # Render a standard fixed-top bootstrap navbar 
+  # It will yield to a block that will output nav menus as <li> markup.
+  # #bootstrap_dropdown_menu will output a menu markup.
+  #
+  # opts[:brand]:: The html markups for brand section
+  # opts[:right]:: The html markups for the pull-right section
+  def bootstrap_navbar opts={}, &block
+    brand = opts.delete :brand || ""
+    right = opts.delete :right || ""
+    
+    content_tag(:div, :class=>"navbar navbar-fixed-top") do
+      content_tag(:div, :class=>"navbar-inner") do
+        content_tag(:div, :class=>"container-fluid") do
+          concat(nav_collapse.html_safe)
+          concat(link_to brand.html_safe, "#", :class=>"brand")
+          nav = content_tag(:div, :class=>"container-fluid nav-collapse") do
+            concat(content_tag(:ul, :class=>"nav", &block))
+            concat(content_tag(:ul, right, :class=>"nav pull-right"))
+          end
+          concat(nav)
+        end
+      end
+    end
+  end
+
+  # Render a dropdown menu <li> markup in the bootstrap nav bar
+  # It will yield to a block that will output the menu items as html <li> tag
+  #
+  # menu:: The text on the menu
+  def bootstrap_dropdown_menu menu, cls=nil
+    opts = {:class=>["dropdown",cls].compact.join(" ")}
+    content_tag(:li, opts) do
+      concat link_to(%{#{menu} #{content_tag :b, "", :class=>"caret"}}.html_safe, "#", :class=>"dropdow-toggle", :"data-toggle"=>"dropdown")
+      concat content_tag(:ul, :class=>"dropdown-menu"){yield}
+    end
+  end
+
+  # Render a bootstrap dropdown button.
+  # The yielded block should render each dropdown item as a <li>
+  # 
+  # content:: The html content on the button
+  # opts[:class]:: The dropdown button class, default is "btn"
+  def bootstrap_dropdown_button content, opts={}
+    btn_class = (opts||{}).delete(:class) || "btn"
+    content_tag(:div, :class=>"btn-group") do
+      concat link_to(%{#{content} #{content_tag :span, "", :class=>"caret"}}.html_safe, "#", :class=>"#{btn_class} dropdown-toggle", :"data-toggle"=>"dropdown")
+      concat content_tag(:ul, :class=>"dropdown-menu"){yield if block_given?}
+    end
+  end
+
+
+  # Render a bootstrap button group
+  # data:: The data content in the button group. If it is an emuratable object, this method
+  # will yield the block with each item in the collection.
+  def bootstrap_btn_group data=nil, &block
+    content_tag(:div, :class=>"btn-group") do
+      if data.respond_to? :each
+        data.each(&block)
+      else
+        yield data
+      end
+    end
+  end
+
+
+  # Render standard fav link icons for different devices.
+  # It normally embeded in the <header>
+  def bootstrap_fav_links
+    render "components/bootstrap/fav_links"
+  end
+
+  # Render a bootstrap modal panel.
+  # It will yield to a block that should ouput the modal-body content
+  #
+  # options[:id]:: Dialog id
+  # options[:title]:: Dialog title, default "Title"
+  # options[:actions]:: Html markups for modal-footer section, default is a Cancel button
+  # options[:remote_path]:: If presented, the modal div will have 'data-remote-path' attribute set to this value
+  def bootstrap_modal options
+    id = options.delete(:id)
+    remote_path = options.delete(:remote_path)
+    title=options.delete(:title) || "Title"
+    actions = options.delete(:actions) || [link_to("Cancel","#", :class=>"btn ", :"data-dismiss"=>"modal", :"aria-hidden"=>"true")]
+    cls = options.delete(:class) || ""
+
+    modal_options = {:class=>"modal hide fade #{cls}"}
+    modal_options[:id] = id if id.present?
+    modal_options[:"data-remote-path"] = remote_path if remote_path.present?
+
+    content_tag(:div, modal_options) do
+      concat(content_tag(:div, :class=>"modal-header"){
+        concat content_tag(:button,"&times;".html_safe, :type=>"button", :class=>"close", :"data-dismiss"=>"modal", :"aria-hidden"=>"true")
+        concat content_tag(:h3, title)
+      })
+      concat(content_tag(:div, :class=>"modal-body"){yield if block_given?})
+      concat content_tag(:div, actions.join("\n").html_safe, :class=>"modal-footer")
+    end
+  end
+
+ 
+  # Render a bootstrap tab pane
+  # Example code:
+  # <tt>
+  #   bootstrap_tabs(tab_pos: "tabs-top") do |t|
+  #     t.tab "Tab1", :id=>"id_of_tab1" do
+  #       ...
+  #     end
+  #     t.tab "Tab2", :id=>"id_of_tab2" do
+  #       ...
+  #     end
+  #   end
+  # </tt>
+  #
+  # Parameters for the tab panel
+  # opts[:tab_pos]:: The bootstrap class name for the tab position, like "tab-top". 
+  #                  Default value is "tab-top"
+  # 
+  # Parameters for each tab
+  # name:: The tab name
+  # opts[:id]:: The tab id, default value is the tab name
+  #
+  def bootstrap_tab_pane opts={}
+    tab_builder = TabBuilder.new
+    yield(tab_builder) if block_given?
+
+    tab_pos = opts.delete(:tab_pos) || "tabs-top"
+    tab_options = tab_builder.tabs.collect do |item|
+      opts = item[:opts] || {}
+      name = item[:name]
+      id = opts.delete(:id) || name
+      {:id=>id, :link=>link_to(name, "##{id}", :"data-toggle"=>"tab"), :content_proc=>item[:proc], :opts=>opts}
+    end
+
+    content_tag :div, :class=>"tabbable #{tab_pos}" do
+      concat(content_tag(:ul, :class=>"nav nav-tabs"){
+        tab_options.each_with_index do |item, index|
+          cls = "active" if index==0
+          concat content_tag(:li, item[:link], :class=>cls)
+        end
+      })
+
+      concat(content_tag(:div, :class=>"tab-content"){
+        tab_options.each_with_index do |item, index|
+          opts = {:id=>item[:id], :class=>"tab-pane #{'active' if index==0}"}.merge(item[:opts])
+          concat(content_tag(:div, opts){
+            proc = item[:content_proc] 
+            proc.call if proc
+          })
+        end
+      })
+
+    end
+  end
+
+
+  private 
+  def nav_collapse
+    content_tag(:a, :class=>"btn btn-navbar", :"data-target"=>".nav-collapse", :"data-toggle"=>"collapse") do
+      (1..3).each{|i| concat(content_tag :span,"", :class=>"icon-bar")}
+    end
+  end
+
+end

data/lib/bootstrap_rails_helper.rb

@@ -0,0 +1,3 @@
+module BoostrapRailsHelper
+  require 'bootstrap_rails_helper/engine' if defined?(Rails)
+end

data/lib/bootstrap_rails_helper/engine.rb

@@ -0,0 +1,4 @@
+module BootstrapRailsHelper
+  class Engine < ::Rails::Engine
+  end
+end

data/lib/bootstrap_rails_helper/version.rb

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

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: bootstrap_rails_helper
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Hu Hao
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.3
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Simple rails helper to construct bootstrap components
+email:
+- huhao98@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- app/helpers/bootstrap_form_helper.rb
+- app/helpers/bootstrap_helper.rb
+- app/views/components/bootstrap/_fileupload.html.erb
+- lib/bootstrap_rails_helper/engine.rb
+- lib/bootstrap_rails_helper/version.rb
+- lib/bootstrap_rails_helper.rb
+- MIT-LICENSE
+- Rakefile
+- README.md
+homepage: http://brainet.github.com
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3744927139214705583
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3744927139214705583
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Simple rails helper to construct bootstrap components
+test_files: []