Skip to content

briancsinger/jquery-character-counter

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 

Repository files navigation

jquery-character-counter

A simple, Twitter style character counter for HTML input fields. Based on your specified limit, the plugin simply adds a span ( by default ) after your HTML input and updates it as you type.

Updates:

  • Added min option to allow for a minimum number of characters allowed

Features:

  • Ctrl & V paste support
  • Right click & paste support
  • Customizable wrapper and css classes
  • Customizable counter format
  • Callbacks for exceeding and deceeding the specified limit

Getting Started

To get started with the character counter, simply reference jQuery and the jQuery Character Counter plugin in your page.

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>	
<script type="text/javascript" src="jquery.charactercounter.js"></script>

Examples

Default Usage

HTML:

<form>
  <textarea id="count_me"></textarea>
</form>

Javascript:

$("#count_me").characterCounter();

Custom Limit

HTML:

<form>
  <textarea id="count_me"></textarea>
</form>

Javascript:

$("#count_me").characterCounter({
  limit: '250'  
});

Options

The following options are currently available:

{
limit: 150,
min: 0,
counterWrapper: 'span',
counterCssClass: 'counter',
counterFormat: '%1',
counterExceededCssClass: 'exceeded',
onExceed: function(count){},
onDeceed: function(count){},
customFields: {}
}

limit - the number of characters you wish to limit.
min - the number of characters you wish to set as the minimum allowed.
counterWrapper - the element you wish to wrap your counter in.
counterCssClass - the CSS class to apply to your counter.
counterFormat - the format of your counter text where '%1' will be replaced with the remaining character count.
counterExceededCssClass - the CSS class to apply when your limit has been exceeded.
onExceed - this function is called when the limit is breached
onDeceed - this function is called when the limit, having previously been exceeded, is now deceeded customFields - key value pairs of custom options to be added to the counter such as class, data attributes etc.

About

A simple, Twitter style character counter for HTML input fields.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%