caring_form 1.2.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9189ecabe4fbff2003c4100405b4b46bd96d222f
+  data.tar.gz: 811c47c4ed64c413dfc232642c23be924910bb58
+SHA512:
+  metadata.gz: 51315c24df9c1872cf23ccc67799709a12597713b81982537c0e67678830d56dd62f0c5263e62d2b5ac5aea9ecd93a5c7a2f267adbf24a1702d9e93fa949e30c
+  data.tar.gz: db02f2691ea49e9cd8821c01397d813e4b62bd572c5254ca54118ab876cea5319466af9717c2667f40e4200d4b9c94c392f81ce6829696eca74ebbf8dd02ee7f

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+gemfiles/*.gemfile.lock
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+bin

data/.travis.yml

@@ -0,0 +1,17 @@
+language: ruby
+cache: bundler
+script: bundle exec rake spec
+
+gemfile:
+  - gemfiles/rails_3_1.gemfile
+  - gemfiles/rails_3_2.gemfile
+  - gemfiles/rails_4.gemfile
+  - gemfiles/rails_4_1.gemfile
+
+rvm:
+  - 1.9.3
+  - 2.1.0
+
+matrix:
+  allow_failures:
+    - rvm: ruby-head

data/Appraisals

@@ -0,0 +1,18 @@
+appraise "rails-3-1" do
+  gem "minitest", '~> 4.0'
+  gem "rails", "~>3.1.0"
+end
+
+appraise "rails-3-2" do
+  gem "minitest", '~> 4.0'
+  gem "rails", "~>3.2.14"
+end
+
+appraise "rails-4" do
+  gem "rails", "~>4.0.0"
+end
+
+appraise "rails-4-1" do
+  gem "rails", "~> 4.1.1"
+  gem "simple_form", '~> 3.1.0.rc1'
+end

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+group :development do
+  gem 'guard-coffeescript'
+  gem 'guard-jammit'
+  gem 'guard-minitest'
+end
+
+gemspec

data/Guardfile

@@ -0,0 +1,15 @@
+# More info at https://github.com/guard/guard#readme
+
+guard 'coffeescript', :input => 'javascripts/src', :output => 'javascripts/compiled', :all_on_start => true
+
+guard :jammit, :config_path => 'javascripts/assets.yml', :output_folder => 'javascripts' do
+  watch(%r{^javascripts/compiled/(.*)\.js$})
+  watch('javascripts/assets.yml')
+end
+
+guard 'minitest' do
+  # with Minitest::Spec
+  watch(%r|^spec/(.*)_spec\.rb|)
+  watch(%r|^lib/(.*)([^/]+)\.rb|)   { |m| "spec/#{m[1]}#{m[2]}_spec.rb" }
+  watch(%r|^spec/spec_helper\.rb|)  { "spec" }
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Mathieu Lajugie
+
+MIT License
+
+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.md

@@ -0,0 +1,33 @@
+# CaringForm
+
+[![Build Status](https://magnum.travis-ci.com/caring/caring_form.png?token=sKHYu3Tc8rtipypNpjWg&branch=master)](https://magnum.travis-ci.com/caring/caring_form)
+
+Standardized forms, styles and JS validation for caring.com
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'caring_form'
+
+And then execute:
+
+    $ bundle
+    $ rake webshims:update_public # Allows dynamic module loading to continue working.
+
+
+## Usage
+
+In `app/assets/javascripts/application.js` or any other asset pipeline enabled JS.
+
+```
+//= require caring_forms
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,12 @@
+#!/usr/bin/env rake
+
+require 'rake/testtask'
+require 'bundler/gem_tasks'
+require 'appraisal'
+
+Rake::TestTask.new('spec') do |task|
+  task.pattern = 'spec/**/*_spec.rb'
+end
+
+desc 'Default: run unit tests.'
+task :default => :spec

data/app/assets/javascripts/caring_form/form-observer.coffee

