Bring the best of OSS JavaScript development to your projects with npm Orgs - private packages & team management tools.Learn more »

jquery.autobox

3.0.0 • Public • Published a year ago

Autogrow `<textarea>` while typing

Resize the <textarea> (vertically or horizontally) automatically to fit the contents.

Note: This plugin is under development. It is fully operational, but might have some unexpected behaviour.

Getting Started

Download the production version or the development version or use unpkg version directly in your HTML.

In your web page:

<script src="jquery.js"></script>
 
<!-- Include local copy of the lib -->
<script src="dist/jquery.autobox.min.js"></script>
 
<!-- or CDN version -->
<script src="//unpkg.com/jquery.autobox"></script>
 
<script>
jQuery(function($) {
 
    // Bind autobox events to all TEXTAREAs in `.myView` and it's descendants.
    $('.myView').autoboxBind();
 
    // Bind autobox events to `document`, listening on `textarea.autobox` events.
    $(document).autoboxOn('textarea.autobox');
 
    // Adjust once Height/Width of all TEXTAREAs in `.myView` and it's descendants.
    $('.myView').autobox();
 
});
</script>

If you are using a build system:

import jQuery from 'jquery'; // we need jQuery
import autobox from 'jquery.autobox'; // import the init function of the plugin
 
autobox(jQuery); // init the plugin on this copy of jQuery

Documentation

This plugin exports three jQuery methods:

$().autobox() - Adjust Height/Width of all TEXTAREAs in this and it's descendants
$().autoboxOn(sel) - Bind Auto Height/Width Adjustment events to matched element, listening on sel elements
$().autoboxBind() - Bind Auto Height/Width Adjustment events to all TEXTAREAs in this and it's descendants

Examples

<table class="autobox">
    <tr><td>Text field #1</td><td><textarea resize="vertical">Some very important contents</textarea></td></tr>
    <tr><td>Text field #2</td><td><textarea resize="horizontal">Ulgy resize, but may be useful sometimes</textarea></td></tr>
    <tr><td>Text field #3</td><td><textarea style="resize:vertical">CSS resize works too</textarea></td></tr>
</table>
 
<script>
$('body').autoboxOn('.autobox'); // All textareas inside .autobox elements would be autoboxed
</script>

Live example on DUzun.Me.

Release History

v3.0.0

In AMD, CommonJs and ES6 modules jquery.autobox exports the init function only and doesn't initialize automatically.

See Getting Started above.

Keywords

install

npm i jquery.autobox

weekly downloads

version

3.0.0

license

none

homepage

github.com

repository

github

last publish

a year ago

collaborators

Test with RunKit

Report a vulnerability