Skip to content

aaronrussell/jquery-simply-countable

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 

Repository files navigation

jQuery Simply Countable plugin

jQuery plugin that provides a character counter for any text input or textarea. Works when typing and pasting text using the mouse.

Usage

Simple usage:

$('#my_textarea').simplyCountable(); 

Advanced usage:

$('#my_textarea').simplyCountable({ counter: '#counter', countType: 'characters', maxCount: 140, strictMax: false, countDirection: 'down', safeClass: 'safe', overClass: 'over', thousandSeparator: ',', onOverCount: function(count, countable, counter){}, onSafeCount: function(count, countable, counter){}, onMaxCount: function(count, countable, counter){} }); 

Options

  • counter - A jQuery selector to match the 'counter' element. Defaults to #counter.
  • countType - Select whether to count characters or words. Defaults to characters.
  • maxCount - The maximum character (or word) count of the text input or textarea. Defaults to 140.
  • strictMax - Prevents the user from being able to exceed the maxCount. Defaults to false.
  • countDirection - Select whether to count down or up. Defaults to down.
  • safeClass - The CSS class applied to the counter element when it is within the maxCount figure. Defaults to safe.
  • overClass - The CSS class applied to the counter element when it exceeds the maxCount figure. Defaults to over.
  • thousandSeparator - The separator for multiples of 1,000. Set to false to disable. Defaults to ,.
  • onOverCount - Callback function called when counter goes over maxCount figure.
  • onSafeCount - Callback function called when counter goes below maxCount figure.
  • onMaxCount - Callback function called when in strictMax mode and counter hits maxCount figure.

License

Dual licensed under the MIT and GPL licenses.

Copyright (c) 2009-2013 Aaron Russell.

About

jQuery plugin that provides a character counter for any text input or textarea.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •