formula 0.0.4 → 0.0.5

data/lib/formula.rb

@@ -2,64 +2,167 @@ module Formula
   
   require 'formula/railtie' if defined?(Rails)
   
-  mattr_accessor :container_tag
-  @@container_tag = :div
+  # Default class assigned to input (<div class="input">...</div>).
+  mattr_accessor :input_class
+  @@input_class = 'input'
   
-  mattr_accessor :hints_tag
-  @@hints_tag = :div
+  # Default class assigned to error (<div class="error">...</div>).
+  mattr_accessor :error_class
+  @@error_class = 'error'
   
-  mattr_accessor :errors_tag
-  @@errors_tag = :div
+  # Default class assigned to hint (<div class="hint">...</div>).
+  mattr_accessor :hint_class
+  @@hint_class = 'hint'
   
+  # Default tag assigned to input (<div class="input">...</div>).
+  mattr_accessor :input_tag
+  @@input_tag = :div
+  
+  # Default tag assigned to error (<div class="error">...</div>).
+  mattr_accessor :error_tag
+  @@error_tag = :div
+  
+  # Default tag assigned to hint (<div class="hint">...</div>).
+  mattr_accessor :hint_tag
+  @@hint_tag = :div
+  
+  # Default size used on inputs (<input ... size="50" />).
   mattr_accessor :default_input_size
   @@default_input_size = 50
   
+  # Default cols used on textarea (<textarea ... cols="50" />).
   mattr_accessor :default_textarea_cols
   @@default_textarea_cols = 50
   
+  # Default cols used on textarea (<textarea ... rows="5" />).
   mattr_accessor :default_textarea_rows
-  @@default_textarea_rows = 3
+  @@default_textarea_rows = 5
   
   class FormulaFormBuilder < ActionView::Helpers::FormBuilder
     
-    def as(method, options = {})
-      type = @object.column_for_attribute(method)
+    
+    # Generate a suitable form input for a given method by performing introspection on the type. 
+    #
+    # Options: 
+    #
+    # * :as    - override the default type used (:url, :email, :phone, :password, :number, :text)
+    # * :label - override the default label used ('Name:', 'URL:', etc.)
+    # * :error - override the default error used ('invalid', 'incorrect', etc.)
+    # * :class - add custom classes to the container ('grid-04', 'grid-08', etc.)
+    
+    def input(method, options = {})
+      options[:as]    ||= as(method, options)
+      options[:error] ||= error(method, options)
+            
+      components = []
       
-      case type
-        when :string then
-          return :url       if method.to_s =~ /url/
-          return :email     if method.to_s =~ /email/
-          return :phone     if method.to_s =~ /phone/
-          return :password  if method.to_s =~ /password/
-        when :integer then
-          return :number
-        when :float   then
-          return :number
-        when :decimal then
-          return :number
+      components << self.label(method, options[:label])
+      
+      case options[:as]
+        when :text     then components << self.text_area(method)
+        when :string   then components << self.text_field(method)
+        when :password then components << self.password_field(method)
+        when :url      then components << self.url_field(method)
+        when :email    then components << self.email_field(method)
+        when :phone    then components << self.phone_field(method)
+        when :number   then components << self.number_field(method)
+        when :date     then components << self.date_select(method)
+        when :time     then components << self.time_select(method)
+        when :datetime then components << self.datetime_select(method)
       end
       
-      return :text
+      components << @template.content_tag(::Formula.hint_tag, options[:hint], :class => ::Formula.hint_class) if options[:hint]
+      components << @template.content_tag(::Formula.error_tag, options[:error], :class => ::Formula.error_class) if options[:error]
+      
+      @template.content_tag(:div, :class => options[:class]) do
+        @template.content_tag(::Formula.input_tag, :class => ::Formula.input_class) do
+          components.join
+        end
+      end
+    end
+    
+    
+    # Generate a suitable form association for a given method by performing introspection on the type. 
+    #
+    # Options: 
+    #
+    # * :as    - override the default type used (:url, :email, :phone, :password, :number, :text)
+    # * :label - override the default label used ('Name:', 'URL:', etc.)
+    # * :error - override the default error used ('invalid', 'incorrect', etc.)
+    # * :class - add custom classes to the container ('grid-04', 'grid-08', etc.)
+    
+    def association(method, options = {}, &block)
     end
+    
+    
+  private
   
-    def input(method, options = {}, &block)
-      options[:as] ||= as(method, options)
-      options[:errors] ||= @object.errors[method]
-      
-      components = []
+  
+    def type(method)
+      column = @object.column_for_attribute(method) if @object.respond_to?(:column_for_attribute)
+      return column.type if column
+    end
+    
+    
+    # Introspection on the field and method to determine how to render a method. The method is 
+    # used to generate form element types.
+    #
+    # Returns:
+    #
+    # * :url      - for columns containing 'url'
+    # * :email    - for columns containing 'email'
+    # * :phone    - for columns containing 'phone'
+    # * :password - for columns containing 'password'
+    # * :number   - for integer, float, or decimal columns
+    
+    # * :string   - for all other cases
+    
+    def as(method, options = {})
+      type = type(method)
       
-      components << label(:method, options[:label])
-      components << @template.content_tag(::Formula.hints_tag, options[:hint], :class => 'hints') if options[:hints]
-      components << @template.content_tag(::Formula.errors_tag, options[:errors], :class => 'errors') if options[:errors]
+      if type == :string or type == nil
+        case method
+          when /url/      then return :url
+          when /email/    then return :email
+          when /phone/    then return :phone
+          when /password/ then return :password
+        end
+      end
       
-      @template.content_tag(::Formula.container_tag, :class => options[:class]) do
-        components.join
+      case type
+        when :string    then return :string
+        when :integer   then return :number
+        when :float     then return :number
+        when :decimal   then return :number
+        when :timestamp then return :datetime
+        when :datetime  then return :datetime
+        when :date      then return :date
+        when :time      then return :time
+        when :text      then return :text
       end
+      
+      return :string
     end
     
-    def association(method, options = {}, &block)
+    
+    # Generate error messages by combining all errors on an object into a comma seperated string 
+    # representation. 
+    #
+    # Returns:
+    #
+    # * "name "
+    # * :email    - for string columns named 'email'
+    # * :phone    - for string columns named 'phone'
+    # * :password - for string columns named 'password'
+    # * :number   - for integer, float, or decimal columns
+    # * :text     - for all other cases
+    
+    def error(method, options = {})
+      @object.errors[method].to_sentence
     end
     
+  public
+    
     def formula_fields_for(record_or_name_or_array, *args, &block)
       options = args.extract_options!
       options[:builder] ||= self.class

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 4
-  version: 0.0.4
+  - 5
+  version: 0.0.5
 platform: ruby
 authors: 
 - Kevin Sylvestre
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-09 00:00:00 -05:00
+date: 2010-11-10 00:00:00 -05:00
 default_executable: 
 dependencies: []