uberkit 0.0.7

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Michael Bleigh and Intridea, Inc.
+
+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

@@ -0,0 +1,149 @@
+Uberkit
+=======
+
+The Uberkit is a set of helpers to ease the development of common UI
+practices.
+
+Installation
+------------
+
+Uberkit is available both as a gem and as a traditional plugin. To use
+it as a gem, add this to your environment.rb:
+
+  config.gem 'mbleigh-uberkit', :lib => 'uberkit', :source => 'http://gems.github.com/'
+  
+To install it as a plugin (Rails 2.1 or later):
+
+  script/plugin install git://github.com/mbleigh/uberkit.git
+  
+UberForms
+---------
+
+UberForms provide a simple context for building forms in a DRYer
+manner by abstracting the markup into a simple, CSS-styleable
+format. It is available as a form builder as Uberkit::Forms::Builder,
+but is likely more useful when used in one of the helper forms:
+uberform_for or remote_uberform_for.
+
+=== Basic Example
+
+<% uberform_for :user do |f| %>
+  <%= f.text_field :login %>
+  <%= f.password_field :password %>
+  <%= f.submit "Submit"%>
+<% end %>
+
+Becomes...
+
+<form method="post" class="uberform" action="/users">
+  <div class="field_row">
+    <label for="user_login">Login:</label>
+    <input type="text" size="30" name="user[login]" id="user_login" class="text_field"/>
+    <br/>
+  </div>
+  <div class="field_row">
+    <label for="user_password">Password:</label>
+    <input type="password" size="30" name="user[password]" id="user_password" class="password_field"/>
+    <br/>
+  </div>
+  <button type="submit">Submit</button>
+</form>
+
+=== Labels, Help, and Descriptions
+
+You can pass options into a given field to set a custom label,
+some help text, or a description of the field.
+
+<%= f.text_field :login, :label => "Username", 
+                         :help => "Only a-z and underscores.", 
+                         :description => "The name you will use to log in." %>
+
+Becomes...
+
+<div class="field_row">
+  <label for="user_login">Username:</label>
+  <input type="text" size="30" name="user[login]" label="Username" id="user_login" help="Only a-z and underscores." description="The name you will use to log in." class="text_field"/>
+  <span class="help">Only a-z and underscores.</span>
+  <span class="description">The name you will use to log in.</span>
+  <br/>
+</div>
+
+=== Custom Fields
+
+Maybe the built-in form helpers won't do it for you. In that case, you
+can use the custom helper to insert arbitrary HTML that still plays
+nice with the rest of UberForms:
+
+<% f.custom :label => "State", :for => "user_state" do |f| %>
+  <%= state_select :user, :state %>
+<% end %>
+
+Becomes...
+
+<div class="field_row">
+  <label for="user_state">State:</label>
+  <div class="pseudo_field">
+    <select id="user_state">...</select>
+  </div> 
+  <br/>
+</div>
+
+UberMenu
+--------
+
+UberMenu is the simplest way to generate the markup for CSS menus,
+including state representation and special hooks for cross-browser
+advanced CSS needs.
+
+=== Basic Example
+
+<% ubermenu do |m| %>
+  <% m.action 'Home', '/' %>
+  <% m.action 'Users', users_path %>
+  <% m.action 'Log Out', logout_path, :class => "special" %>
+<% end %>
+
+Becomes...
+
+<ul>
+  <li class="first current first_current"><a href="/">Home</a></li>
+  <li><a href="/users">Users</a></li>
+  <li class="special last"><a href="/logout">Log Out</a></li>
+</ul>
+
+=== Submenus
+
+You can nest ubermenus for subnavigation using the 'submenu' method.
+If you pass :delegate instead of a url to the submenu option, it will
+automatically pick up the url of the first action in the submenu instead.
+
+<% ubermenu 'nav' do |m| %>
+  <% m.action 'Home', home_path %>
+  <% m.submenu 'Services', services_home_path do |s| %>
+    <% s.action 'Service A', service_path('a') %>
+    <% s.action 'Service B', service_path('b') %>
+  <% end %>
+<% end %>
+
+=== State
+
+UberMenus automatically retain state using the current_page? helper.
+You can specify further by passing a :current boolean expression to 
+evaluate whether or not the menu item is selected:
+
+<% ubermenu 'nav' do |m| %>
+  <% m.action 'Users', users_path, :current => controller.controller_name == 'users' %>
+<% end %>
+
+=== Method Listing
+
+* action - like link_to with additional options (see below)
+    :current - a boolean expression to determine whether this menu option is selected,
+        works with current_page? (if current_page? is true this will be true regardless)
+    :force_current - boolean expression that ignores the current_page?
+    :disabled - adds 'disabled' to class and forces non-current
+* remote_action - like link_to_remote
+* custom_action - only builds the outer <li>, accepts block for contents
+* submenu - accepts a block yielding a new menu object
+
+Copyright (c) 2008 Michael Bleigh and Intridea, Inc., released under the MIT license

data/Rakefile

