BootStrap MaxLength Logo

Bootstrap Maxlength a visual feedback indicator for the maxlength attribute.

Vote on Hacker News
Tweet
Download View Project on GitHub
(追記) (追記ここまで)

Bootstrap-Maxlength uses a Twitter Bootstrap label to show a visual feedback to the user about the maximum length of the field where the user is inserting text. Uses the HTML5 attribute "maxlength" to work.

Bootstrap MaxLength - Demo

Default usage

The badge will show up by default when the remaining chars are 10 or less:

$('input[maxlength]').maxlength();

Change the threshold value

Do you want the badge to show up when there are 20 chars or less? Use the threshold option:


 $('input.className').maxlength({
 threshold: 20
 });
 

Few options


 $('input.className').maxlength({
 alwaysShow: true,
 threshold: 10,
 warningClass: "label label-success",
 limitReachedClass: "label label-danger"
 });
 

All the options

This is a complete example where all the options configured for the bootstrap-maxlength counter are setted.

Please note: if the alwaysShow option is enabled, the threshold option is ignored.


 $('input.className').maxlength({
 alwaysShow: true,
 threshold: 10,
 warningClass: "label label-success",
 limitReachedClass: "label label-danger",
 separator: ' of ',
 preText: 'You have ',
 postText: ' chars remaining.',
 validate: true
 });
 

What about textareas?

Bootstrap maxlength supports textarea as well as inputs. Even on old IE.


 $('textarea#textarea').maxlength({
 alwaysShow: true
 });
 

Let's play with the position

The field counter can be positioned at the top, bottom, left or right. You can also place the maxlength indicator on the corners: bottom-right, top-right, top-left, bottom-left and centered-right.
All you need to do is specify the placement option, with one of those strings. If none is specified, the positioning will be defauted to 'bottom'.


 $('input#placement').maxlength({
 alwaysShow: true,
 placement: 'top-left'
 });
 

Changelog

1.7.0

  • Restructured distribution files position from root folder to /dist folder

1.6.1

  • Added more tests around the functionalities of the plugin.
  • Fixed issues around the alwaysShow option

1.6.0

  • Added new custom events: maxlength.reposition, maxlength.shown, maxlength.hidden. Thanks to dr-nick.
  • Buped up required jQuery to 1.9.x
  • Added option placement for custom placement handler. Thanks to Kreegr
  • Extended message option. Now it can also be optionally a function. Thanks to Vincent Pizzo

1.5.7

  • Fixed issue with bower

1.5.6

  • Added over maxlength functionality with customMaxAttribute
  • Added twoCharLinebreak option

1.5.5

  • Implemented input event rather than keydown to improve usability
  • Fixed jshint, jscs errors

1.5.4

  • When an input with associated maxlength element is removed, maxlength is also removed.

1.5.3

  • Fixed #40, error on resize event.

1.5.2

  • Fixed #44 (pasted text in can cause it to go over the max length)

1.5.1

  • Added self protection of multiple focus events
  • Added back detection of window resizing

1.5.0

  • Removed window.resize
  • Maxlenght is created and destroyed each time
  • Fixed Doesn't update the limit after input's maxlength attribute was changed ( #31 )
  • Added Gruntfile
  • Added qunit unit tests

1.4.3

  • Added message option, thanks to gg
  • Added UFT8 option, thanks to Abdullah Al
  • Fixed z-index in modal windows Issue #23

1.4.2

  • Fixed issue with counting when the user moves with shift+tab keyboard shortcut.
  • Replaced the warningClass limitReachedClass options to use labels rather than badges for Bootstrap 3.0 better compatibility.

1.4.1

  • Added support for TAB key when the maxlength is reached.

Fork me on GitHub

AltStyle によって変換されたページ (->オリジナル) /