rerails 2.3.5.1 → 2.3.5.2

data/CHANGELOG.rdoc

@@ -1,9 +1,17 @@
+=== 2.3.5.2 / 2010-01-02
+
+* 1 major enhancement
+
+  * Add form helpers for HTML5 inputs of type search, tel, url, email, number,
+    range.
+
+
 === 2.3.5.1 / 2009-12-23
 
 * 2 major enhancements
 
   * Add Array#first and Array#last limit functionality to
     ActiveRecord::Base.first and ActiveRecord::Base.last; optimize LIMIT SQL
-    for "first" and "last" in associations and named scopes.
+    for "first" and "last" in association collections and named scopes.
 
   * Let label helpers accept blocks.

data/README.rdoc

@@ -14,6 +14,19 @@ Reinforcing the Rails with assorted patches.
     <% end %>
 
 
+* HTML5 form helpers.
+
+    <% form_tag "user_search" do %>
+      <%= search_field_tag "user_search", nil, :autosave => true %>
+    <% end %>
+
+    <% form_for @user do |f| %>
+      <%= f.email_field :email %>
+      <%= f.url_field :homepage %>
+      <%= f.phone_field :phone %>
+    <% end %>
+
+
 === ReactiveRecord
 
 * <tt>Array#first</tt> and <tt>Array#last</tt> functionality and
@@ -44,16 +57,16 @@ As a plugin:
 
 Setup (to run tests):
 
-  [sudo] gem install bundler
-  gem bundle
-  bin/rake
+  % [sudo] gem install bundler
+  % gem bundle
+  % bin/rake
 
 
 == License
 
 Released under the same license as Ruby on Rails (The MIT License).
 
-(c) 2009 Stephen Celis, stephen@stephencelis.com.
+(c) 2009-2010 Stephen Celis, stephen@stephencelis.com.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/lib/reaction_view/html5_forms.rb

