DIR : /home/kozerus/public_html/pn/uize/site-source/js/Uize/Widget/FormElement/Text.js

/home/kozerus/public_html/pn/uize/site-source/js/Uize/Widget/FormElement

/*______________
|       ______  |   U I Z E    J A V A S C R I P T    F R A M E W O R K
|     /      /  |   ---------------------------------------------------
|    /    O /   |    MODULE : Uize.Widget.FormElement.Text Class
|   /    / /    |
|  /    / /  /| |    ONLINE : http://www.uize.com
| /____/ /__/_| | COPYRIGHT : (c)2007-2016 UIZE
|          /___ |   LICENSE : Available under MIT License or GNU General Public License
|_______________|             http://www.uize.com/license.html
*/

/* Module Meta Data
	type: Class
	importance: 7
	codeCompleteness: 100
	docCompleteness: 0
*/

/*?
	Introduction
		The =Uize.Widget.FormElement.Text= class is a subclass of =Uize.Widget.FormElement= to provide specific functionality for text input form elements.

		*DEVELOPERS:* `Tim Carter`, `Ben Ilegbodu`, `Vinson Chuong`, original code contributed by `Zazzle Inc.`
*/

Uize.module ({
	name:'Uize.Widget.FormElement.Text',
	builder:function (_superclass) {
		'use strict';

		var
			/*** Variables for Scruncher Optimization ***/
				_undefined,

			/*** General Variables ***/
				_supportsPlaceholder = typeof document != 'undefined' && 'placeholder' in document.createElement('input')
		;

		/*** Private Instance Methods ***/
			function _updateMoreValidators () {
				var m = this;

				m._moreValidators = [
					function (_value) {
						var
							_valueString = _value + '',
							_valueLength = _value != null ? _valueString.length : 0
						;

						return _valueLength >= m._minLength && _valueLength <= m._maxLength;
					}
				];
			}
			
			function _updateUiMaxLength () {
				this.isWired
					&& this.setNodeProperties('input', {maxLength:this._maxLength})
				;
			}

			function _updateUiPlaceholder () {
				this.isWired
					&& _supportsPlaceholder
					&& this.setNodeProperties('input', {placeholder:this._placeholder})
				;
			}

		return _superclass.subclass ({
			omegastructor:function () {
				var m = this;

				m.wire(
					'Changed.focused',
					function (_event) {
						if (m.isWired) {
							var
								_focused = _event.newValue,
								_placeholder = m._placeholder,
								_value = m.valueOf()
							;

							if (_placeholder && !_supportsPlaceholder) {
								var _newText;
								if (_focused && _value == _placeholder)
									_newText = '';
								else if (!_focused && !_value)
									_newText = _placeholder
								;
								_newText != _undefined && m.setNodeValue ('input', _newText);
							}

							_focused
								&& _value
								&& m.setCaretPosition(_value.length);
						}
					}
				);

				_updateMoreValidators.call (m);
			},

			instanceMethods:{
				checkIsEmpty:function () {
					return _superclass.doMy (this,'checkIsEmpty') || this.valueOf() == this._placeholder;
				},

				getCaretPosition:function () {
					var
						m = this,
						_caretPosition = -1
					;

					if (m.isWired && m.get ('focused')) {
						var _input = m.getNode ('input');
						if ('selectionStart' in _input)
							_caretPosition = _input.selectionStart;
						else if (_input.createTextRange) {
							var _sel = _input.createTextRange ();
							_sel.moveStart ('character', -m.get ('tentativeValue').length);
							_caretPosition = _sel.text.length;
						}
					}

					return _caretPosition;
				},

				select:function(_startPosition, _endPosition) {
					var m = this;

					if (m.isWired) {
						var
							_input = m.getNode ('input'),
							_value = m.valueOf()
						;

						m.set('focused', true);

						if (_value) {
							if (_startPosition == _undefined)
								_input.select();
							else {
								_endPosition = _endPosition == _undefined ? _value.length : _endPosition;

								if (_input.setSelectionRange)
									try { _input.setSelectionRange (_startPosition, _endPosition); }
									catch (_err) { }
								else if (_input.createTextRange) {
									var _range = _input.createTextRange ();
									_range.collapse (true);
									_range.moveEnd ('character', _endPosition);
									_range.moveStart ('character', _startPosition);
									_range.select ();
								}
							}
						}
					}
				},

				setCaretPosition:function (_position) { this.select(_position, _position) },

				getMoreValidators:function () { return this._moreValidators },

				updateUi:function () {
					if (this.isWired) {
						_updateUiMaxLength.call (this);
						_updateUiPlaceholder.call (this);
						_superclass.doMy (this,'updateUi');
					}
				},

				wireUi:function () {
					var m = this;

					if (!m.isWired) {
						var
							_placeholder = m._placeholder,
							_input = m.getNode ('input')
						;

						// Set input placeholder
						if (_placeholder) {
							if (_supportsPlaceholder)
								m.setNodeProperties (_input, {placeholder:_placeholder});
							else
								m.set ('value', _placeholder);
						}

						_superclass.doMy (m,'wireUi');
					}
				}
			},

			stateProperties:{
				_placeholder:{
					name:'placeholder|defaultValue',
					onChange:_updateUiPlaceholder,
					value:''
				},
				_minLength:{
					name:'minLength',
					onChange:_updateMoreValidators,
					value:0
				},
				_maxLength:{
					name:'maxLength',
					onChange:[
						_updateUiMaxLength,
						_updateMoreValidators
					],
					value:32767
				}
			}
		});
	}
});