@@ -0,0 +1,15 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name = "uberkit"
+    s.summary = "A Rails plugin for a common set of UI tools and helpers for building interfaces."
+    s.email = "michael@intridea.com"
+    s.homepage = "http://github.com/mbleigh/uberkit"
+    s.description = "UberKit is a set of tools for common UI problems in Rails including menus and forms."
+    s.authors = ["Michael Bleigh"]
+    s.files =  FileList["[A-Z]*", "{lib,rails}/**/*"]
+  end
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:build: 
+:minor: 0
+:patch: 7
+:major: 0

data/lib/uberkit.rb

@@ -0,0 +1,3 @@
+require 'uberkit/displayer'
+require 'uberkit/menu'
+require 'uberkit/form'

data/lib/uberkit/displayer.rb

@@ -0,0 +1,15 @@
+module Uberkit
+  class Displayer
+    include ActionView::Helpers::CaptureHelper
+    include ActionView::Helpers::TextHelper
+    include ActionView::Helpers::TagHelper
+
+    def initialize(template)
+      @template = template
+    end
+
+    def is_haml?
+      false
+    end
+  end
+end

data/lib/uberkit/form.rb

@@ -0,0 +1,4 @@
+require File.dirname(__FILE__) + "/forms/builder"
+require File.dirname(__FILE__) + "/forms/helper"
+
+ActionView::Base.send(:include, Uberkit::Forms::Helper)

data/lib/uberkit/forms/builder.rb

