textfill_rails 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a09da61355a5b3f18068049407b9a3d336624bcd
+  data.tar.gz: fe3027d5247d7e9eb7c5484f2efbfe819e910385
+SHA512:
+  metadata.gz: 8e29ab11a0ce3820ace39e44dc85314de519be78488b3a64e980ef3a33cb9dd627fe9fa9373c4411ac8ff6d5f017cb26fb1f6525ee3f8c11891a205c130fc6c6
+  data.tar.gz: a3e6fc83f2ff6bae6d3897c49c9ca7af15d53d30833683173ba2f772e89a38acd4dbc7f582fd5f8d67c5998b36eb91d49509fee2a6c5339fd8345da594a28e2e

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+.config
+Gemfile.lock
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in textfill_rails.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Steven Spiel
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,35 @@
+# TextfillRails
+
+textfill_rails wraps the [textfill.js](http://jquery-textfill.github.io/) library in a rails engine for simple use with the asset pipeline provided by rails 3.1 and up. The gem includes the development (non-minified) source for ease of exploration. the asset pipleline will do the heavy lifting and minify it for you in production.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'textfill_rails'
+
+Add the following directive to your Javascript manifest file below the jquery directive (application.js):
+
+    //= require textfill
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install textfill_rails
+
+## Usage
+
+just use it as your would normally would
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/app/assets/javascripts/textfill.js

@@ -0,0 +1,324 @@
+/**
+ * @preserve  textfill
+ * @name      jquery.textfill.js
+ * @author    Russ Painter
+ * @author    Yu-Jie Lin
+ * @author    Alexandre Dantas
+ * @version   0.6.0
+ * @date      2014-08-19
+ * @copyright (c) 2014 Alexandre Dantas
+ * @copyright (c) 2012-2013 Yu-Jie Lin
+ * @copyright (c) 2009 Russ Painter
+ * @license   MIT License
+ * @homepage  https://github.com/jquery-textfill/jquery-textfill
+ * @example   http://jquery-textfill.github.io/jquery-textfill/index.html
+ */
+; (function($) {
+
+	/**
+	 * Resizes an inner element's font so that the
+	 * inner element completely fills the outer element.
+	 *
+	 * @param {Object} options User options that take
+	 *                         higher precedence when
+	 *                         merging with the default ones.
+	 *
+	 * @return All outer elements processed
+	 */
+	$.fn.textfill = function(options) {
+
+		// ______  _______ _______ _______ _     _        _______ _______
+		// |     \ |______ |______ |_____| |     | |         |    |______
+		// |_____/ |______ |       |     | |_____| |_____    |    ______|
+        //
+		// Merging user options with the default values
+
+		var defaults = {
+			debug            : false,
+			maxFontPixels    : 40,
+			minFontPixels    : 4,
+			innerTag         : 'span',
+			widthOnly        : false,
+			success          : null, // callback when a resizing is done
+			callback         : null, // callback when a resizing is done (deprecated, use success)
+			fail             : null, // callback when a resizing is failed
+			complete         : null, // callback when all is done
+			explicitWidth    : null,
+			explicitHeight   : null,
+			changeLineHeight : false
+		};
+
+		var Opts = $.extend(defaults, options);
+
+		// _______ _     _ __   _ _______ _______ _____  _____  __   _ _______
+		// |______ |     | | \  | |          |      |   |     | | \  | |______
+		// |       |_____| |  \_| |_____     |    __|__ |_____| |  \_| ______|
+		//
+		// Predefining the awesomeness
+
+		// Output arguments to the Debug console
+		// if "Debug Mode" is enabled
+		function _debug() {
+			if (!Opts.debug
+				||  typeof console       == 'undefined'
+				||  typeof console.debug == 'undefined') {
+				return;
+			}
+			console.debug.apply(console, arguments);
+		}
+
+		// Output arguments to the Warning console
+		function _warn() {
+			if (typeof console      == 'undefined' ||
+				typeof console.warn == 'undefined') {
+				return;
+			}
+			console.warn.apply(console, arguments);
+		}
+
+		// Outputs all information on the current sizing
+		// of the font.
+		function _debug_sizing(prefix, ourText, maxHeight, maxWidth, minFontPixels, maxFontPixels) {
+
+			function _m(v1, v2) {
+
+				var marker = ' / ';
+
+				if (v1 > v2)
+					marker = ' > ';
+
+				else if (v1 == v2)
+					marker = ' = ';
+
+				return marker;
+			}
+
+			_debug(
+				'[TextFill] '  + prefix + ' { ' +
+				'font-size: ' + ourText.css('font-size') + ',' +
+				'Height: '    + ourText.height() + 'px ' + _m(ourText.height(), maxHeight) + maxHeight + 'px,' +
+				'Width: '     + ourText.width()  + _m(ourText.width() , maxWidth)  + maxWidth + ',' +
+				'minFontPixels: ' + minFontPixels + 'px, ' +
+				'maxFontPixels: ' + maxFontPixels + 'px }'
+			);
+		}
+
+		/**
+		 * Calculates which size the font can get resized,
+		 * according to constrains.
+		 *
+		 * @param {String} prefix Gets shown on the console before
+		 *                        all the arguments, if debug mode is on.
+		 * @param {Object} ourText The DOM element to resize,
+		 *                         that contains the text.
+		 * @param {function} func Function called on `ourText` that's
+		 *                        used to compare with `max`.
+		 * @param {number} max Maximum value, that gets compared with
+		 *                     `func` called on `ourText`.
+		 * @param {number} minFontPixels Minimum value the font can
+		 *                               get resized to (in pixels).
+		 * @param {number} maxFontPixels Maximum value the font can
+		 *                               get resized to (in pixels).
+		 *
+		 * @return Size (in pixels) that the font can be resized.
+		 */
+		function _sizing(prefix, ourText, func, max, maxHeight, maxWidth, minFontPixels, maxFontPixels) {
+
+			_debug_sizing(
+				prefix, ourText,
+				maxHeight, maxWidth,
+				minFontPixels, maxFontPixels
+			);
+
+			// The kernel of the whole plugin, take most attention
+			// on this part.
+			//
+			// This is a loop that keeps increasing the `font-size`
+			// until it fits the parent element.
+			//
+			// - Start from the minimal allowed value (`minFontPixels`)
+			// - Guesses an average font size (in pixels) for the font,
+			// - Resizes the text and sees if its size is within the
+			//   boundaries (`minFontPixels` and `maxFontPixels`).
+			//   - If so, keep guessing until we break.
+			//   - If not, return the last calculated size.
+			//
+			// I understand this is not optimized and we should
+			// consider implementing something akin to
+			// Daniel Hoffmann's answer here:
+			//
+			//     http://stackoverflow.com/a/17433451/1094964
+			//
+
+			while (minFontPixels < (maxFontPixels - 1)) {
+
+				var fontSize = Math.floor((minFontPixels + maxFontPixels) / 2);
+				ourText.css('font-size', fontSize);
+
+				if (func.call(ourText) <= max) {
+					minFontPixels = fontSize;
+
+					if (func.call(ourText) == max)
+						break;
+				}
+				else
+					maxFontPixels = fontSize;
+
+				_debug_sizing(
+					prefix, ourText,
+					maxHeight, maxWidth,
+					minFontPixels, maxFontPixels
+				);
+			}
+
+			ourText.css('font-size', maxFontPixels);
+
+			if (func.call(ourText) <= max) {
+				minFontPixels = maxFontPixels;
+
+				_debug_sizing(
+					prefix + '* ', ourText,
+					maxHeight, maxWidth,
+					minFontPixels, maxFontPixels
+				);
+			}
+			return minFontPixels;
+		}
+
+		// _______ _______ _______  ______ _______
+		// |______    |    |_____| |_____/    |
+		// ______|    |    |     | |    \_    |
+        //
+		// Let's get it started (yeah)!
+
+		_debug('[TextFill] Start Debug');
+
+		this.each(function() {
+
+			// Contains the child element we will resize.
+			// $(this) means the parent container
+			var ourText = $(Opts.innerTag + ':visible:first', this);
+
+			// Will resize to this dimensions.
+			// Use explicit dimensions when specified
+			var maxHeight = Opts.explicitHeight || $(this).height();
+			var maxWidth  = Opts.explicitWidth  || $(this).width();
+
+			var oldFontSize = ourText.css('font-size');
+
+			var lineHeight  = parseFloat(ourText.css('line-height')) / parseFloat(oldFontSize);
+
+			_debug('[TextFill] Inner text: ' + ourText.text());
+			_debug('[TextFill] All options: ', Opts);
+			_debug('[TextFill] Maximum sizes: { ' +
+				   'Height: ' + maxHeight + 'px, ' +
+				   'Width: '  + maxWidth  + 'px' + ' }'
+				  );
+
+			var minFontPixels = Opts.minFontPixels;
+
+			// Remember, if this `maxFontPixels` is negative,
+			// the text will resize to as long as the container
+			// can accomodate
+			var maxFontPixels = (Opts.maxFontPixels <= 0 ?
+								 maxHeight :
+								 Opts.maxFontPixels);
+
+
+			// Let's start it all!
+
+			// 1. Calculate which `font-size` would
+			//    be best for the Height
+			var fontSizeHeight = undefined;
+
+			if (! Opts.widthOnly)
+				fontSizeHeight = _sizing(
+					'Height', ourText,
+					$.fn.height, maxHeight,
+					maxHeight, maxWidth,
+					minFontPixels, maxFontPixels
+				);
+
+			// 2. Calculate which `font-size` would
+			//    be best for the Width
+			var fontSizeWidth = undefined;
+
+			fontSizeWidth = _sizing(
+				'Width', ourText,
+				$.fn.width, maxWidth,
+				maxHeight, maxWidth,
+				minFontPixels, maxFontPixels
+			);
+
+			// 3. Actually resize the text!
+
+			if (Opts.widthOnly) {
+				ourText.css({
+					'font-size'  : fontSizeWidth,
+					'white-space': 'nowrap'
+				});
+
+				if (Opts.changeLineHeight)
+					ourText.parent().css(
+						'line-height',
+						(lineHeight * fontSizeWidth + 'px')
+					);
+			}
+			else {
+				var fontSizeFinal = Math.min(fontSizeHeight, fontSizeWidth);
+
+				ourText.css('font-size', fontSizeFinal);
+
+				if (Opts.changeLineHeight)
+					ourText.parent().css(
+						'line-height',
+						(lineHeight * fontSizeFinal) + 'px'
+					);
+			}
+
+			_debug(
+				'[TextFill] Finished { ' +
+				'Old font-size: ' + oldFontSize              + ', ' +
+				'New font-size: ' + ourText.css('font-size') + ' }'
+			);
+
+			// Oops, something wrong happened!
+			// We weren't supposed to exceed the original size
+			if ((ourText.width()  > maxWidth) ||
+				(ourText.height() > maxHeight && !Opts.widthOnly)) {
+
+				ourText.css('font-size', oldFontSize);
+
+				// Failure callback
+				if (Opts.fail)
+					Opts.fail(this);
+
+				_debug(
+					'[TextFill] Failure { ' +
+					'Current Width: '  + ourText.width()  + ', ' +
+					'Maximum Width: '  + maxWidth         + ', ' +
+					'Current Height: ' + ourText.height() + ', ' +
+					'Maximum Height: ' + maxHeight        + ' }'
+				);
+			}
+			else if (Opts.success) {
+				Opts.success(this);
+			}
+			else if (Opts.callback) {
+				_warn('callback is deprecated, use success, instead');
+
+				// Success callback
+				Opts.callback(this);
+			}
+		});
+
+		// Complete callback
+		if (Opts.complete)
+			Opts.complete(this);
+
+		_debug('[TextFill] End Debug');
+		return this;
+	};
+
+})(window.jQuery);
+

data/lib/textfill_rails.rb

@@ -0,0 +1,8 @@
+require "textfill_rails/version"
+
+module TextfillRails
+ module Rails
+  class Engine < ::Rails::Engine
+  end
+ end
+end

data/lib/textfill_rails/version.rb

@@ -0,0 +1,3 @@
+module TextfillRails
+  VERSION = "1.0.0"
+end

data/textfill_rails.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'textfill_rails/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "textfill_rails"
+  spec.version       = TextfillRails::VERSION
+  spec.authors       = ["Steven Spiel"]
+  spec.description   = "TextfillRails as a gem for Rails 3.1+,4"
+  spec.summary       = "Textfill is awesome"
+  spec.homepage      = "https://github.com/stevenspiel/textfill_rails"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_dependency "railties", ">=3.1"
+
+end

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: textfill_rails
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Steven Spiel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: TextfillRails as a gem for Rails 3.1+,4
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- app/assets/javascripts/textfill.js
+- lib/textfill_rails.rb
+- lib/textfill_rails/version.rb
+- textfill_rails.gemspec
+homepage: https://github.com/stevenspiel/textfill_rails
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.1
+signing_key: 
+specification_version: 4
+summary: Textfill is awesome
+test_files: []