webfontloader 1.0.15 → 1.0.16

data/src/core/fontwatchrunner.js

@@ -0,0 +1,136 @@
+/**
+ * @constructor
+ * @param {function(string, string)} activeCallback
+ * @param {function(string, string)} inactiveCallback
+ * @param {webfont.DomHelper} domHelper
+ * @param {Object.<string, function(Object): number>} fontSizer
+ * @param {function(function(), number=)} asyncCall
+ * @param {function(): number} getTime
+ * @param {string} fontFamily
+ * @param {string} fontDescription
+ * @param {string=} opt_fontTestString
+ */
+webfont.FontWatchRunner = function(activeCallback, inactiveCallback, domHelper,
+    fontSizer, asyncCall, getTime, fontFamily, fontDescription, opt_fontTestString) {
+  this.activeCallback_ = activeCallback;
+  this.inactiveCallback_ = inactiveCallback;
+  this.domHelper_ = domHelper;
+  this.fontSizer_ = fontSizer;
+  this.asyncCall_ = asyncCall;
+  this.getTime_ = getTime;
+  this.nameHelper_ = new webfont.CssFontFamilyName();
+  this.fvd_ = new webfont.FontVariationDescription();
+  this.fontFamily_ = fontFamily;
+  this.fontDescription_ = fontDescription;
+  this.fontTestString_ = opt_fontTestString || webfont.FontWatchRunner.DEFAULT_TEST_STRING;
+  this.originalSizeA_ = this.getDefaultFontSize_(
+      webfont.FontWatchRunner.DEFAULT_FONTS_A);
+  this.originalSizeB_ = this.getDefaultFontSize_(
+      webfont.FontWatchRunner.DEFAULT_FONTS_B);
+  this.requestedFontA_ = this.createHiddenElementWithFont_(
+      webfont.FontWatchRunner.DEFAULT_FONTS_A);
+  this.requestedFontB_ = this.createHiddenElementWithFont_(
+      webfont.FontWatchRunner.DEFAULT_FONTS_B);
+  this.started_ = getTime();
+  this.check_();
+};
+
+/**
+ * A set of sans-serif fonts and a generic family that cover most platforms:
+ * Windows - arial - 99.71%
+ * Mac - arial - 97.67%
+ * Linux - 97.67%
+ * (Based on http://www.codestyle.org/css/font-family/sampler-CombinedResults.shtml)
+ * @type {string}
+ * @const
+ */
+webfont.FontWatchRunner.DEFAULT_FONTS_A = "arial,'URW Gothic L',sans-serif";
+
+/**
+ * A set of serif fonts and a generic family that cover most platforms. We
+ * want each of these fonts to have a different width when rendering the test
+ * string than each of the fonts in DEFAULT_FONTS_A:
+ * Windows - Georgia - 98.98%
+ * Mac - Georgia - 95.60%
+ * Linux - Century Schoolbook L - 97.97%
+ * (Based on http://www.codestyle.org/css/font-family/sampler-CombinedResults.shtml)
+ * @type {string}
+ * @const
+ */
+webfont.FontWatchRunner.DEFAULT_FONTS_B = "Georgia,'Century Schoolbook L',serif";
+
+/**
+ * Default test string. Characters are chosen so that their widths vary a lot
+ * between the fonts in the default stacks. We want each fallback stack
+ * to always start out at a different width than the other.
+ * @type {string}
+ * @const
+ */
+webfont.FontWatchRunner.DEFAULT_TEST_STRING = 'BESs';
+
+/**
+ * @private
+ */
+webfont.FontWatchRunner.prototype.check_ = function() {
+  var sizeA = this.fontSizer_.getWidth(this.requestedFontA_);
+  var sizeB = this.fontSizer_.getWidth(this.requestedFontB_);
+
+  if (this.originalSizeA_ != sizeA || this.originalSizeB_ != sizeB) {
+    this.finish_(this.activeCallback_);
+  } else if (this.getTime_() - this.started_ < 5000) {
+    this.asyncCheck_();
+  } else {
+    this.finish_(this.inactiveCallback_);
+  }
+};
+
+/**
+ * @private
+ */
+webfont.FontWatchRunner.prototype.asyncCheck_ = function() {
+  this.asyncCall_(function(context, func) {
+    return function() {
+      func.call(context);
+    }
+  }(this, this.check_), 50);
+};
+
+/**
+ * @private
+ * @param {function(string, string)} callback
+ */
+webfont.FontWatchRunner.prototype.finish_ = function(callback) {
+  this.domHelper_.removeElement(this.requestedFontA_);
+  this.domHelper_.removeElement(this.requestedFontB_);
+  callback(this.fontFamily_, this.fontDescription_);
+};
+
+/**
+ * @private
+ * @param {string} defaultFonts
+ */
+webfont.FontWatchRunner.prototype.getDefaultFontSize_ = function(defaultFonts) {
+  var defaultFont = this.createHiddenElementWithFont_(defaultFonts, true);
+  var size = this.fontSizer_.getWidth(defaultFont);
+
+  this.domHelper_.removeElement(defaultFont);
+  return size;
+};
+
+/**
+ * @private
+ * @param {string} defaultFonts
+ * @param {boolean=} opt_withoutFontFamily
+ */
+webfont.FontWatchRunner.prototype.createHiddenElementWithFont_ = function(
+    defaultFonts, opt_withoutFontFamily) {
+  var variationCss = this.fvd_.expand(this.fontDescription_);
+  var styleString = "position:absolute;top:-999px;font-size:300px;font-family:" +
+      (opt_withoutFontFamily ? "" : this.nameHelper_.quote(this.fontFamily_) + ",") +
+      defaultFonts + ";" + variationCss;
+  var span = this.domHelper_.createElement('span', { 'style': styleString },
+      this.fontTestString_);
+
+  this.domHelper_.insertInto('body', span);
+  return span;
+};

data/src/core/namespace.js

@@ -2,7 +2,7 @@ var webfont = {};
 
 /**
  * @param {Object} context
- * @param {function(...[*])} func
+ * @param {function(...)} func
  * @param {...*} opt_args
  */
 webfont.bind = function(context, func, opt_args) {

data/src/modules.yml

@@ -6,6 +6,7 @@ core:
   - core/eventdispatcher.js
   - core/fontmoduleloader.js
   - core/fontwatcher.js
+  - core/fontwatchrunner.js
   - core/font.js
   - core/cssclassname.js
   - core/cssfontfamilyname.js