Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/c0zen/angular-elastic-2


https://github.com/c0zen/angular-elastic-2

Last synced: about 20 hours ago
JSON representation

Awesome Lists containing this project

README

        

Angular Elastic
===============

Elastic (autosize) textareas for AngularJS, without jQuery dependency.

[See it in action](http://monospaced.github.io/angular-elastic).

Usage
-----

as attribute


...

as class


...

optionally append whitespace to the end of the height calculation (an extra newline improves the apperance when animating)


...


...

or configure whitespace globally

app.config(['msdElasticConfig', function(msdElasticConfig) {
msdElasticConfig.append = '\n';
}])

the directive also emits an `elastic:resize` event which you can listen for

$scope.$on('elastic:resize', function(event, element, oldHeight, newHeight) {
// do stuff
});

Single line textareas
--------------

Set the `rows` attribute to `1`, as browsers default to `2`.


...

Install
-------

bower install angular-elastic

npm install angular-elastic

Include the `elastic.js` script provided by this component in your app.

Make sure to add `monospaced.elastic` to your app’s module dependencies.

```
angular
.module('yourApp', [
'monospaced.elastic'
]);
````

Support
-------

__Modern browsers__ only—Internet Explorer 6, 7 & 8 retain their default textarea behaviour.

Demo
----------------

* [monospaced.github.io/angular-elastic](http://monospaced.github.io/angular-elastic)
* [plunker](http://plnkr.co/edit/9y6YLriAwsK9hqdu72WT?p=preview)

How it works
------------

By creating a hidden textarea that mirrors the textarea to which the directive was applied, Angular Elastic can measure the required height and adjust the textarea accordingly. Adjustments are done on:

* Keystroke events
* Window resize events
* Model changes

This works well in most cases with no additional code required other than described in the Usage section above. However, it may occur that the adjustment must be invoked manually at a time that is not covered by the events listed above. E.g. textareas with the style `display: none;` may not have a valid width in Safari which produces incorrect adjustments. In this case the adjustment needs to be invoked once these textareas become visible. For that Angular Elastic listens to the `elastic:adjust` event on its scope. To invoke the adjustment for all textareas covered by Angular Elastic use:

$rootScope.$broadcast('elastic:adjust');

Inspiration
----------------

* [jQuery Autosize](http://www.jacklmoore.com/autosize/)

* [jQuery Elastic](http://unwrongest.com/projects/elastic/)