@@ -0,0 +1,163 @@
+module ActionView #:nodoc:
+  module Helpers #:nodoc:
+    module FormTagHelper
+      # Creates a search field.
+      #
+      # ==== Options
+      # * <tt>:autosave</tt> - If set to true, will generate a domain-based
+      #   namespace (e.g., for blog.rubyonrails.com, "com.rubyonrails.blog").
+      #   Also accepts string values.
+      # * <tt>:results</tt> - The number of previous searches displayed in the
+      #   drop-down. Default: 10, with <tt>:autosave</tt>.
+      # * Otherwise accepts the same options as text_field_tag.
+      #
+      # ==== Examples
+      #   search_field_tag 'query'
+      #   # => <input id="query" name="query" type="search" />
+      #
+      #   search_field_tag 'query', nil, :autosave => true
+      #   # => <input id="query" name="query" type="search" autosave="tld.yourdomain" results="10">
+      #
+      #   search_field_tag 'site_search', nil, :autosave => 'com.rubyonrails', :results => 5
+      #   # => <input id="site_search" name="site_search" type="search" autosave="com.rubyonrails" results="5">
+      def search_field_tag(name, value = nil, options = {})
+        options = options.stringify_keys
+
+        if options["autosave"]
+          if options["autosave"] == true
+            options["autosave"] = request.host.split(".").reverse.join(".")
+          end
+          options["results"] ||= 10
+        end
+
+        if options["onsearch"]
+          options["incremental"] = true unless options.has_key?("incremental")
+        end
+
+        text_field_tag(name, value, options.update("type" => "search"))
+      end
+
+      # Creates a text field of type "tel".
+      #
+      # ==== Options
+      # * Accepts the same options as text_field_tag.
+      def telephone_field_tag(name, value = nil, options = {})
+        text_field_tag(name, value, options.stringify_keys.update("type" => "tel"))
+      end
+      alias phone_field_tag telephone_field_tag
+
+      # Creates a text field of type "url".
+      #
+      # ==== Options
+      # * Accepts the same options as text_field_tag.
+      def url_field_tag(name, value = nil, options = {})
+        text_field_tag(name, value, options.stringify_keys.update("type" => "url"))
+      end
+
+      # Creates a text field of type "email".
+      #
+      # ==== Options
+      # * Accepts the same options as text_field_tag.
+      def email_field_tag(name, value = nil, options = {})
+        text_field_tag(name, value, options.stringify_keys.update("type" => "email"))
+      end
+
+      # Creates a number field.
+      #
+      # ==== Options
+      # * <tt>:min</tt> - The minimum acceptable value.
+      # * <tt>:max</tt> - The maximum acceptable value.
+      # * <tt>:in</tt> - A range specifying the <tt>:min</tt> and
+      #   <tt>:max</tt> values.
+      # * <tt>:step</tt> - The acceptable value granularity.
+      # * Otherwise accepts the same options as text_field_tag.
+      #
+      # ==== Examples
+      #   number_field_tag 'quantity', nil, :in => 1...10
+      #   => <input id="quantity" name="quantity" min="1" max="9" />
+      def number_field_tag(name, value = nil, options = {})
+        options = options.stringify_keys
+        options["type"] ||= "number"
+        if range = options.delete("in") || options.delete("within")
+          options.update("min" => range.min, "max" => range.max)
+        end
+        text_field_tag(name, value, options)
+      end
+
+      # Creates a range form element.
+      #
+      # ==== Options
+      # * Accepts the same options as number_field_tag.
+      def range_field_tag(name, value = nil, options = {})
+        number_field_tag(name, value, options.stringify_keys.update("type" => "range"))
+      end
+    end
+
+    module FormHelper #:nodoc:
+      def search_field(object_name, method, options = {})
+        options = options.stringify_keys
+
+        if options["autosave"]
+          if options["autosave"] == true
+            options["autosave"] = request.host.split(".").reverse.join(".")
+          end
+          options["results"] ||= 10
+        end
+
+        if options["onsearch"]
+          options["incremental"] = true unless options.has_key?("incremental")
+        end
+
+        InstanceTag.new(object_name, method, self, options.delete(:object)).to_input_field_tag("search", options)
+      end
+
+      def telephone_field(object_name, method, options = {})
+        InstanceTag.new(object_name, method, self, options.delete(:object)).to_input_field_tag("tel", options)
+      end
+      alias phone_field telephone_field
+
+      def url_field(object_name, method, options = {})
+        InstanceTag.new(object_name, method, self, options.delete(:object)).to_input_field_tag("url", options)
+      end
+
+      def email_field(object_name, method, options = {})
+        InstanceTag.new(object_name, method, self, options.delete(:object)).to_input_field_tag("email", options)
+      end
+
+      def number_field(object_name, method, options = {})
+        options = options.stringify_keys
+        options["type"] ||= "number"
+        if range = options.delete("in") || options.delete("within")
+          options.update("min" => range.min, "max" => range.max)
+        end
+        InstanceTag.new(object_name, method, self, options.delete(:object)).to_input_field_tag("number", options)
+      end
+
+      def range_field(object_name, method, options = {})
+        options = options.stringify_keys
+        options["type"] ||= "number"
+        if range = options.delete("in") || options.delete("within")
+          options.update("min" => range.min, "max" => range.max)
+        end
+        InstanceTag.new(object_name, method, self, options.delete(:object)).to_input_field_tag("range", options)
+      end
+    end
+
+    class FormBuilder #:nodoc:
+      %w(search_field telephone_field url_field email_field number_field range_field).each do |selector|
+        src = <<-end_src
+          def #{selector}(method, options = {})
+            @template.send(
+              #{selector.inspect},
+              @object_name,
+              method,
+              objectify_options(options))
+          end
+        end_src
+        class_eval src, __FILE__, __LINE__
+      end
+
+      alias phone_field telephone_field
+    end
+  end
+end

data/lib/reaction_view.rb

@@ -1 +1,2 @@
 require "reaction_view/block_labels"
+require "reaction_view/html5_forms"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rerails
 version: !ruby/object:Gem::Version 
-  version: 2.3.5.1
+  version: 2.3.5.2
 platform: ruby
 authors: 
 - Stephen Celis
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-23 00:00:00 -05:00
+date: 2010-01-02 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -35,6 +35,7 @@ files:
 - CHANGELOG.rdoc
 - README.rdoc
 - lib/reaction_view/block_labels.rb
+- lib/reaction_view/html5_forms.rb
 - lib/reaction_view.rb
 - lib/reactive_record/first_last_limits.rb
 - lib/reactive_record.rb