[Summary view] [Print] [Text view]

   1  /*
   2      SWFUpload.SWFObject Plugin
   3  
   4      Summary:
   5          This plugin uses SWFObject to embed SWFUpload dynamically in the page.  SWFObject provides accurate Flash Player detection and DOM Ready loading.
   6          This plugin replaces the Graceful Degradation plugin.
   7  
   8      Features:
   9          * swfupload_load_failed_hander event
  10          * swfupload_pre_load_handler event
  11          * minimum_flash_version setting (default: "9.0.28")
  12          * SWFUpload.onload event for early loading
  13  
  14      Usage:
  15          Provide handlers and settings as needed.  When using the SWFUpload.SWFObject plugin you should initialize SWFUploading
  16          in SWFUpload.onload rather than in window.onload.  When initialized this way SWFUpload can load earlier preventing the UI flicker
  17          that was seen using the Graceful Degradation plugin.
  18  
  19          <script type="text/javascript">
  20              var swfu;
  21              SWFUpload.onload = function () {
  22                  swfu = new SWFUpload({
  23                      minimum_flash_version: "9.0.28",
  24                      swfupload_pre_load_handler: swfuploadPreLoad,
  25                      swfupload_load_failed_handler: swfuploadLoadFailed
  26                  });
  27              };
  28          </script>
  29          
  30      Notes:
  31          You must provide set minimum_flash_version setting to "8" if you are using SWFUpload for Flash Player 8.
  32          The swfuploadLoadFailed event is only fired if the minimum version of Flash Player is not met.  Other issues such as missing SWF files, browser bugs
  33           or corrupt Flash Player installations will not trigger this event.
  34          The swfuploadPreLoad event is fired as soon as the minimum version of Flash Player is found.  It does not wait for SWFUpload to load and can
  35           be used to prepare the SWFUploadUI and hide alternate content.
  36          swfobject's onDomReady event is cross-browser safe but will default to the window.onload event when DOMReady is not supported by the browser.
  37           Early DOM Loading is supported in major modern browsers but cannot be guaranteed for every browser ever made.
  38  */
  39  
  40  
  41  // SWFObject v2.1 must be loaded
  42      
  43  var SWFUpload;
  44  if (typeof(SWFUpload) === "function") {
  45      SWFUpload.onload = function () {};
  46  
  47      swfobject.addDomLoadEvent(function () {
  48          if (typeof(SWFUpload.onload) === "function") {
  49              setTimeout(function(){SWFUpload.onload.call(window);}, 200);
  50          }
  51      });
  52  
  53      SWFUpload.prototype.initSettings = (function (oldInitSettings) {
  54          return function () {
  55              if (typeof(oldInitSettings) === "function") {
  56                  oldInitSettings.call(this);
  57              }
  58  
  59              this.ensureDefault = function (settingName, defaultValue) {
  60                  this.settings[settingName] = (this.settings[settingName] == undefined) ? defaultValue : this.settings[settingName];
  61              };
  62  
  63              this.ensureDefault("minimum_flash_version", "9.0.28");
  64              this.ensureDefault("swfupload_pre_load_handler", null);
  65              this.ensureDefault("swfupload_load_failed_handler", null);
  66  
  67              delete this.ensureDefault;
  68  
  69          };
  70      })(SWFUpload.prototype.initSettings);
  71  
  72  
  73      SWFUpload.prototype.loadFlash = function (oldLoadFlash) {
  74          return function () {
  75              var hasFlash = swfobject.hasFlashPlayerVersion(this.settings.minimum_flash_version);
  76              
  77              if (hasFlash) {
  78                  this.queueEvent("swfupload_pre_load_handler");
  79                  if (typeof(oldLoadFlash) === "function") {
  80                      oldLoadFlash.call(this);
  81                  }
  82              } else {
  83                  this.queueEvent("swfupload_load_failed_handler");
  84              }
  85          };
  86          
  87      }(SWFUpload.prototype.loadFlash);
  88              
  89      SWFUpload.prototype.displayDebugInfo = function (oldDisplayDebugInfo) {
  90          return function () {
  91              if (typeof(oldDisplayDebugInfo) === "function") {
  92                  oldDisplayDebugInfo.call(this);
  93              }
  94              
  95              this.debug(
  96                  [
  97                      "SWFUpload.SWFObject Plugin settings:", "\n",
  98                      "\t", "minimum_flash_version:                      ", this.settings.minimum_flash_version, "\n",
  99                      "\t", "swfupload_pre_load_handler assigned:     ", (typeof(this.settings.swfupload_pre_load_handler) === "function").toString(), "\n",
 100                      "\t", "swfupload_load_failed_handler assigned:     ", (typeof(this.settings.swfupload_load_failed_handler) === "function").toString(), "\n",
 101                  ].join("")
 102              );
 103          };    
 104      }(SWFUpload.prototype.displayDebugInfo);
 105  }