aboutsummaryrefslogtreecommitdiffstats
path: root/template-common/lib/growfield/jquery.growfield.js
diff options
context:
space:
mode:
Diffstat (limited to 'template-common/lib/growfield/jquery.growfield.js')
-rw-r--r--template-common/lib/growfield/jquery.growfield.js330
1 files changed, 330 insertions, 0 deletions
diff --git a/template-common/lib/growfield/jquery.growfield.js b/template-common/lib/growfield/jquery.growfield.js
new file mode 100644
index 000000000..7c8d35468
--- /dev/null
+++ b/template-common/lib/growfield/jquery.growfield.js
@@ -0,0 +1,330 @@
+/** jQuery textarea autogrow plugin
+ * jQuery.1.2.6 required
+ *
+ * optional parameters: // $(elem).growfield( options )
+ * * * * * * * * * * * * * * * * * * *
+ * auto - bool // default = true // if false, ctrl + up/down are enabled
+ * animate - bool // default = true
+ * before(jEvent), after(jEvent) - callbacks // 'this' will be the dom object
+ * min - integer - height in pixels // default = min-height ? css.min-height || initial height
+ * max - integer - height in pixels // maximum size // default = css.max-height || none
+ * restore - bool - restore original size on blur (and back to growed on focus) // default = false
+ * speed - integer - animation speed. not a jquery parameter // default = 300 (ms)
+ * offset - integer - bottom offset // default is calculated for each textarea separately // i don't recommend to touch it :)
+ *
+ * additional functions (public interface):
+ * * * * * * * * * * * * * * * * * * *
+ * $(..).increase( [step] ), decrease( [step] ), growTo( height ), growToggleAuto( bool ), growToggleRestore( bool ),
+ * growSetMin( integer ), growSetMax( integer )
+ *
+ * notes
+ * * * * * * * * * * * * * * * * * * *
+ * parameters may be set in html attributes // tag attributes have priority
+ * <textarea autogrow=1/0 animate=1/0 speed='' line='' min='' max='' restore='' step=''></textarea>
+ *
+ * increase and decrease functions are working only in auto mode
+ *
+ * opera:
+ * in opera, if you don't have border style for textarea, plugin will set it (opera hides borders in overflow:hidden mode).
+ * in auto mode it won't work at all. More than that, opera returns border:2px solid #00000 even if you don't set it. :(
+ *
+ * known problems:
+ * after restore (onfocus) with animation textarea sometimes looses cursor. :( // ff2, ie7xp
+ * when reached maximum height, opera will jitter on every keydown :( // opera < 9.5
+ *
+ * ctrl + up/down:
+ * in opera and ie this shortcut doesn't work properly. But you may use ctrl + whatever + up/down.
+ *
+ * three things that make possible scrollHeight update in opera < 9.5:
+ * (actually, we don't need scrollHeight in opera < 9.5, but we need something to be updated when typing)
+ * height: auto, toggle overflow to hidden and back to auto, and (!!!) padding >= 4px (am i crazy?!)
+ * we need textarea because only in this way we can calculate height with all inherited styles
+ *
+ * @author: johann kuindji (www.kuindji.com, www.stuffedguys.com, www.stuffedtracker.com) jk@kuindji.com
+ * @version 1.1
+ *
+ * example:
+ * $('textarea').growfield();
+ */
+
+(function($){
+$.fn.growfield = function( options ) {
+ this.each( function() {
+ this._growField = true;
+ var txt = $(this);
+ if (this.tagName.toLowerCase() != 'textarea') return false;
+ if (!options) options = {};
+ var th = this;
+ this.gf = {
+ auto: (typeof(options.auto) != 'undefined' ? options.auto : true),
+ animate: (typeof(options.animate) != 'undefined' ? options.animate : true),
+ hOffset: (typeof(options.offset) != 'undefined' ? options.offset : 0),
+ before: (options.before || null), after: (options.after || null),
+ min: (options.min || false), max: (options.max || false), restore: (options.restore || false), initialH:0,
+ busy: false, keysEnabled: false, dummy: null, queue: 0, speed: 300, ms: 15, timeout: false, opera9: false, impossible: false
+ };
+
+ this._growInit = function() {
+ if (this.gf.before) this._growCallbackBefore = this.gf.before;
+ if (this.gf.after) this._growCallbackAfter = this.gf.after;
+ this.gf.initialH = txt.get(0).offsetHeight;
+ if (typeof(txt.attr('autogrow')) != 'undefined') this.gf.auto = parseInt(txt.attr('autogrow'));
+ if (typeof(txt.attr('animate')) != 'undefined') this.gf.animate = parseInt(txt.attr('animate'));
+ if (typeof(txt.attr('min')) != 'undefined') this.gf.min = parseInt(txt.attr('min'));
+ if (typeof(txt.attr('max')) != 'undefined') this.gf.max = parseInt(txt.attr('max'));
+ if (typeof(txt.attr('restore')) != 'undefined') this.gf.restore = parseInt(txt.attr('restore'));
+ if (typeof(txt.attr('speed')) != 'undefined') this.gf.speed = parseInt(txt.attr('speed'));
+ if (!this.gf.min) this.gf.min = parseInt(txt.css('min-height'));
+ if (!this.gf.min) this.gf.min = this.gf.initialH;
+ if (!this.gf.max) this.gf.max = parseInt(txt.css('max-height'));
+ this.gf.opera9 = ($.browser.opera && $.browser.version < 9.5);
+ if (this.gf.restore) { this.gf.restore = false; this._toggleRestore( true );}
+ if (this.gf.auto) {
+ if (this.gf.initialH == 0) { txt.bind('keyup.growinit', this._afterShowInit); }
+ else { this.gf.auto = false; this._toggleAuto( true ); }
+ }
+ else this._toggleKeys( true );
+ return true;
+ };
+
+ this._afterShowInit = function() {
+ this.gf.initialH = txt.get(0).offsetHeight;
+ if (!this.gf.initialH) return true;
+ if (!this.gf.min) this.gf.min = this.gf.initialH;
+ txt.unbind('.growinit');
+ this.gf.auto = false;
+ this._toggleAuto( true );
+ txt.focus();
+ return true;
+ };
+
+ this._toggleKeys = function( on ) {
+ if ( on ) {
+ if (this.gf.keysEnabled) return false;
+ txt.bind( ($.browser.msie? 'keyup':'keydown')+'.autogrow', function( event ) {
+ if (!event.ctrlKey || $.inArray(event.keyCode,[38,40])==-1) return true;
+ txt[ event.keyCode==38 ? 'decrease':'increase' ]( false, event );
+ if ($.browser.opera) txt.focus(); // !!
+ if ($.browser.msie || $.browser.opera) return false;
+ return true;
+ });
+ this.gf.keysEnabled = true;
+ } else {
+ if (!this.gf.keysEnabled) return false;
+ txt.unbind(($.browser.msie? 'keyup':'keydown')+'.autogrow');
+ this.gf.keysEnabled = false;
+ }
+ };
+
+ this._toggleAuto = function( on ) {
+ if ($.browser.opera || on ) {
+ txt.css('overflow', 'hidden');
+ if ($.browser.opera && txt.attr('style') && txt.attr('style').indexOf('border') == -1) txt.css('border', '1px solid #ccc'); // see notes
+ }
+ if ( on ) {
+ if (this.gf.auto) return false;
+ this._toggleKeys( false );
+ this._createDummy();
+ if (this.gf.impossible) { this._growField = false; return false; }
+ txt.css('overflow', 'hidden');
+ txt.bind('keyup.autogrow', function( event ) {
+ if (!txt.val()) this._changeSize(this.gf.min, event );
+ else return this._changeSize(this._textHeight(), event );
+ });
+ if ( txt.val() ) txt.keyup();
+ $(window).bind('resize.autogrow', function( event ) { th.gf.dummy.width( txt.width() );});
+ this.gf.auto = true;
+ } else {
+ if (!this.gf.auto) return false;
+ this.gf.dummy.remove();
+ this.gf.dummy = null;
+ txt.unbind('keyup.autogrow');
+ $(window).unbind('resize.autogrow');
+ txt.css('overflow', 'auto');
+ this.gf.auto = false;
+ this._toggleKeys( true );
+ }
+ return true;
+ };
+
+ this._toggleRestore = function( on ) {
+ if ( on ) {
+ if (this.gf.restore) return false;
+ this.gf.restore = true;
+ txt.bind('focus.autogrow', function( event, noChange ) {
+ if (!this.gf.auto || noChange || !txt.val()) return true;
+ else return this._changeSize(this._textHeight(), event );
+ });
+ txt.bind('blur.autogrow', function( event ) { return this.gf.auto ? this._changeSize( this.gf.min, event ) : true; });
+ } else {
+ if (!this.gf.restore) return false;
+ this.gf.restore = false;
+ txt.unbind('focus.autogrow').unbind('blur.autogrow');
+ txt.keyup();
+ }
+ };
+
+ this._changeSize = function( to, event ) {
+ if (this.gf.busy) return true;
+ if (!event) event = {};
+ this._growBefore( event );
+ var ovr = txt.css('overflow');
+
+ if (this.gf.max > 0 && to >= this.gf.max) { // if we have reached the maximum height
+ to = this.gf.max;
+ if (ovr == 'hidden') { // if overflow is still hidden, we need to switch it to auto so that user could see the text
+ txt.css('overflow', 'auto');
+ if (event.type=='keyup') txt.focus();
+ if (event.type=='focus' && this.gf.animate && this.gf.auto) txt.trigger('focus', true);
+ }
+ }
+ else if (ovr=='auto' && this.gf.auto) { // if there is a space left (or no maximum is defined)
+ txt.css('overflow', 'hidden'); // we need to switch overflow back to hidden
+ if (event.type=='keyup') txt.focus(); // focus event is neccessary
+ }
+ if (this.gf.min > 0 && to <= this.gf.min) to = this.gf.min; // if we have minimum height
+
+ if (to == txt.get(0).offsetHeight) {this.gf.busy=false; return true;}
+
+ return this._animate( txt.get(0).offsetHeight, to, event, ovr);
+ };
+
+ this._animate = function( from, to, event, ovr ) {
+ if (!this.gf.animate || (ovr == 'auto' && this.gf.auto) || event.type == 'init' ) {
+ txt.height( to );
+ return this._growAfter( event );
+ }
+ this.gf.queue = Math.floor((this.gf.speed / this.gf.ms) * ( to < from ? -1 : 1));
+ this._timeout( from, to );
+ return true;
+ };
+
+ this._timeout = function( from, to ) {
+ if (th.gf.queue==0) return th._growAfter();
+ th.gf.queue += (th.gf.queue > 0 ? -1 : 1);
+ if ( Math.abs(to-from)<3 ) {
+ txt.height( to );
+ return th._growAfter();
+ }
+ from = th.gf.queue == 0 ? to : from + Math.ceil( (to-from) /2);
+ txt.height( from );
+ th.gf.timeout = window.setTimeout(function(){ th._timeout(from, to) }, th.gf.ms);
+ };
+
+ this._textHeight = function() {
+ var val = txt.val();
+ if ($.browser.safari && val.substr(-2) == "\n\n") val = val.substring(0,val.length-2)+"\n11"; // empty row fix for safari
+ if ($.browser.safari) this.gf.dummy.val(''); // another fix for safari
+ this.gf.dummy.val(val);
+ if (this.gf.opera9) this.gf.dummy.css('overflow', 'hidden').css('overflow', 'auto');
+ var d = this.gf.dummy.get(0);
+ if (this.gf.opera9) return d.clientHeight + this.gf.hOffset;
+ if ((d.scrollHeight + ($.browser.safari ? 1 : 0)) > d.clientHeight) {
+ return d.scrollHeight +( d.offsetHeight-d.clientHeight) + this.gf.hOffset + ($.browser.safari ? this.gf.hOffset : 0);
+ }
+ else {
+ if ( !txt.val()) return this.gf.min;
+ else return d.offsetHeight + this.gf.hOffset;
+ }
+ };
+
+ this._createDummy = function() {
+ if (this.gf.dummy) { this.gf.dummy.remove(); this.gf.dummy = false; }
+ var i = true; var tryPadding = false;
+ while (i) {
+ this.gf.dummy = txt.clone().css({position:'absolute', left:-9999, top:0, visibility: 'hidden', width: txt.get(0).offsetWidth}).attr('tabindex', -9999);
+ // in hidden mode opera < 9.5 doesn't update scrollHeight, but if we change overflow every time, it almost works
+ if (this.gf.opera9) {
+ this.gf.dummy.css({overflow:'auto', height:'auto'});
+ var padding = txt.css('padding');
+ if ((padding && padding< 4) || tryPadding) this.gf.dummy.css({padding: '4px'}); // !!!! only with padding textarea will update scrollHeight
+ }
+ this.gf.dummy.get(0)._growField = false;
+ txt.after(this.gf.dummy);
+ this.gf.dummy.val('').height(10);
+ this.gf.dummy.val("11");
+ if (this.gf.opera9) this.gf.dummy.css('overflow', 'hidden').css('overflow', 'auto');
+ var s1 = this.gf.dummy.get(0).scrollHeight;
+ this.gf.dummy.val("11\n11");
+ if (this.gf.opera9) this.gf.dummy.css('overflow', 'hidden').css('overflow', 'auto');
+ var s2 = this.gf.dummy.get(0).scrollHeight;
+ if (!this.gf.hOffset) {
+ this.gf.hOffset = s2-s1;
+ if ($.browser.opera && !this.gf.opera9) this.gf.hOffset += this.gf.dummy.get(0).offsetHeight - this.gf.dummy.height();
+ }
+ if (this.gf.opera9 && this.gf.hOffset==0) {
+ if (tryPadding) i=false;
+ else { tryPadding=true; this.gf.dummy.remove(); continue; }
+ }
+ else i=false;
+ }
+ };
+
+ this._growBefore = function( event ) { this.gf.busy = true; this._growCallbackBefore( event ); };
+ this._growAfter = function( event ) {
+ if (this.gf.timeout) {
+ window.clearTimeout(this.gf.timeout);
+ this.gf.timeout = false;
+ }
+ this.gf.busy = false;
+ this._growCallbackAfter( event );
+ return true;
+ };
+ this._growCallbackBefore = function() {};
+ this._growCallbackAfter = function() {};
+ $(function() { th._growInit(); });
+ });
+};
+
+$.fn.increase = function( step, event ) { this.each( function() {
+ if (!this._growField || this.gf.auto) return true;
+ this._changeSize( this.offsetHeight + (step ? parseInt(step) : this.gf.hOffset), event);
+});};
+$.fn.decrease = function( step, event ) { this.each( function() {
+ if (!this._growField || this.gf.auto) return true;
+ this._changeSize( this.offsetHeight - (step ? parseInt(step) : this.gf.hOffset), event);
+});};
+$.fn.growToggleAuto = function( bool ) {
+ if (bool && bool != true && bool != false && bool.toLowerCase() != 'on' && bool.toLowerCase() != 'off') delete(bool);
+ if (bool && typeof(bool)=='string') bool = bool.toLowerCase()=='on' ? true: false;
+ this.each( function() {
+ if (!this._growField) return true;
+ this._toggleAuto(bool);
+});};
+$.fn.growToggleAnimation = function( bool ) {
+ if (bool && bool != true && bool != false && bool.toLowerCase() != 'on' && bool.toLowerCase() != 'off') delete(bool);
+ if (bool && typeof(bool)=='string') bool = bool.toLowerCase()=='on' ? true: false;
+ this.each( function() {
+ if (!this._growField) return true;
+ this.gf.animate = bool;
+});};
+$.fn.growTo = function( h ) { this.each( function() {
+ if (!this._growField) return true;
+ this._changeSize(h);
+});};
+$.fn.growSetMin = function( h ) { this.each( function() {
+ if (!this._growField) return true;
+ h = parseInt(h);
+ if (h < 10 && this.gf.initialH) h = this.gf.initialH;
+ if (h < 10) return true;
+ this.gf.min = parseInt(h);
+ if (this.offsetHeight < this.gf.min) $(this).growTo(this.gf.min);
+});};
+$.fn.growSetMax = function( h ) { this.each( function() {
+ if (!this._growField) return true;
+ this.gf.max = parseInt(h);
+ if (this.offsetHeight > this.gf.max) $(this).growTo(this.gf.max);
+});};
+$.fn.growToggleRestore = function( bool ) {
+ if (bool && bool != true && bool != false && bool.toLowerCase() != 'on' && bool.toLowerCase() != 'off') delete(bool);
+ if (bool && typeof(bool)=='string') bool = bool.toLowerCase()=='on' ? true: false;
+ this.each( function() {
+ if (!this._growField) return true;
+ this._toggleRestore( bool );
+});};
+$.fn.growRenewDummy = function() { this.each(function(){
+ if (!this._growField) return true;
+ this._createDummy();
+});};
+
+})(jQuery); \ No newline at end of file