semantic_form_for 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+.bundle
+
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gemspec

data/README.markdown

@@ -0,0 +1,50 @@
+Semantic Forms
+==============
+
+semantic_form_for is a Rails FormBuilder DSL that, like Formtastic, makes it
+easier to create semantically awesome, readily stylable, and wonderfully
+accessible HTML forms in your Rails applications.
+
+However, it also tries not to do too much. Rather that trying to guess at
+input types, and provide its own sizeable set of customization options to
+each method, it wraps around the existing Rails field helpers.
+
+Dependencies
+============
+
+semantic_form_for depends on Haml. Why? It's what I use, and it was marginally
+easier than writing it for ERB.
+
+Syntax
+======
+
+	= semantic_form_for @user do |user|
+		= user.inputs 'Sign in' do
+			= user.email_field    :email, :placeholder => 'me@example.com'
+			= user.password_field :password
+			= user.check_box,     :remember, 'Remember me'
+			
+			= user.submit 'Sign in'
+	
+This is equivalent to the following Haml.
+
+	= form_for @user do |user|
+		%fieldset.inputs
+			%legend Sign in
+			%ol
+				%li#user_email_input
+					= user.label       :email
+					= user.email_field :email, :placeholder => 'me@example.com'
+				%li#user_password_input
+					= user.label          :password
+					= user.password_field :password
+				%li#user_remember_input
+					= user.check_box :remember
+					= user.label     :remember, 'Remember me'
+				%li
+					= user.submit_tag 'Sign in'
+
+That's it. All of the Rails field helpers you know and love work just like
+their normal FormBuilder counterparts, except for the minor addition of an
+optional second parameter to specify the field's label. Everything else works
+as expected, but gives you more semantic markup for free.

data/lib/semantic_form_for/form_builder.rb

@@ -0,0 +1,82 @@
+require 'semantic_form_for'
+
+class SemanticFormFor::FormBuilder < ActionView::Helpers::FormBuilder
+  attr_reader :template
+  attr_reader :object
+  attr_reader :object_name
+  
+  FIELDSETS = [ :inputs, :buttons ]
+  INPUTS    = [ :check_box,    :email_field,    :file_field,   :hidden_field,
+                :number_field, :password_field, :radio_button, :range_field,
+                :search_field, :select,         :text_area,    :text_field,
+                :url_field ]
+  BUTTONS   = [ :image_submit, :submit ]
+  
+  FIELDSETS.each do |set|
+    define_method set do |text, &block|
+      template.capture_haml do
+        template.haml_tag :fieldset, :class => set do
+          template.haml_tag(:legend, text) if text
+          template.haml_tag(:ol, &block)
+        end
+      end
+    end
+  end
+  
+  INPUTS.each do |input|
+    define_method input do |attribute, *args|
+      options  = args.extract_options!
+      text     = args.shift
+      
+      template.capture_haml do
+        template.haml_tag(:li, :id => _li_id(attribute)) do
+          # check boxes should have their label and input tag in the reverse
+          # order
+          if input != :check_box
+            template.haml_concat self.label(attribute, text)
+            template.haml_concat super(attribute, options)
+          else
+            template.haml_concat super(attribute, options)
+            template.haml_concat self.label(attribute, text)
+          end
+        end
+      end
+    end
+  end
+  
+  BUTTONS.each do |button|
+    define_method button do |text, options = {}|
+      template.capture_haml do
+        template.haml_tag(:li, :id => nil) do
+          template.haml_concat super(text, options)
+        end
+      end
+    end
+  end
+  
+  private
+  
+  def _object_name
+    self.object_name.to_s.gsub(/\]\[|[^-a-zA-Z0-9:.]/, "_").sub(/_$/, "")
+  end
+  
+  def _object_index
+    case
+      when options.has_key?(:index) then options[:index]
+      when defined?(@auto_index)    then @auto_index
+      else                               nil
+    end.to_s
+  end
+  
+  def _attribute_name(attribute)
+    attribute.to_s.gsub(/[\?\/\-]$/, '')
+  end
+  
+  def _li_id(attribute)
+    [
+      _object_name + _object_index, 
+      _attribute_name(attribute),
+      'input'
+     ].join('_')
+  end
+end

data/lib/semantic_form_for/form_helpers.rb

@@ -0,0 +1,21 @@
+require 'semantic_form_for'
+
+module SemanticFormFor::FormHelpers
+  [:form_for, :field_for, :remote_form_for].each do |method|
+    module_eval do
+      define_method "semantic_#{method}" do |record, *args, &block|
+        options = args.extract_options!
+        options[:builder] = SemanticFormFor::FormBuilder
+        
+        class_names  = options[:class] ? options[:class].split(' ') : []
+        class_names << case record
+          when String, Symbol then record.to_s
+          when Array          then ActiveModel::Naming.singular(record.last.class)
+          else                     ActiveModel::Naming.singular(record.class)
+        end
+        
+        send method, record, *(args << options), &block
+      end
+    end
+  end
+end

data/lib/semantic_form_for/railtie.rb

@@ -0,0 +1,8 @@
+require 'semantic_form_for'
+require 'rails'
+
+class SemanticFormFor::Railtie < Rails::Railtie
+  initializer 'semantic_form_for.initialize', :after => :after_initialize do
+    ActionView::Base.send :include, SemanticFormFor::FormHelpers
+  end
+end

data/lib/semantic_form_for/version.rb

@@ -0,0 +1,3 @@
+module SemanticFormFor
+  VERSION = '0.0.1'
+end

data/lib/semantic_form_for.rb

@@ -0,0 +1,9 @@
+module SemanticFormFor
+  require 'semantic_form_for/version'
+  
+  autoload :FormBuilder, 'semantic_form_for/form_builder'
+  autoload :FormHelpers, 'semantic_form_for/form_helpers'
+  autoload :Railtie,     'semantic_form_for/railtie'
+end
+
+SemanticFormFor::Railtie # trigger loading the Railtie

data/semantic_form_for.gemspec

@@ -0,0 +1,21 @@
+require File.expand_path('../lib/semantic_form_for/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = 'semantic_form_for'
+  s.version     = SemanticFormFor::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = [ 'Stephen Touset' ]
+  s.email       = [ 'stephen@touset.org' ]
+  s.homepage    = 'http://github.com/stouset/semantic_form_for'
+  s.summary     = 'Simple HTML5-enabled form builder'
+  s.description = 'A custom Rails FormBuilder that assumes HTML5. Because HTML4 is for chumps.'
+  
+  s.required_rubygems_version = '>= 1.3.6'
+  s.rubyforge_project         = 'semantic_form_for'
+  
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map {|f| f =~ /^bin\/(.*)/ ? $1 : nil }.compact
+  s.require_path = 'lib'
+
+  s.add_dependency 'haml', '~> 3.0'
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification 
+name: semantic_form_for
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Stephen Touset
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-29 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: haml
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :runtime
+  version_requirements: *id001
+description: A custom Rails FormBuilder that assumes HTML5. Because HTML4 is for chumps.
+email: 
+- stephen@touset.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.markdown
+- lib/semantic_form_for.rb
+- lib/semantic_form_for/form_builder.rb
+- lib/semantic_form_for/form_helpers.rb
+- lib/semantic_form_for/railtie.rb
+- lib/semantic_form_for/version.rb
+- semantic_form_for.gemspec
+has_rdoc: true
+homepage: http://github.com/stouset/semantic_form_for
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: semantic_form_for
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Simple HTML5-enabled form builder
+test_files: []
+