New Infield Labels jQuery plugin for microapp forms and other future uses.

js/jquery.infieldlabel.js

@@ -0,0 +1,153 @@
+/**
+ * @license In-Field Label jQuery Plugin
+ * http://fuelyourcoding.com/scripts/infield.html
+ *
+ * Copyright (c) 2009-2010 Doug Neiner
+ * Dual licensed under the MIT and GPL licenses.
+ * Uses the same license as jQuery, see:
+ * http://docs.jquery.com/License
+ *
+ * @version 0.1.2
+ */
+(function ($) {
+
+  $.InFieldLabels = function (label, field, options) {
+    // To avoid scope issues, use 'base' instead of 'this'
+    // to reference this class from internal events and functions.
+    var base = this;
+  
+    // Access to jQuery and DOM versions of each element
+    base.$label = $(label);
+    base.label  = label;
+
+    base.$field = $(field);
+    base.field  = field;
+
+    base.$label.data("InFieldLabels", base);
+    base.showing = true;
+
+    base.init = function () {
+      // Merge supplied options with default options
+      base.options = $.extend({}, $.InFieldLabels.defaultOptions, options);
+
+      // Check if the field is already filled in
+      if (base.$field.val() !== "") {
+        base.$label.hide();
+        base.showing = false;
+      }
+
+      base.$field.focus(function () {
+        base.fadeOnFocus();
+      }).blur(function () {
+        base.checkForEmpty(true);
+      }).bind('keydown.infieldlabel', function (e) {
+        // Use of a namespace (.infieldlabel) allows us to
+        // unbind just this method later
+        base.hideOnChange(e);
+      }).bind('paste', function (e) {
+        // Since you can not paste an empty string we can assume
+        // that the fieldis not empty and the label can be cleared.
+        base.setOpacity(0.0);
+      }).change(function (e) {
+        base.checkForEmpty();
+      }).bind('onPropertyChange', function () {
+        base.checkForEmpty();
+      });
+    };
+
+    // If the label is currently showing
+    // then fade it down to the amount
+    // specified in the settings
+    base.fadeOnFocus = function () {
+      if (base.showing) {
+        base.setOpacity(base.options.fadeOpacity);
+      }
+    };
+
+    base.setOpacity = function (opacity) {
+      base.$label.stop().animate({ opacity: opacity }, base.options.fadeDuration);
+      base.showing = (opacity > 0.0);
+    };
+
+    // Checks for empty as a fail safe
+    // set blur to true when passing from
+    // the blur event
+    base.checkForEmpty = function (blur) {
+      if (base.$field.val() === "") {
+        base.prepForShow();
+        base.setOpacity(blur ? 1.0 : base.options.fadeOpacity);
+      } else {
+        base.setOpacity(0.0);
+      }
+    };
+
+    base.prepForShow = function (e) {
+      if (!base.showing) {
+        // Prepare for a animate in...
+        base.$label.css({opacity: 0.0}).show();
+
+        // Reattach the keydown event
+        base.$field.bind('keydown.infieldlabel', function (e) {
+          base.hideOnChange(e);
+        });
+      }
+    };
+
+    base.hideOnChange = function (e) {
+      if (
+          (e.keyCode === 16) || // Skip Shift
+          (e.keyCode === 9) // Skip Tab
+        ) {
+        return; 
+      }
+
+      if (base.showing) {
+        base.$label.hide();
+        base.showing = false;
+      }
+
+      // Remove keydown event to save on CPU processing
+      base.$field.unbind('keydown.infieldlabel');
+    };
+
+    // Run the initialization method
+    base.init();
+  };
+
+  $.InFieldLabels.defaultOptions = {
+    fadeOpacity: 0.5, // Once a field has focus, how transparent should the label be
+    fadeDuration: 300 // How long should it take to animate from 1.0 opacity to the fadeOpacity
+  };
+
+
+  $.fn.inFieldLabels = function (options) {
+    return this.each(function () {
+      // Find input or textarea based on for= attribute
+      // The for attribute on the label must contain the ID
+      // of the input or textarea element
+      var for_attr = $(this).attr('for'), $field;
+      if (!for_attr) {
+        return; // Nothing to attach, since the for field wasn't used
+      }
+
+      // Find the referenced input or textarea element
+      $field = $(
+        "input#" + for_attr + "[type='text']," + 
+        "input#" + for_attr + "[type='search']," + 
+        "input#" + for_attr + "[type='tel']," + 
+        "input#" + for_attr + "[type='url']," + 
+        "input#" + for_attr + "[type='email']," + 
+        "input#" + for_attr + "[type='password']," + 
+        "textarea#" + for_attr
+      );
+
+      if ($field.length === 0) {
+        return; // Again, nothing to attach
+      } 
+
+      // Only create object for input[text], input[password], or textarea
+      (new $.InFieldLabels(this, $field[0], options));
+    });
+  };
+
+}(jQuery));

js/jquery.infieldlabel.min.js

@@ -0,0 +1,13 @@
+/*
+ In-Field Label jQuery Plugin
+ http://fuelyourcoding.com/scripts/infield.html
+
+ Copyright (c) 2009 Doug Neiner
+ Dual licensed under the MIT and GPL licenses.
+ Uses the same license as jQuery, see:
+ http://docs.jquery.com/License
+
+*/
+(function(d){d.InFieldLabels=function(e,b,f){var a=this;a.$label=d(e);a.label=e;a.$field=d(b);a.field=b;a.$label.data("InFieldLabels",a);a.showing=true;a.init=function(){a.options=d.extend({},d.InFieldLabels.defaultOptions,f);if(a.$field.val()!==""){a.$label.hide();a.showing=false}a.$field.focus(function(){a.fadeOnFocus()}).blur(function(){a.checkForEmpty(true)}).bind("keydown.infieldlabel",function(c){a.hideOnChange(c)}).bind("paste",function(){a.setOpacity(0)}).change(function(){a.checkForEmpty()}).bind("onPropertyChange",
+function(){a.checkForEmpty()})};a.fadeOnFocus=function(){a.showing&&a.setOpacity(a.options.fadeOpacity)};a.setOpacity=function(c){a.$label.stop().animate({opacity:c},a.options.fadeDuration);a.showing=c>0};a.checkForEmpty=function(c){if(a.$field.val()===""){a.prepForShow();a.setOpacity(c?1:a.options.fadeOpacity)}else a.setOpacity(0)};a.prepForShow=function(){if(!a.showing){a.$label.css({opacity:0}).show();a.$field.bind("keydown.infieldlabel",function(c){a.hideOnChange(c)})}};a.hideOnChange=function(c){if(!(c.keyCode===
+16||c.keyCode===9)){if(a.showing){a.$label.hide();a.showing=false}a.$field.unbind("keydown.infieldlabel")}};a.init()};d.InFieldLabels.defaultOptions={fadeOpacity:0.5,fadeDuration:300};d.fn.inFieldLabels=function(e){return this.each(function(){var b=d(this).attr("for");if(b){b=d("input#"+b+"[type='text'],input#"+b+"[type='search'],input#"+b+"[type='tel'],input#"+b+"[type='url'],input#"+b+"[type='email'],input#"+b+"[type='password'],textarea#"+b);b.length!==0&&new d.InFieldLabels(this,b[0],e)}})}})(jQuery);