@@ -0,0 +1,97 @@
+class Uberkit::Forms::Builder < ActionView::Helpers::FormBuilder
+  include ActionView::Helpers::CaptureHelper
+  include ActionView::Helpers::TextHelper
+  include ActionView::Helpers::UrlHelper
+  include ActionView::Helpers::TagHelper
+  
+  helpers = field_helpers + %w(date_select datetime_select time_select select html_area state_select country_select check_box) - %w(hidden_field label fields_for) 
+  
+  helpers.each do |name|
+    define_method(name) do |field, *args|
+      options = args.extract_options!
+      class_names = array_from_classes(options[:class])
+      class_names << name
+      options[:class] = class_names.join(" ")
+      args << options
+      generic_field(options[:label],field,super(field,*args),{:description => options.delete(:description), :help => options.delete(:help), :required => options.delete(:required)})
+    end
+  end
+  
+  def generic_field(label_text,field,content,options = {})
+    required = options.delete(:required)
+    content_tag(:div, :class => "field_row#{' required' if required}#{' labelless' if label_text == ""}") do
+      ret = label(field, (label_text || field.to_s.titleize).to_s + ":") unless label_text == ""
+      ret << content
+      ret << content_tag(:span, options.delete(:help), :class => "help") if options[:help]
+      ret << content_tag(:span, options.delete(:description), :class => "description") if options[:description]
+      ret << "<br/>"
+      ret
+    end
+  end
+
+  def reverse_field(label_text, field, content, options = {})
+    content_tag(:div, :class => "reverse_field#{' required' if options[:required]}#{' labelless' if options[:title].blank?}") do
+      result = ""
+      unless options[:title].blank?
+        result << content_tag(:span, options[:title], :class => "pseudo_label")
+      end
+      result << content_tag(:div, :class => "pseudo_field") do
+        ret = content
+        ret << label(field, label_text)
+        ret << content_tag(:span, options[:help], :class => 'help') unless options[:help].blank?
+        ret << content_tag(:span, options[:description], :class => 'description') unless options[:description].blank?
+        ret << "<br/>"
+        ret
+      end
+      result
+    end
+  end
+
+  def check_box(field, options = {}, *args)
+    label_text = options.delete(:label) || field.to_s.titleize
+    help = options.delete(:help)
+    required = options.delete(:required)
+    description = options.delete(:description)
+    title = options.delete(:title)
+    reverse_field(label_text, field, super(field, options, *args), {:required => required, :help => help, :description => description, :title => title})
+  end
+
+  def radio_button(field, tag_value, options = {})
+    label_text = options.delete(:label) || tag_value.to_s.titleize
+    help = options.delete(:help)
+    required = options.delete(:required)
+    description = options.delete(:description)
+    title = options.delete(:title)
+    reverse_field(label_text, field, super(field, tag_value, options), {:required => required, :help => help, :description => description, :title => title} )
+  end
+  
+  def submit(text)
+    content_tag(:button, text, :type => "submit")
+  end
+  
+  def custom(options = {}, &block)
+    concat("<div class='field_row#{' labelless' unless options[:label]}'>#{"<label#{" for='#{options[:for]}'" if options[:for]}>#{options[:label] + ":" if options[:label]}</label>" if options[:label]}<div class='pseudo_field'>",block.binding)
+    yield
+    concat("</div> <br/></div>",block.binding)
+  end 
+  
+  def array_from_classes(html_classes)
+    html_classes ? html_classes.split(" ") : []
+  end
+  
+  def fieldset(legend=nil,&block)
+    concat("<fieldset>#{"<legend>#{legend}</legend>" if legend}")
+    yield
+    concat("</fieldset>")
+  end
+  
+  def output_buffer
+    @template.output_buffer
+  end
+  
+  def output_buffer=(buf)
+    @template.output_buffer = buf
+  end
+  
+  def is_haml?; false end
+end

data/lib/uberkit/forms/helper.rb

@@ -0,0 +1,22 @@
+module Uberkit::Forms::Helper
+  def parse_options(*args)
+    options = args.extract_options!
+    options.merge!(:builder => Uberkit::Forms::Builder)
+    options[:html] ||= {}
+    class_names = options[:html][:class] ? options[:html][:class].split(" ") : []
+    class_names << "uberform"
+    class_names << options.delete(:kind).to_s
+    options[:html][:class] = class_names.join(" ")
+    args << options
+  end
+  
+  def uberform_for(name_or_object_or_array, *args, &proc)
+    args = parse_options(*args)
+    form_for(name_or_object_or_array, *args, &proc)
+  end
+  
+  def remote_uberform_for(name_or_object_or_array, *args, &proc)
+    args = parse_options(*args)
+    remote_form_for(name_or_object_or_array, *args, &proc)
+  end
+end

data/lib/uberkit/menu.rb

@@ -0,0 +1,82 @@
+module Uberkit
+  module Menu
+    def ubermenu(options = {}, &block)
+      nav = NavigationMenu.new(self,options)
+      yield nav
+      concat(nav.to_html, block.binding) if nav.actions.any?
+    end
+
+    class NavigationMenu < Uberkit::Displayer
+      def initialize(template,options = {})
+        super(template)
+        @actions = []
+        @subnavs = []
+        @id = options.delete(:id)
+        @class_name = options.delete(:class)
+      end
+
+      def action_wrapper(contents, options = {}, url_for_options = {})
+        classes = Array.new        
+        classes << "first" if @actions.first == [contents, options, url_for_options]
+        classes << "last" if @actions.last == [contents, options, url_for_options]
+        classes << "current" if merits_current?(contents,options,url_for_options)
+        classes << "disabled" if options.delete(:disabled)    
+        classes << classes.join("_") if classes.size > 1
+        content_tag(:li, contents, :class => classes.join(" "))
+      end
+
+      def merits_current?(contents,options={},url_for_options={})
+        if options[:force_current]
+          return true if options.delete(:current) == true && !options[:disabled]
+        else
+          return true if (options.delete(:current) == true || (!url_for_options.is_a?(Symbol) && (@template.current_page?(url_for_options)) && url_for_options != {}) and !options[:disabled])
+        end
+         false
+      end
+
+      def action(name, options = {}, html_options = {})
+        wrapper_options = { :current => html_options.delete(:current), :disabled => html_options.delete(:disabled), :force_current => html_options.delete(:force_current), :url => options }
+        @actions << [@template.link_to(name,options,html_options), wrapper_options, options]
+      end
+
+      def actions
+        @actions
+      end
+
+      def remote_action(name, options = {}, html_options = {})
+        wrapper_options = { :current => options.delete(:current), :disabled => options.delete(:disabled), :force_current => options.delete(:force_current), :url => options[:url] }
+        @actions << [@template.link_to_remote(name,options,html_options), wrapper_options, options[:url]]
+      end
+
+      def custom_action(options = {}, &block)
+        options[:force_current] = true
+        @actions << [capture(&block), options, {}]
+      end
+
+      def submenu(name, options = {}, html_options = {}, &block)
+        subnav = NavigationMenu.new(@template,html_options)
+        @subnavs << subnav
+        yield subnav
+
+        if subnav.actions.any?
+          if options == :delegate
+            @actions << [@template.link_to(name, subnav.actions.first[1][:url]) + subnav.to_html, {:current => subnav.any_current?, :url => subnav.actions.first[1][:url]}, {:class => 'submenu'}]
+          else
+            @actions << [@template.link_to(name,options,html_options) + subnav.to_html, {:current => subnav.any_current?, :url => options}, {:class => 'submenu'}.merge(options)] if subnav.actions.any?
+          end
+        end
+      end
+
+      def any_current?
+        @actions.select{|a| merits_current?(*a)}.any?
+      end
+
+      def build
+        content_tag :ul, @actions.collect{|a| action_wrapper(*a)}.join("\n"),
+                    :id => @id,
+                    :class => @class_name
+      end
+      alias :to_html :build
+    end
+  end
+end

data/rails/init.rb

@@ -0,0 +1,3 @@
+require 'uberkit'
+
+ActionView::Base.send :include, Uberkit::Menu

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: uberkit
+version: !ruby/object:Gem::Version 
+  version: 0.0.7
+platform: ruby
+authors: 
+- Michael Bleigh
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-15 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: UberKit is a set of tools for common UI problems in Rails including menus and forms.
+email: michael@intridea.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- MIT-LICENSE
+- README
+- Rakefile
+- VERSION.yml
+- lib/uberkit.rb
+- lib/uberkit/displayer.rb
+- lib/uberkit/form.rb
+- lib/uberkit/forms/builder.rb
+- lib/uberkit/forms/helper.rb
+- lib/uberkit/menu.rb
+- rails/init.rb
+has_rdoc: true
+homepage: http://github.com/mbleigh/uberkit
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A Rails plugin for a common set of UI tools and helpers for building interfaces.
+test_files: []
+