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.

GitHub

View Github