rails-ujs-form 0.1.0

data/README.md

@@ -0,0 +1,4 @@
+Unobtrusive JS Form Extensions for rails 3.1
+======================================================
+
+Builds on jquery-ujs to extend form functionality.

data/Rakefile

@@ -0,0 +1,3 @@
+require 'rubygems'
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/app/assets/javascripts/ujs-form/rails_form.js

@@ -0,0 +1,70 @@
+/**
+ * A small jQuery plugin to add 'rails-aware' form functionality.
+ *
+ * Basically, this understands the 'standard' rails way of structuring forms
+ * and makes some functions available to manipulate that.
+ */
+(function($) {
+$.fn.rails_form = function(method) {
+  if (methods[method]) {
+    return methods[method].apply(this, Array.prototype.slice.call(arguments, 1));
+  } else {
+    $.error('Method ' +  method + ' does not exist on rails_form');
+  }
+};
+
+// in these 'this' is the $form
+var methods = {
+  fields: function() {
+    return this.find('input, textarea, select');
+  },
+  
+  error_fields: function() {
+    var $form = this;
+    return this.rails_form('fields').filter(function() {
+      return $form.rails_form('has_error', $(this));
+    });
+  },
+  
+  submits: function() {
+    return this.find('input[type=submit], button[type=submit]');
+  },
+  
+  label_for: function($field) {
+    return this.find('label[for=' + $field.attr('id') + ']');
+  },
+  
+  error_on: function($field) {
+    return this.rails_form('label_for', $field).parents('.field_with_errors').next('.formError');
+  },
+  
+  has_error: function($field) {
+    return $field.parent('.field_with_errors').length > 0;
+  },
+  
+  clear_error: function($field) {
+   var id = $field.attr('id');
+   if (this.rails_form('has_error', $field)) { $field.unwrap() }
+   
+   this.find('.field_with_errors label[for=' + id + ']')
+    .unwrap()
+    .next('.formError').remove();
+  },
+  
+  add_error: function($field, error) {
+    var id = $field.attr('id');
+    $field.wrap('<div class="field_with_errors">');
+    this.find('label[for=' + id + ']')
+      .after('<div class="formError">' + error + '</div>')
+      .wrap('<div class="field_with_errors">');
+  },
+  
+  // display standard errors as returned by JSON
+  set_errors: function(errors) {
+    for (var name in errors) {
+      this.rails_form('add_error', this.fields().filter('[name*=' + name + ']'), errors[name][0]);
+    }
+  }
+};
+
+}(jQuery));

data/app/assets/javascripts/ujs-form/show-errors.js

@@ -0,0 +1,24 @@
+(function($) {
+  var showErrorSelector = 'form[data-show-errors]';
+  
+  $(showErrorSelector).live('ajax:error', function(event, request, status, error) {
+    console.log(request);
+    // CLIENT ERROR -- server-side validation failed. -- FIXME -should this be 422 only?
+    if (request.status >= 400 && request.status < 500) { 
+      // if data is html, we replace this content of the form with the content
+      // of the form that we've just received back
+      var contentType = request.getResponseHeader('Content-Type');
+      if (contentType =~ /html/) {
+        // wrap in a div incase there are a bunch of floating elements, pull the form out
+        var $new_form = $('<div>' + request.responseText + '</div>').find('#' + $(this).attr('id'));
+        $(this).html($new_form.html());
+        
+      } else if (contentType =~ /json/) {
+        // we will be receiving an error object back, we can pass it straight into rails_form.js
+        this.rails_form('set_errors', $.parseJSON(request.responseText));
+      } else {
+        throw "ujs-form/show-errors: Don't know how to handle dataType " + request.dataType;
+      }
+    }
+  });
+}(jQuery));

data/app/assets/javascripts/ujs-form.js

@@ -0,0 +1 @@
+//= require_tree ./ujs-form

data/lib/rails-ujs-form/version.rb

@@ -0,0 +1,3 @@
+module RailsUjsForm
+  VERSION = "0.1.0"
+end

data/lib/rails-ujs-form.rb

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

data/rails-ujs-form.gemspec

@@ -0,0 +1,18 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "rails-ujs-form/version"
+
+Gem::Specification.new do |s|
+  s.name    = 'rails-ujs-form'
+  s.version = RailsUjsForm::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.author  = 'Tom Coleman'
+  s.email   = 'tom@percolatestudio.com'
+  s.summary = 'Unobtrusive JS Form extensions'
+
+  s.add_dependency 'jquery-rails'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification 
+name: rails-ujs-form
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Tom Coleman
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-10-14 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: jquery-rails
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: 
+email: tom@percolatestudio.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.md
+- Rakefile
+- app/assets/javascripts/ujs-form.js
+- app/assets/javascripts/ujs-form/rails_form.js
+- app/assets/javascripts/ujs-form/show-errors.js
+- lib/rails-ujs-form.rb
+- lib/rails-ujs-form/version.rb
+- rails-ujs-form.gemspec
+homepage: 
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Unobtrusive JS Form extensions
+test_files: []
+