georgia 0.7.8 → 0.8.0

data/app/assets/javascripts/georgia/vendor/textext.plugin.prompt.js

@@ -0,0 +1,309 @@
+/**
+ * jQuery TextExt Plugin
+ * http://textextjs.com
+ *
+ * @version 1.3.1
+ * @copyright Copyright (C) 2011 Alex Gorbatchev. All rights reserved.
+ * @license MIT License
+ */
+(function($)
+{
+	/**
+	 * Prompt plugin displays a visual user propmpt in the text input area. If user focuses
+	 * on the input, the propt is hidden and only shown again when user focuses on another
+	 * element and text input doesn't have a value.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/18
+	 * @id TextExtPrompt
+	 */
+	function TextExtPrompt() {};
+
+	$.fn.textext.TextExtPrompt = TextExtPrompt;
+	$.fn.textext.addPlugin('prompt', TextExtPrompt);
+
+	var p = TextExtPrompt.prototype,
+
+		CSS_HIDE_PROMPT = 'text-hide-prompt',
+
+		/**
+		 * Prompt plugin has options to change the prompt label and its HTML template. The options
+		 * could be changed when passed to the `$().textext()` function. For example:
+		 *
+		 *     $('textarea').textext({
+		 *         plugins: 'prompt',
+		 *         prompt: 'Your email address'
+		 *     })
+		 *
+		 * @author agorbatchev
+		 * @date 2011/08/18
+		 * @id TextExtPrompt.options
+		 */
+
+		/**
+		 * Prompt message that is displayed to the user whenever there's no value in the input.
+		 *
+		 * @name prompt
+		 * @default 'Awaiting input...'
+		 * @author agorbatchev
+		 * @date 2011/08/18
+		 * @id TextExtPrompt.options.prompt
+		 */
+		OPT_PROMPT = 'prompt',
+
+		/**
+		 * HTML source that is used to generate markup required for the prompt effect.
+		 *
+		 * @name html.prompt
+		 * @default '<div class="text-prompt"/>'
+		 * @author agorbatchev
+		 * @date 2011/08/18
+		 * @id TextExtPrompt.options.html.prompt
+		 */
+		OPT_HTML_PROMPT = 'html.prompt',
+
+		/**
+		 * Prompt plugin dispatches or reacts to the following events.
+		 * @id TextExtPrompt.events
+		 */
+
+		/**
+		 * Prompt plugin reacts to the `focus` event and hides the markup generated from
+		 * the `html.prompt` option.
+		 *
+		 * @name focus
+		 * @author agorbatchev
+		 * @date 2011/08/18
+		 * @id TextExtPrompt.events.focus
+		 */
+
+		/**
+		 * Prompt plugin reacts to the `blur` event and shows the prompt back if user
+		 * hasn't entered any value.
+		 *
+		 * @name blur
+		 * @author agorbatchev
+		 * @date 2011/08/18
+		 * @id TextExtPrompt.events.blur
+		 */
+	
+		DEFAULT_OPTS = {
+			prompt : 'Awaiting input...',
+
+			html : {
+				prompt : '<div class="text-prompt"/>'
+			}
+		}
+		;
+
+	/**
+	 * Initialization method called by the core during plugin instantiation.
+	 *
+	 * @signature TextExtPrompt.init(core)
+	 *
+	 * @param core {TextExt} Instance of the TextExt core class.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/18
+	 * @id TextExtPrompt.init
+	 */
+	p.init = function(core)
+	{
+		var self           = this,
+			placeholderKey = 'placeholder',
+			container,
+			prompt
+			;
+
+		self.baseInit(core, DEFAULT_OPTS);
+		
+		container = $(self.opts(OPT_HTML_PROMPT));
+		$(self).data('container', container);
+
+		self.core().wrapElement().append(container);
+		self.setPrompt(self.opts(OPT_PROMPT));
+		
+		prompt = core.input().attr(placeholderKey);
+
+		if(!prompt)
+			prompt = self.opts(OPT_PROMPT);
+
+		// clear placeholder attribute if set
+		core.input().attr(placeholderKey, '');
+
+		if(prompt)
+			self.setPrompt(prompt);
+
+		if($.trim(self.val()).length > 0)
+			self.hidePrompt();
+
+		self.on({
+			blur           : self.onBlur,
+			focus          : self.onFocus,
+			postInvalidate : self.onPostInvalidate,
+			postInit       : self.onPostInit
+		});
+	};
+
+	//--------------------------------------------------------------------------------
+	// Event handlers
+	
+	/**
+	 * Reacts to the `postInit` and configures the plugin for initial display.
+	 *
+	 * @signature TextExtPrompt.onPostInit(e)
+	 *
+	 * @param e {Object} jQuery event.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/24
+	 * @id TextExtPrompt.onPostInit
+	 */
+	p.onPostInit = function(e)
+	{
+		this.invalidateBounds();
+	};
+
+	/**
+	 * Reacts to the `postInvalidate` and insures that prompt display remains correct.
+	 *
+	 * @signature TextExtPrompt.onPostInvalidate(e)
+	 *
+	 * @param e {Object} jQuery event.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/24
+	 * @id TextExtPrompt.onPostInvalidate
+	 */
+	p.onPostInvalidate = function(e)
+	{
+		this.invalidateBounds();
+	};
+
+	/**
+	 * Repositions the prompt to make sure it's always at the same place as in the text input carret.
+	 *
+	 * @signature TextExtPrompt.invalidateBounds()
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/24
+	 * @id TextExtPrompt.invalidateBounds
+	 */
+	p.invalidateBounds = function()
+	{
+		var self  = this,
+			input = self.input()
+			;
+
+		self.containerElement().css({
+			paddingLeft : input.css('paddingLeft'),
+			paddingTop  : input.css('paddingTop')
+		});
+	};
+
+	/**
+	 * Reacts to the `blur` event and shows the prompt effect with a slight delay which 
+	 * allows quick refocusing without effect blinking in and out.
+	 *
+	 * The prompt is restored if the text box has no value.
+	 *
+	 * @signature TextExtPrompt.onBlur(e)
+	 *
+	 * @param e {Object} jQuery event.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/08
+	 * @id TextExtPrompt.onBlur
+	 */
+	p.onBlur = function(e)
+	{
+		var self = this;
+
+		self.startTimer('prompt', 0.1, function()
+		{
+			self.showPrompt();
+		});
+	};
+
+	/**
+	 * Shows prompt HTML element.
+	 *
+	 * @signature TextExtPrompt.showPrompt()
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/22
+	 * @id TextExtPrompt.showPrompt
+	 */
+	p.showPrompt = function()
+	{
+		var self     = this,
+			input    = self.input()
+			;
+		
+		if($.trim(self.val()).length === 0 && !input.is(':focus'))
+			self.containerElement().removeClass(CSS_HIDE_PROMPT);
+	};
+
+	/**
+	 * Hides prompt HTML element.
+	 *
+	 * @signature TextExtPrompt.hidePrompt()
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/22
+	 * @id TextExtPrompt.hidePrompt
+	 */
+	p.hidePrompt = function()
+	{
+		this.stopTimer('prompt');
+		this.containerElement().addClass(CSS_HIDE_PROMPT);
+	};
+
+	/**
+	 * Reacts to the `focus` event and hides the prompt effect.
+	 *
+	 * @signature TextExtPrompt.onFocus
+	 *
+	 * @param e {Object} jQuery event.
+	 * @author agorbatchev
+	 * @date 2011/08/08
+	 * @id TextExtPrompt.onFocus
+	 */
+	p.onFocus = function(e)
+	{
+		this.hidePrompt();
+	};
+	
+	//--------------------------------------------------------------------------------
+	// Core functionality
+
+	/**
+	 * Sets the prompt display to the specified string.
+	 *
+	 * @signature TextExtPrompt.setPrompt(str)
+	 *
+	 * @oaram str {String} String that will be displayed in the prompt.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/18
+	 * @id TextExtPrompt.setPrompt
+	 */
+	p.setPrompt = function(str)
+	{
+		this.containerElement().text(str);
+	};
+
+	/**
+	 * Returns prompt effect HTML element.
+	 *
+	 * @signature TextExtPrompt.containerElement()
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/08
+	 * @id TextExtPrompt.containerElement
+	 */
+	p.containerElement = function()
+	{
+		return $(this).data('container');
+	};
+})(jQuery);

