Skip to content
Give your forms a helping of awesome!
JavaScript
Find file
Pull request Compare This branch is 23 commits behind remybach:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
README.md
jquery.superLabels.js
jquery.superLabels.min.js

README.md

jQuery Super Labels Plugin

About

This plugin was born out of the need to use the label-over-field method for forms I was working on. There are other plugins out there that do pretty much the same thing, but none of them had the - for lack of a better word - sexiness that I was looking for. This implementation makes the label slide across the field☨ when gaining focus and fade out when a value is entered.

This method only really works for the following: input[type="text"], input[type="search"], input[type="url"], input[type="tel"], input[type="email"], input[type="password"], input[type="number"], textarea, and finally there's select field support thrown in too.

☨ Uses the easing plugin if available.

Demo

Here's a (very) simple demo of Super Labels in action.

Usage

You need to make sure that the element containing both the field and the label has position:relative;. Other than that, the plugin should have enough flexibility to handle most of your needs.

Basic

The quickest and easiest way to use this plugin is as follows:

// Don't forget to do this *after* the DOM has loaded.
jQuery(function($) {
    $('form').superLabels();
});

Running the plugin on a form will automatically apply the magic to the accepted fields listed above.

If you find that you need to position the labels slightly differently, pass in labelLeft and/or labelTop as follows:

$('form').superLabels({
    labelLeft:5,
    labelTop:5
});

Lastly, you can choose to ONLY apply superLabels to specific fields if you wish by selecting them instead of the form as follows:

$('input.foo, textarea.bar, select.baz').superLabels();

Advanced

There are quite a number of options you can pass the plugin additional to the two I mentioned above:

  • baseZindex - The base z-index which we display on top of. (default: 0)
  • debug - Whether or not to show console messages. (default: false)
    • Note: this is not available in the minified version.
  • duration - Time of the slide in milliseconds. (default: 500)
  • easingIn - The easing in function to use for the slide. (default: 'easeInOutCubic')
  • easingOut - The easing out function to use for the slide. (default: 'easeInOutCubic')
  • fadeDuration - Duration of animation when it's fade only. (default: 250)
  • labelLeft - The distance from the left for the label. (default: 0)
    • You can pass in 'px' if you're the pedantic type. For example: labelLeft:'5px'
  • labelTop - The distance from the top for the label. (default: 0)
    • As above: labelTop:'5px'
  • noAnimate - Whether or not to animate. If set to true, will function the same as a normal placeholder. (default:false)
    • This is a 'just in case' option that can/should be used when there are performance issues with animating.
  • opacity - The opacity to fade the label to. (default: 0.5)
  • slide - Whether or not to slide the label across the input field. (default: true)
  • wrapSelector - The selector for the element you have wrapping each field. (default: false)
    • This is used to find the label - use as a last resort. Rather make sure the field and label are next to each other in your markup, or failing that, that your labels use the for attribute that point to the field's name or id.

Concerning placeholders

According to the spec placeholders are meant to be used to represent "a short hint (a word or short phrase) intended to aid the user with data entry." NOT as a replacement for labels.

The way superLabels uses placeholders (as of version 1.1.1) is as follows:

  • If there is a label AND a placeholder for the field, the placeholder becomes the label's title so that it shows up when you hover over the label.
  • If there is JUST the placeholder, it becomes the label for the field.

Known Bugs

Below I'll list any bugs that I'm aware of and will try to get around to fixing as soon as I can.

  • Auto filling of form fields that is performed by some browsers (other than Chrome) causes a visual bug. Currently the label stays visible and positioned on top of the field while the field has a value. I've found a bug report for Firefox here.

License

MIT License - http://remybach.mit-license.org/

Something went wrong with that request. Please try again.