@@ -0,0 +1,63 @@
+$ = jQuery
+
+class CARING.FormObserver
+
+  @enableButtons: (form) ->
+    form
+      .find('.primary-button, .secondary-button, .marketing-button')
+        .prop('disabled', false)
+        .removeClass('disabled')
+
+  @disableButtons: (form) ->
+    # disable buttons in the next click as IE7-8 won't submit the form
+    # if the submit button is disabled while in the callback flow...
+    setTimeout((->
+      form
+        .find('.primary-button, .secondary-button, .marketing-button')
+          .prop('disabled', true)
+          .addClass('disabled')
+    ), 0)
+    true
+
+  constructor: (@selector) ->
+
+  start: ->
+    changedProxy = $.proxy(@valueChanged, this)
+    $(@selector).on
+      'input': changedProxy
+      'change': changedProxy
+      'invalid': (event) =>
+        @markAsSubmitted(event.currentTarget)
+        @showErrorOn(event.target)
+      'submit': (event) =>
+        # IE7-8 trigger a form submit even if the form is not valid...
+        if $(event.currentTarget).checkValidity()
+          form = $(event.currentTarget)
+          @constructor.disableButtons(form) unless form.hasClass('no-disable-buttons')
+
+  wasSubmitted: (form) ->
+    $(form).hasClass('submitted')
+
+  markAsSubmitted: (form) ->
+    $(form).addClass('submitted')
+
+  fieldContainerFor: (element) ->
+    $(element).closest('.field')
+
+  showErrorOn: (element) ->
+    @fieldContainerFor(element).addClass('field-with-errors')
+
+  hideErrorOn: (element) ->
+    @fieldContainerFor(element).removeClass('field-with-errors')
+
+  hideErrorIfValidOnNextClick: (element) ->
+    # element validity is not accurate when checked right away, so let's
+    # wait for the next click in the event loop
+    setTimeout((=>
+      if $(element).hasClass('indicator-field-ok') or $(element).checkValidity()
+        @hideErrorOn(element)
+    ), 0)
+
+  valueChanged: (event) ->
+    return unless @wasSubmitted(event.currentTarget)
+    @hideErrorIfValidOnNextClick(event.target)

data/app/assets/javascripts/caring_form/main.coffee

@@ -0,0 +1,15 @@
+jQuery ($) ->
+  observer = new CARING.FormObserver('form.caring-form')
+  observer.start()
+
+  validators = [
+    new CARING.RemoteValidator('.validate-remotely')
+    new CARING.RuleBasedValidator()
+  ]
+  validator.addBehavior() for validator in validators
+
+  # allow to close flash
+  $('.flash .flash-close > a').click (event) ->
+    event.preventDefault()
+    flash = $(event.target).closest('.flash')
+    flash.slideUp()

data/app/assets/javascripts/caring_form/remote-validator.coffee

@@ -0,0 +1,71 @@
+$ = jQuery
+
+class CARING.RemoteValidator
+
+  _removeAllValidationClassesFor = (element) ->
+    $(element).removeClass('indicator-field-ok indicator-field-ban indicator-field-loading')
+
+  _refreshFormValidationFor = (element) -> $(element).trigger('input', [true])
+
+  _setErrorMessage = (field, message) ->
+    if field.setCustomValidity?
+      $(field).setCustomValidity(message)
+
+  _showInlineError = (field, message) ->
+    field = $(field)
+    error = field.next('.inline-error')
+    error.text(message).show()
+    offset = field.offset()
+    offset.top += field.outerHeight()
+    if window.navigator.userAgent.match(/Gecko/)
+      offset.top += 1
+      offset.left += 2
+    offset.left += field.outerWidth() - error.outerWidth() - 2
+    error.offset(offset)
+
+  _hideInlineError = (field) ->
+    $(field).next('.inline-error')
+      .hide()
+      .text('')
+
+  constructor: (@fieldSelector, options = {}) ->
+    @validate($(@fieldSelector)) if $(@fieldSelector).hasClass("auto-validate")
+
+  addBehavior: ->
+    $(@fieldSelector).on 'keyup', =>
+      field = $(@fieldSelector)
+      _setErrorMessage(field, field.data('init-message') or "Please wait while I check ...")
+      clearTimeout(buffering) if buffering = field.data('buffering')
+      buffering = setTimeout((=>
+        @validate(field)
+        field.data(buffering: null)
+      ), parseInt(field.data('max-idle-time') || "300", 10))
+      field.data(buffering: buffering)
+
+  validate: (element) ->
+    _removeAllValidationClassesFor(element)
+    value = element.val()
+    if value is ''
+      _setErrorMessage(element, '')
+      _refreshFormValidationFor(element)
+      _hideInlineError(element)
+    else
+      element.addClass('indicator-field-loading')
+      $.getJSON(element.data('validator-url'), {value: value}, (data, status, xhr) ->
+        _removeAllValidationClassesFor(element)
+        if data.valid
+          element
+            .addClass('indicator-field-ok')
+            .each (index, element) ->
+              $(element).trigger('data-valid')
+              _setErrorMessage(element, '')
+              _refreshFormValidationFor(element)
+              _hideInlineError(element)
+        else
+          element
+            .addClass('indicator-field-ban')
+            .each (index, element) ->
+              _setErrorMessage(element, data.message || data.short_message)
+              _refreshFormValidationFor(element)
+              _showInlineError(element, data.short_message)
+      )

