Skip to content

Latest commit

 

History

History
58 lines (37 loc) · 1.73 KB

README.md

File metadata and controls

58 lines (37 loc) · 1.73 KB

jQuery countChar plugin

A simple counter of characters for multiple form fields based on jQuery

Demo

Example is located here.

Usage

Install via bower:

$ bower install jquery-countchar --save

or via npm:

$ npm install jquery-countchar --save

or download the jquery.countchar.min.js file into your repo.

Then, include script file after the jQuery library and initialize the plugin:

$('.selector').countChar();

Options

You can use the following options as plugin params:

  • text — Text for the counter;
  • textPosition — Text position for the counter: before or after. Defaults to before;
  • limit — Maximum number of characters for each field;
  • limitErrorClass — Error class name for limit. Defaults to countchar-limit-error;
  • outputContainer — Container for output text and counter. Defaults to #countchar-output;
  • onLimitCallback(el, value) — Callback function called when limit condition worked;
  • onCounterCallback(number) — Callback function called each time when it counted the number of characters.

Also, you can add data-countchar and data-countchar-limit attributes to set a regular expression and a characters limit for the current form field. For example:

<input type="text" name="example" data-countchar="[\d]+" data-countchar-limit="10">

It will count only numbers and the maximum number of characters will 10. If the characters will be more, it will add error class to the input element. The priority data-countchar-limit more than the limit parameter.

Release History

  • 1.1.0 — Added npm support.
  • 1.0.0 — Added bower support.

License

MIT © Ilya Fedotov