Skip to content

alexweber/jquery.coolinput

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 

Repository files navigation

CoolInput

CoolInput is a straightforward and lightweight input-hint plugin for jQuery that defers to HTML5 when possible. It supports a lot of custom options but has sensible defaults and can be easily used out of the box.

In short, it just works!

  • Requires jQuery 1.2.6+

Version 2.1

This version introduces one backwards-incompatible change: the "iconClass" option has been renamed to "extraClass". Please update your code!

Example

// Simplest call, will use text from input's "title" attribute for hint.
$('.selector').coolinput();

// You can also manually specify the hint's text.
$('.selector').coolinput('foo');

// You can also pass an object to override a few options.
$('.selector').coolinput({
  useHtml5:true, // Use HTML5's native placeholders when possible.
  hint:null, // Input hint text.
  source:"title", // Source attribute for input hint text. Overrides "hint".
  removeSource:true, // Remove the source attribute after reading its value.
  blurClass:"blur", // Add a class to the input when it loses focus.
  extraClass:false, // Extra classes to ad to the input.
  clearOnSubmit:true, // Clear the input hint when the form is submitted (so an empty value is submitteed).
  clearOnFocus:true, // Clear the input hint when the input is focused.
  persistent:true // If set to false, the input hint will only be visible the first time an input is seen.
});

// And, as usual, it's totally chainable can be chained.
$('.selector').find('.other-selector').coolinput().addClass('foo');

Authors

CoolInput was created by Alex Weber and a significant contribution was made by Evan Winslow in version 1.5

License

CoolInput is dual-licensed under the MIT License and the GNU General Public License.

Copyright (c) 2008-2012 Alex Weber

About

jQuery Input Hint Plugin

Resources

Stars

Watchers

Forks

Packages

No packages published