hinderinputjs-rails 0.0.1

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc
+*DS_Store
+

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Morgan Brown
+
+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,13 @@
+# Hinder Input
+This is a jQuery plugin that attempts to disallow text selection, cursor placement, and characters outside of the "normal" ASCII print character range.
+
+## Usage
+
+	$(element).hinderInput({
+		onAdd: function ( value ) {
+			// do something when a valid character is added
+		},
+		onDelete: function() {
+			// do something when a character is deleted
+		}
+	});

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/hinderinputjs-rails.gemspec

@@ -0,0 +1,18 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "hinderinputjs-rails/version"
+
+Gem::Specification.new do |s|
+  s.name        = "hinderinputjs-rails"
+  s.version     = Hinderinputjs::Rails::VERSION
+  s.authors     = ["Morgan Brown"]
+  s.email       = ["brown.mhg@gmail.com"]
+  s.homepage    = "https://github.com/discom4rt/hinderinputjs-rails"
+  s.summary     = "A method for hindering input capabilities within a textarea or text input."
+  s.description = "A method for hindering input capabilities within a textarea or text input. Attempts to disallow text selection, cursor placement, and characters outside of the \"normal\" ASCII print character range."
+
+  s.files         = `git ls-files`.split("\n")
+
+  s.add_dependency "railties", "~> 3.1"
+end
+

data/lib/hinderinputjs-rails/version.rb

@@ -0,0 +1,5 @@
+module Hinderinputjs
+  module Rails
+    VERSION = "0.0.1"
+  end
+end

data/lib/hinderinputjs-rails.rb

@@ -0,0 +1,9 @@
+require "hinderinputjs-rails/version"
+
+module Hinderinputjs
+  module Rails
+    class Engine < ::Rails::Engine
+    end
+  end
+end
+

data/vendor/assets/javascripts/jquery.caret.js

@@ -0,0 +1,45 @@
+/**
+ * A set of methods to manipulate caret position.  Does the world need another set of
+ * these methods? Definitely. :P
+ **/
+(function( $ ) {
+
+  /**
+   *  Set a selection range with the given start and end indicies
+   **/
+  $.fn.setSelection = function( start, end ) {
+    return this.each(function( index, element ){
+      if ( typeof element.setSelectionRange === 'function' ) {
+        element.focus();
+        element.setSelectionRange( start, end );
+      }
+      else if( typeof element.createTextRange === 'function' ) {
+        var range = element.createTextRange();
+          range.collapse( true );
+          range.moveEnd( 'character', start );
+          range.moveStart( 'character', end );
+          range.select();
+      }
+    });
+  };
+
+  /**
+   * Set the position of the cursor to the given index
+   **/
+  $.fn.setCaretPosition = function( pos ) {
+    return this.each(function( index, element ) {
+      $(element).setSelection( pos, pos );
+    });
+  };
+
+  /**
+   *  Set the position of the cursor to the end
+   **/
+  $.fn.setCaretAtEnd = function() {
+    return this.each(function( index, element ) {
+      var length = element.value.length;
+      $(element).setCaretPosition( length, length );
+    });
+  };
+
+})( jQuery );

data/vendor/assets/javascripts/jquery.hinderinput.js

@@ -0,0 +1,115 @@
+/**
+ *  A method for hindering input capabilities within a textarea or text input.  Attempts to disallow text selection,
+ *  cursor placement, and characters outside of the "normal" ASCII print character range.
+ **/
+(function( $ ) {
+
+  /**
+   * Hinder the input capabilites of the selected elements.
+   *
+   * @param {object} options A set of configuration options.
+   *  onAdd: A function called when a character is added.
+   *  onDelete: A function called when a character is deleted.
+   **/
+  var hinderInput = $.fn.hinderInput = function( options ) {
+    var options = $.extend( {}, hinderInput.defaults, options );
+
+    return this.each(function( index, element ) {
+      var $target = $(this);
+
+      $target.keypress(function( event ) {
+        hinderInput.addChar.call( hinderInput, event, options );
+      }).keydown(function( event ) {
+        hinderInput.addSpecial.call( hinderInput, event, options );
+      }).click(function( event ) {
+        $target.setCaretAtEnd();
+      });
+    });
+  };
+
+  /**
+   * The default options for hinderInput.
+   **/
+  hinderInput.defaults = {
+    onAdd: function( value ) {
+      return;
+    },
+    onDelete: function() {
+      return;
+    }
+  };
+
+  /**
+   * Add a character to the input if it's valid.  Execute the onAdd
+   * callback.
+   *
+   * @param {object} event The event that triggered the input.
+   * @param {object} options The options provided to hinderInput.
+   **/
+  hinderInput.addChar = function( event, options ){
+    var $target = $(event.target),
+      keyCode = event.which;
+
+      if ( this.isValidChar( keyCode ) ) {
+        $target.setCaretAtEnd();
+        options.onAdd( String.fromCharCode( keyCode ) );
+      }
+  };
+
+  /**
+   * Apply a special character to the input if it's allowed.  Currently,
+   * only delete is allowed.  Execute the onDelete callback.
+   *
+   * @param {object} event The event that triggered the input.
+   * @param {object} options The options provided to hinderInput.
+   **/
+  hinderInput.addSpecial = function( event, options ) {
+    var $target = $( event.target ),
+      keyCode = event.which;
+
+    $target.setCaretAtEnd();
+
+    if ( this.isModifierPresent( event ) || this.isArrowKey( keyCode ) ) {
+      event.preventDefault();
+      return;
+    }
+
+    if( keyCode === 8 ) {
+      options.onDelete();
+    }
+    // TODO refactor
+    else if( !this.isValidChar(keyCode) ) {
+      event.preventDefault();
+    }
+  };
+
+  /**
+   * Determine if the given key code is within the acceptable
+   * range.
+   *
+   * @param {number} keyCode The char code of the character to check.
+   **/
+  hinderInput.isValidChar = function( keyCode ) {
+    return (keyCode >= 32) && (keyCode <= 126) || (keyCode >= 186) && (keyCode <= 222);
+  };
+
+  /**
+   * Determine if the given key code is an arrow key.
+   *
+   * @param {number} keyCode The char code of the character to check.
+   **/
+  hinderInput.isArrowKey = function( keyCode ) {
+    return [37, 38, 39, 40].indexOf( keyCode ) !== -1;
+  };
+
+  /**
+   * Determine if any modifier keys were present during the given
+   * event.
+   *
+   * @param {object} event The event to check.
+   **/
+  hinderInput.isModifierPresent = function( event ) {
+    return event.altKey || event.ctrlKey || event.metaKey;
+  };
+
+})( jQuery );

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: hinderinputjs-rails
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Morgan Brown
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: A method for hindering input capabilities within a textarea or text input.
+  Attempts to disallow text selection, cursor placement, and characters outside of
+  the "normal" ASCII print character range.
+email:
+- brown.mhg@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- hinderinputjs-rails.gemspec
+- lib/hinderinputjs-rails.rb
+- lib/hinderinputjs-rails/version.rb
+- vendor/assets/javascripts/jquery.caret.js
+- vendor/assets/javascripts/jquery.hinderinput.js
+homepage: https://github.com/discom4rt/hinderinputjs-rails
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -806024439033560381
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -806024439033560381
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A method for hindering input capabilities within a textarea or text input.
+test_files: []