data/app/assets/javascripts/caring_form/rule-based-validator.coffee

@@ -0,0 +1,37 @@
+$ = jQuery
+
+class CARING.RuleBasedValidator
+
+  # RULES: hash of {name: rule}
+  #        where rule has a targetEvent and an action
+  #
+  # The rule based validator expects rules set to DOM elements
+  # as data attributes. The data attribute is the name of the rule
+  # and its value is the target selector.
+
+  RULES =
+    'optional-if-absent':
+      targetEvent: 'change'
+      action: (source, target) ->
+        sourceRequired = $(target).val() isnt ''
+        $(source).attr('required', sourceRequired)
+
+    'optional-if-present':
+      targetEvent: 'change'
+      action: (source, target) ->
+        sourceRequired = $(target).val() is ''
+        $(source).attr('required', sourceRequired)
+
+  _applyRule = (source, ruleName, rule) ->
+    targetSelector = $(source).data(ruleName)
+    # run the rule once for each (source, target) and each
+    # time a target triggers the rule targetEvent
+    $(targetSelector)
+      .each(-> rule.action(source, this))
+      .bind(rule.targetEvent, (event) ->
+        rule.action(source, event.target)
+      )
+
+  addBehavior: ->
+    for name, rule of RULES
+      $("*[data-#{name}]").each -> _applyRule(this, name, rule)

data/app/assets/javascripts/caring_form/setup.coffee

@@ -0,0 +1,5 @@
+window.CARING ||= {}
+jQuery.webshims.setOptions('basePath', '/webshims/shims/')
+jQuery.webshims.polyfill('forms forms-ext');
+jQuery(document).ready () ->
+	CARING.WebshimsCustomization.normalizeFormValidation();

data/app/assets/javascripts/caring_form/webshims-customization.coffee

@@ -0,0 +1,25 @@
+$ = jQuery
+
+useWebshimsFormUI = ->
+  $.webshims.setOptions('forms',
+    replaceValidationUI: true
+    customMessages: true
+    overrideMessages: true
+  )
+
+  if messages = $.webshims.validityMessages['en']
+    messages.valueMissing.defaultMessage = "Please fill out this field. {%title}"
+    messages.valueMissing.select = "Please select an option. {%title}"
+    messages.valueMissing.radio = "Please select one of these options. {%title}"
+    messages.patternMismatch = "Please match the requested format. {%title}"
+
+useWebshimsDateSlider = ->
+  $.webshims.setOptions('forms-ext',
+    datepicker:
+      dateFormat: 'm/d/y'
+  )
+
+CARING.WebshimsCustomization =
+  normalizeFormValidation: ->
+    useWebshimsFormUI()
+    useWebshimsDateSlider()

data/app/assets/javascripts/caring_forms.js

@@ -0,0 +1,7 @@
+//= require webshims/polyfiller
+//= require caring_form/setup
+//= require caring_form/form-observer
+//= require caring_form/remote-validator
+//= require caring_form/rule-based-validator
+//= require caring_form/webshims-customization
+//= require caring_form/main

data/caring_form.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/caring_form/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Mathieu Lajugie"]
+  gem.email         = ['mathieu@caring.com']
+  gem.description   = %q{Build clean, robust and consistent forms for Caring.com.}
+  gem.summary       = gem.description
+  gem.homepage      = 'http://www.caring.com'
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "caring_form"
+  gem.require_paths = ["lib"]
+  gem.version       = CaringForm::VERSION
+  gem.platform      = Gem::Platform::RUBY
+
+  gem.add_dependency 'simple_form'
+  gem.add_dependency 'actionpack'
+  gem.add_dependency 'activemodel'
+  gem.add_dependency 'webshims-rails', '~> 1.15.6'
+
+  gem.add_development_dependency "appraisal", '~> 0.5.2'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'minitest'
+  gem.add_development_dependency 'minitest-reporters'
+  gem.add_development_dependency 'nokogiri'
+  gem.add_development_dependency 'awesome_print'
+  gem.add_development_dependency 'pry-nav'
+end

data/gemfiles/rails_3_1.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "minitest", "~> 4.0"
+gem "rails", "~>3.1.0"
+
+gemspec :path=>"../"

data/gemfiles/rails_3_2.gemfile

@@ -0,0 +1,8 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "minitest", "~> 4.0"
+gem "rails", "~>3.2.14"
+
+gemspec :path=>"../"