data/app/assets/javascripts/georgia/vendor/textext.plugin.suggestions.js

@@ -0,0 +1,175 @@
+/**
+ * jQuery TextExt Plugin
+ * http://textextjs.com
+ *
+ * @version 1.3.1
+ * @copyright Copyright (C) 2011 Alex Gorbatchev. All rights reserved.
+ * @license MIT License
+ */
+(function($)
+{
+	/**
+	 * Suggestions plugin allows to easily specify the list of suggestion items that the
+	 * Autocomplete plugin would present to the user.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/18
+	 * @id TextExtSuggestions
+	 */
+	function TextExtSuggestions() {};
+
+	$.fn.textext.TextExtSuggestions = TextExtSuggestions;
+	$.fn.textext.addPlugin('suggestions', TextExtSuggestions);
+
+	var p = TextExtSuggestions.prototype,
+		/**
+		 * Suggestions plugin only has one option and that is to set suggestion items. It could be 
+		 * changed when passed to the `$().textext()` function. For example:
+		 *
+		 *     $('textarea').textext({
+		 *         plugins: 'suggestions',
+		 *         suggestions: [ "item1", "item2" ]
+		 *     })
+		 *
+		 * @author agorbatchev
+		 * @date 2011/08/18
+		 * @id TextExtSuggestions.options
+		 */
+
+		/**
+		 * List of items that Autocomplete plugin would display in the dropdown.
+		 *
+		 * @name suggestions
+		 * @default null
+		 * @author agorbatchev
+		 * @date 2011/08/18
+		 * @id TextExtSuggestions.options.suggestions
+		 */
+		OPT_SUGGESTIONS = 'suggestions',
+
+		/**
+		 * Suggestions plugin dispatches or reacts to the following events.
+		 *
+		 * @author agorbatchev
+		 * @date 2011/08/17
+		 * @id TextExtSuggestions.events
+		 */
+
+		/**
+		 * Suggestions plugin reacts to the `getSuggestions` event and returns `suggestions` items
+		 * from the options.
+		 *
+		 * @name getSuggestions
+		 * @author agorbatchev
+		 * @date 2011/08/19
+		 * @id TextExtSuggestions.events.getSuggestions
+		 */
+
+		/**
+		 * Suggestions plugin triggers the `setSuggestions` event to pass its own list of `Suggestions`
+		 * to the Autocomplete plugin.
+		 *
+		 * @name setSuggestions
+		 * @author agorbatchev
+		 * @date 2011/08/19
+		 * @id TextExtSuggestions.events.setSuggestions
+		 */
+
+		/**
+		 * Suggestions plugin reacts to the `postInit` event to pass its list of `suggestions` to the
+		 * Autocomplete right away.
+		 *
+		 * @name postInit
+		 * @author agorbatchev
+		 * @date 2011/08/19
+		 * @id TextExtSuggestions.events.postInit
+		 */
+
+		DEFAULT_OPTS = {
+			suggestions : null
+		}
+		;
+
+	/**
+	 * Initialization method called by the core during plugin instantiation.
+	 *
+	 * @signature TextExtSuggestions.init(core)
+	 *
+	 * @param core {TextExt} Instance of the TextExt core class.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/18
+	 * @id TextExtSuggestions.init
+	 */
+	p.init = function(core)
+	{
+		var self = this;
+
+		self.baseInit(core, DEFAULT_OPTS);
+
+		self.on({
+			getSuggestions : self.onGetSuggestions,
+			postInit       : self.onPostInit
+		});
+	};
+
+	/**
+	 * Triggers `setSuggestions` and passes supplied suggestions to the Autocomplete plugin.
+	 *
+	 * @signature TextExtSuggestions.setSuggestions(suggestions, showHideDropdown)
+	 *
+	 * @param suggestions {Array} List of suggestions. With the default `ItemManager` it should
+	 * be a list of strings.
+	 * @param showHideDropdown {Boolean} If it's undesirable to show the dropdown right after
+	 * suggestions are set, `false` should be passed for this argument.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/19
+	 * @id TextExtSuggestions.setSuggestions
+	 */
+	p.setSuggestions = function(suggestions, showHideDropdown)
+	{
+		this.trigger('setSuggestions', { result : suggestions, showHideDropdown : showHideDropdown != false });
+	};
+
+	/**
+	 * Reacts to the `postInit` event and triggers `setSuggestions` event to set suggestions list 
+	 * right after initialization.
+	 *
+	 * @signature TextExtSuggestions.onPostInit(e)
+	 *
+	 * @param e {Object} jQuery event.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/19
+	 * @id TextExtSuggestions.onPostInit
+	 */
+	p.onPostInit = function(e)
+	{
+		var self = this;
+		self.setSuggestions(self.opts(OPT_SUGGESTIONS), false);
+	};
+
+	/**
+	 * Reacts to the `getSuggestions` event and triggers `setSuggestions` event with the list
+	 * of `suggestions` specified in the options.
+	 *
+	 * @signature TextExtSuggestions.onGetSuggestions(e, data)
+	 *
+	 * @param e {Object} jQuery event.
+	 * @param data {Object} Payload from the `getSuggestions` event with the user query, eg `{ query: {String} }`.
+	 *
+	 * @author agorbatchev
+	 * @date 2011/08/19
+	 * @id TextExtSuggestions.onGetSuggestions
+	 */
+	p.onGetSuggestions = function(e, data)
+	{
+		var self        = this,
+			suggestions = self.opts(OPT_SUGGESTIONS)
+			;
+
+		suggestions.sort();
+		self.setSuggestions(self.itemManager().filter(suggestions, data.query));
+	};
+})(jQuery);