/**
- * SWFUpload v2.0 by Jacob Roberts, Nov 2007, http://www.swfupload.org, http://linebyline.blogspot.com
- * -------- -------- -------- -------- -------- -------- -------- --------
- * SWFUpload is (c) 2006 Lars Huring and Mammon Media and is released under the MIT License:
+ * SWFUpload: http://www.swfupload.org, http://swfupload.googlecode.com
+ *
+ * mmSWFUpload 1.0: Flash upload dialog - http://profandesign.se/swfupload/, http://www.vinterwebb.se/
+ *
+ * SWFUpload is (c) 2006-2007 Lars Huring, Olov Nilzén and Mammon Media and is released under the MIT License:
* http://www.opensource.org/licenses/mit-license.php
*
- * See Changelog.txt for version history
+ * SWFUpload 2 is (c) 2007-2008 Jake Roberts and is released under the MIT License:
+ * http://www.opensource.org/licenses/mit-license.php
*
- * Development Notes:
- * * This version of SWFUpload requires Flash Player 9.0.28 and should autodetect the correct flash version.
- * * In Linux Flash Player 9 setting the post file variable name does not work. It is always set to "Filedata".
- * * There is a lot of repeated code that could be refactored to single functions. Feel free.
- * * It's dangerous to do "circular calls" between Flash and JavaScript. I've taken steps to try to work around issues
- * by having the event calls pipe through setTimeout. However you should still avoid calling in to Flash from
- * within the event handler methods. Especially the "startUpload" event since it cannot use the setTimeout hack.
*/
-/* *********** */
-/* Constructor */
-/* *********** */
-
-var SWFUpload = function (init_settings) {
- this.initSWFUpload(init_settings);
-};
-
-SWFUpload.prototype.initSWFUpload = function (init_settings) {
- // Remove background flicker in IE (read this: http://misterpixel.blogspot.com/2006/09/forensic-analysis-of-ie6.html)
- // This doesn't have anything to do with SWFUpload but can help your UI behave better in IE.
- try {
- document.execCommand('BackgroundImageCache', false, true);
- } catch (ex1) {
- }
+/* ******************* */
+/* Constructor & Init */
+/* ******************* */
+var SWFUpload;
+if (SWFUpload == undefined) {
+ SWFUpload = function (settings) {
+ this.initSWFUpload(settings);
+ };
+}
+SWFUpload.prototype.initSWFUpload = function (settings) {
try {
this.customSettings = {}; // A container where developers can place their own settings associated with this instance.
- this.settings = {};
+ this.settings = settings;
this.eventQueue = [];
this.movieName = "SWFUpload_" + SWFUpload.movieCount++;
this.movieElement = null;
+
// Setup global control tracking
SWFUpload.instances[this.movieName] = this;
// Load the settings. Load the Flash movie.
- this.initSettings(init_settings);
+ this.initSettings();
this.loadFlash();
-
this.displayDebugInfo();
-
- } catch (ex2) {
- this.debug(ex2);
+ } catch (ex) {
+ delete SWFUpload.instances[this.movieName];
+ throw ex;
}
-}
+};
/* *************** */
-/* Static thingies */
+/* Static Members */
/* *************** */
SWFUpload.instances = {};
SWFUpload.movieCount = 0;
+SWFUpload.version = "2.2.0 2009-03-25";
SWFUpload.QUEUE_ERROR = {
QUEUE_LIMIT_EXCEEDED : -100,
FILE_EXCEEDS_SIZE_LIMIT : -110,
COMPLETE : -4,
CANCELLED : -5
};
+SWFUpload.BUTTON_ACTION = {
+ SELECT_FILE : -100,
+ SELECT_FILES : -110,
+ START_UPLOAD : -120
+};
+SWFUpload.CURSOR = {
+ ARROW : -1,
+ HAND : -2
+};
+SWFUpload.WINDOW_MODE = {
+ WINDOW : "window",
+ TRANSPARENT : "transparent",
+ OPAQUE : "opaque"
+};
+
+// Private: takes a URL, determines if it is relative and converts to an absolute URL
+// using the current site. Only processes the URL if it can, otherwise returns the URL untouched
+SWFUpload.completeURL = function(url) {
+ if (typeof(url) !== "string" || url.match(/^https?:\/\//i) || url.match(/^\//)) {
+ return url;
+ }
+
+ var currentURL = window.location.protocol + "//" + window.location.hostname + (window.location.port ? ":" + window.location.port : "");
+
+ var indexSlash = window.location.pathname.lastIndexOf("/");
+ if (indexSlash <= 0) {
+ path = "/";
+ } else {
+ path = window.location.pathname.substr(0, indexSlash) + "/";
+ }
+
+ return /*currentURL +*/ path + url;
+
+};
-/* ***************** */
-/* Instance Thingies */
-/* ***************** */
-// init is a private method that ensures that all the object settings are set, getting a default value if one was not assigned.
+/* ******************** */
+/* Instance Members */
+/* ******************** */
-SWFUpload.prototype.initSettings = function (init_settings) {
+// Private: initSettings ensures that all the
+// settings are set, getting a default value if one was not assigned.
+SWFUpload.prototype.initSettings = function () {
+ this.ensureDefault = function (settingName, defaultValue) {
+ this.settings[settingName] = (this.settings[settingName] == undefined) ? defaultValue : this.settings[settingName];
+ };
+
// Upload backend settings
- this.addSetting("upload_url", init_settings.upload_url, "");
- this.addSetting("file_post_name", init_settings.file_post_name, "Filedata");
- this.addSetting("post_params", init_settings.post_params, {});
-
+ this.ensureDefault("upload_url", "");
+ this.ensureDefault("preserve_relative_urls", false);
+ this.ensureDefault("file_post_name", "Filedata");
+ this.ensureDefault("post_params", {});
+ this.ensureDefault("use_query_string", false);
+ this.ensureDefault("requeue_on_error", false);
+ this.ensureDefault("http_success", []);
+ this.ensureDefault("assume_success_timeout", 0);
+
// File Settings
- this.addSetting("file_types", init_settings.file_types, "*.*");
- this.addSetting("file_types_description", init_settings.file_types_description, "All Files");
- this.addSetting("file_size_limit", init_settings.file_size_limit, "1024");
- this.addSetting("file_upload_limit", init_settings.file_upload_limit, "0");
- this.addSetting("file_queue_limit", init_settings.file_queue_limit, "0");
+ this.ensureDefault("file_types", "*.*");
+ this.ensureDefault("file_types_description", "All Files");
+ this.ensureDefault("file_size_limit", 0); // Default zero means "unlimited"
+ this.ensureDefault("file_upload_limit", 0);
+ this.ensureDefault("file_queue_limit", 0);
// Flash Settings
- this.addSetting("flash_url", init_settings.flash_url, "swfupload.swf");
- this.addSetting("flash_width", init_settings.flash_width, "1px");
- this.addSetting("flash_height", init_settings.flash_height, "1px");
- this.addSetting("flash_color", init_settings.flash_color, "#FFFFFF");
-
+ this.ensureDefault("flash_url", "swfupload.swf");
+ this.ensureDefault("prevent_swf_caching", true);
+
+ // Button Settings
+ this.ensureDefault("button_image_url", "");
+ this.ensureDefault("button_width", 1);
+ this.ensureDefault("button_height", 1);
+ this.ensureDefault("button_text", "");
+ this.ensureDefault("button_text_style", "color: #000000; font-size: 16pt;");
+ this.ensureDefault("button_text_top_padding", 0);
+ this.ensureDefault("button_text_left_padding", 0);
+ this.ensureDefault("button_action", SWFUpload.BUTTON_ACTION.SELECT_FILES);
+ this.ensureDefault("button_disabled", false);
+ this.ensureDefault("button_placeholder_id", "");
+ this.ensureDefault("button_placeholder", null);
+ this.ensureDefault("button_cursor", SWFUpload.CURSOR.ARROW);
+ this.ensureDefault("button_window_mode", SWFUpload.WINDOW_MODE.WINDOW);
+
// Debug Settings
- this.addSetting("debug_enabled", init_settings.debug, false);
-
+ this.ensureDefault("debug", false);
+ this.settings.debug_enabled = this.settings.debug; // Here to maintain v2 API
+
// Event Handlers
- this.flashReady_handler = SWFUpload.flashReady; // This is a non-overrideable event handler
- this.swfUploadLoaded_handler = this.retrieveSetting(init_settings.swfupload_loaded_handler, SWFUpload.swfUploadLoaded);
+ this.settings.return_upload_start_handler = this.returnUploadStart;
+ this.ensureDefault("swfupload_loaded_handler", null);
+ this.ensureDefault("file_dialog_start_handler", null);
+ this.ensureDefault("file_queued_handler", null);
+ this.ensureDefault("file_queue_error_handler", null);
+ this.ensureDefault("file_dialog_complete_handler", null);
- this.fileDialogStart_handler = this.retrieveSetting(init_settings.file_dialog_start_handler, SWFUpload.fileDialogStart);
- this.fileQueued_handler = this.retrieveSetting(init_settings.file_queued_handler, SWFUpload.fileQueued);
- this.fileQueueError_handler = this.retrieveSetting(init_settings.file_queue_error_handler, SWFUpload.fileQueueError);
- this.fileDialogComplete_handler = this.retrieveSetting(init_settings.file_dialog_complete_handler, SWFUpload.fileDialogComplete);
+ this.ensureDefault("upload_start_handler", null);
+ this.ensureDefault("upload_progress_handler", null);
+ this.ensureDefault("upload_error_handler", null);
+ this.ensureDefault("upload_success_handler", null);
+ this.ensureDefault("upload_complete_handler", null);
- this.uploadStart_handler = this.retrieveSetting(init_settings.upload_start_handler, SWFUpload.uploadStart);
- this.uploadProgress_handler = this.retrieveSetting(init_settings.upload_progress_handler, SWFUpload.uploadProgress);
- this.uploadError_handler = this.retrieveSetting(init_settings.upload_error_handler, SWFUpload.uploadError);
- this.uploadSuccess_handler = this.retrieveSetting(init_settings.upload_success_handler, SWFUpload.uploadSuccess);
- this.uploadComplete_handler = this.retrieveSetting(init_settings.upload_complete_handler, SWFUpload.uploadComplete);
+ this.ensureDefault("debug_handler", this.debugMessage);
- this.debug_handler = this.retrieveSetting(init_settings.debug_handler, SWFUpload.debug);
+ this.ensureDefault("custom_settings", {});
// Other settings
- this.customSettings = this.retrieveSetting(init_settings.custom_settings, {});
+ this.customSettings = this.settings.custom_settings;
+
+ // Update the flash url if needed
+ if (!!this.settings.prevent_swf_caching) {
+ this.settings.flash_url = this.settings.flash_url + (this.settings.flash_url.indexOf("?") < 0 ? "?" : "&") + "preventswfcaching=" + new Date().getTime();
+ }
+
+ if (!this.settings.preserve_relative_urls) {
+ //this.settings.flash_url = SWFUpload.completeURL(this.settings.flash_url); // Don't need to do this one since flash doesn't look at it
+ this.settings.upload_url = SWFUpload.completeURL(this.settings.upload_url);
+ this.settings.button_image_url = SWFUpload.completeURL(this.settings.button_image_url);
+ }
+
+ delete this.ensureDefault;
};
-// loadFlash is a private method that generates the HTML tag for the Flash
-// It then adds the flash to the "target" or to the body and stores a
-// reference to the flash element in "movieElement".
+// Private: loadFlash replaces the button_placeholder element with the flash movie.
SWFUpload.prototype.loadFlash = function () {
- var html, target_element, container;
+ var targetElement, tempParent;
// Make sure an element with the ID we are going to use doesn't already exist
if (document.getElementById(this.movieName) !== null) {
- return false;
+ throw "ID " + this.movieName + " is already in use. The Flash Object could not be added";
}
- // Get the body tag where we will be adding the flash movie
- try {
- target_element = document.getElementsByTagName("body")[0];
- if (typeof(target_element) === "undefined" || target_element === null) {
- this.debug('Could not find the BODY element. SWFUpload failed to load.');
- return false;
- }
- } catch (ex) {
- return false;
+ // Get the element where we will be placing the flash movie
+ targetElement = document.getElementById(this.settings.button_placeholder_id) || this.settings.button_placeholder;
+
+ if (targetElement == undefined) {
+ throw "Could not find the placeholder element: " + this.settings.button_placeholder_id;
}
// Append the container and load the flash
- container = document.createElement("div");
- container.style.width = this.getSetting("flash_width");
- container.style.height = this.getSetting("flash_height");
-
- target_element.appendChild(container);
- container.innerHTML = this.getFlashHTML(); // Using innerHTML is non-standard but the only sensible way to dynamically add Flash in IE (and maybe other browsers)
-};
-
-// Generates the embed/object tags needed to embed the flash in to the document
-SWFUpload.prototype.getFlashHTML = function () {
- var html = "";
-
- // Create Mozilla Embed HTML
- if (navigator.plugins && navigator.mimeTypes && navigator.mimeTypes.length) {
- // Build the basic embed html
- html = '<embed type="application/x-shockwave-flash" src="' + this.getSetting("flash_url") + '" width="' + this.getSetting("flash_width") + '" height="' + this.getSetting("flash_height") + '"';
- html += ' id="' + this.movieName + '" name="' + this.movieName + '" ';
- html += 'bgcolor="' + this.getSetting("flash_color") + '" quality="high" menu="false" flashvars="';
-
- html += this.getFlashVars();
-
- html += '" />';
+ tempParent = document.createElement("div");
+ tempParent.innerHTML = this.getFlashHTML(); // Using innerHTML is non-standard but the only sensible way to dynamically add Flash in IE (and maybe other browsers)
+ targetElement.parentNode.replaceChild(tempParent.firstChild, targetElement);
- // Create IE Object HTML
- } else {
-
- // Build the basic Object tag
- html = '<object id="' + this.movieName + '" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" width="' + this.getSetting("flash_width") + '" height="' + this.getSetting("flash_height") + '">';
- html += '<param name="movie" value="' + this.getSetting("flash_url") + '">';
-
- html += '<param name="bgcolor" value="' + this.getSetting("flash_color") + '" />';
- html += '<param name="quality" value="high" />';
- html += '<param name="menu" value="false" />';
-
- html += '<param name="flashvars" value="' + this.getFlashVars() + '" />';
- html += '</object>';
+ // Fix IE Flash/Form bug
+ if (window[this.movieName] == undefined) {
+ window[this.movieName] = this.getMovieElement();
}
-
- return html;
+
};
-// This private method builds the parameter string that will be passed
-// to flash.
+// Private: getFlashHTML generates the object tag needed to embed the flash in to the document
+SWFUpload.prototype.getFlashHTML = function () {
+ // Flash Satay object syntax: http://www.alistapart.com/articles/flashsatay
+ return ['<object id="', this.movieName, '" type="application/x-shockwave-flash" data="', this.settings.flash_url, '" width="', this.settings.button_width, '" height="', this.settings.button_height, '" class="swfupload">',
+ '<param name="wmode" value="', this.settings.button_window_mode, '" />',
+ '<param name="movie" value="', this.settings.flash_url, '" />',
+ '<param name="quality" value="high" />',
+ '<param name="menu" value="false" />',
+ '<param name="allowScriptAccess" value="always" />',
+ '<param name="flashvars" value="' + this.getFlashVars() + '" />',
+ '</object>'].join("");
+};
+
+// Private: getFlashVars builds the parameter string that will be passed
+// to flash in the flashvars param.
SWFUpload.prototype.getFlashVars = function () {
// Build a string from the post param object
- var param_string = this.buildParamString();
-
+ var paramString = this.buildParamString();
+ var httpSuccessString = this.settings.http_success.join(",");
+
// Build the parameter string
- var html = "";
- html += "movieName=" + encodeURIComponent(this.movieName);
- html += "&uploadURL=" + encodeURIComponent(this.getSetting("upload_url"));
- html += "¶ms=" + encodeURIComponent(param_string);
- html += "&filePostName=" + encodeURIComponent(this.getSetting("file_post_name"));
- html += "&fileTypes=" + encodeURIComponent(this.getSetting("file_types"));
- html += "&fileTypesDescription=" + encodeURIComponent(this.getSetting("file_types_description"));
- html += "&fileSizeLimit=" + encodeURIComponent(this.getSetting("file_size_limit"));
- html += "&fileUploadLimit=" + encodeURIComponent(this.getSetting("file_upload_limit"));
- html += "&fileQueueLimit=" + encodeURIComponent(this.getSetting("file_queue_limit"));
- html += "&debugEnabled=" + encodeURIComponent(this.getSetting("debug_enabled"));
-
- return html;
-};
-
+ return ["movieName=", encodeURIComponent(this.movieName),
+ "&uploadURL=", encodeURIComponent(this.settings.upload_url),
+ "&useQueryString=", encodeURIComponent(this.settings.use_query_string),
+ "&requeueOnError=", encodeURIComponent(this.settings.requeue_on_error),
+ "&httpSuccess=", encodeURIComponent(httpSuccessString),
+ "&assumeSuccessTimeout=", encodeURIComponent(this.settings.assume_success_timeout),
+ "&params=", encodeURIComponent(paramString),
+ "&filePostName=", encodeURIComponent(this.settings.file_post_name),
+ "&fileTypes=", encodeURIComponent(this.settings.file_types),
+ "&fileTypesDescription=", encodeURIComponent(this.settings.file_types_description),
+ "&fileSizeLimit=", encodeURIComponent(this.settings.file_size_limit),
+ "&fileUploadLimit=", encodeURIComponent(this.settings.file_upload_limit),
+ "&fileQueueLimit=", encodeURIComponent(this.settings.file_queue_limit),
+ "&debugEnabled=", encodeURIComponent(this.settings.debug_enabled),
+ "&buttonImageURL=", encodeURIComponent(this.settings.button_image_url),
+ "&buttonWidth=", encodeURIComponent(this.settings.button_width),
+ "&buttonHeight=", encodeURIComponent(this.settings.button_height),
+ "&buttonText=", encodeURIComponent(this.settings.button_text),
+ "&buttonTextTopPadding=", encodeURIComponent(this.settings.button_text_top_padding),
+ "&buttonTextLeftPadding=", encodeURIComponent(this.settings.button_text_left_padding),
+ "&buttonTextStyle=", encodeURIComponent(this.settings.button_text_style),
+ "&buttonAction=", encodeURIComponent(this.settings.button_action),
+ "&buttonDisabled=", encodeURIComponent(this.settings.button_disabled),
+ "&buttonCursor=", encodeURIComponent(this.settings.button_cursor)
+ ].join("");
+};
+
+// Public: getMovieElement retrieves the DOM reference to the Flash element added by SWFUpload
+// The element is cached after the first lookup
SWFUpload.prototype.getMovieElement = function () {
- if (typeof(this.movieElement) === "undefined" || this.movieElement === null) {
+ if (this.movieElement == undefined) {
this.movieElement = document.getElementById(this.movieName);
-
- // Fix IEs "Flash can't callback when in a form" issue (http://www.extremefx.com.ar/blog/fixing-flash-external-interface-inside-form-on-internet-explorer)
- // Removed because Revision 6 always adds the flash to the body (inside a containing div)
- // If you insist on adding the Flash file inside a Form then in IE you have to make you wait until the DOM is ready
- // and run this code to make the form's ID available from the window object so Flash and JavaScript can communicate.
- //if (typeof(window[this.movieName]) === "undefined" || window[this.moveName] !== this.movieElement) {
- // window[this.movieName] = this.movieElement;
- //}
}
+ if (this.movieElement === null) {
+ throw "Could not find Flash element";
+ }
+
return this.movieElement;
};
+// Private: buildParamString takes the name/value pairs in the post_params setting object
+// and joins them up in to a string formatted "name=value&name=value"
SWFUpload.prototype.buildParamString = function () {
- var post_params = this.getSetting("post_params");
- var param_string_pairs = [];
- var i, value, name;
-
- // Retrieve the user defined parameters
- if (typeof(post_params) === "object") {
- for (name in post_params) {
- if (post_params.hasOwnProperty(name)) {
- if (typeof(post_params[name]) === "string") {
- param_string_pairs.push(encodeURIComponent(name) + "=" + encodeURIComponent(post_params[name]));
- }
+ var postParams = this.settings.post_params;
+ var paramStringPairs = [];
+
+ if (typeof(postParams) === "object") {
+ for (var name in postParams) {
+ if (postParams.hasOwnProperty(name)) {
+ paramStringPairs.push(encodeURIComponent(name.toString()) + "=" + encodeURIComponent(postParams[name].toString()));
}
}
}
- return param_string_pairs.join("&");
+ return paramStringPairs.join("&");
};
-// Saves a setting. If the value given is undefined or null then the default_value is used.
-SWFUpload.prototype.addSetting = function (name, value, default_value) {
- if (typeof(value) === "undefined" || value === null) {
- this.settings[name] = default_value;
- } else {
- this.settings[name] = value;
- }
+// Public: Used to remove a SWFUpload instance from the page. This method strives to remove
+// all references to the SWF, and other objects so memory is properly freed.
+// Returns true if everything was destroyed. Returns a false if a failure occurs leaving SWFUpload in an inconsistant state.
+// Credits: Major improvements provided by steffen
+SWFUpload.prototype.destroy = function () {
+ try {
+ // Make sure Flash is done before we try to remove it
+ this.cancelUpload(null, false);
+
+
+ // Remove the SWFUpload DOM nodes
+ var movieElement = null;
+ movieElement = this.getMovieElement();
+
+ if (movieElement && typeof(movieElement.CallFunction) === "unknown") { // We only want to do this in IE
+ // Loop through all the movie's properties and remove all function references (DOM/JS IE 6/7 memory leak workaround)
+ for (var i in movieElement) {
+ try {
+ if (typeof(movieElement[i]) === "function") {
+ movieElement[i] = null;
+ }
+ } catch (ex1) {}
+ }
- return this.settings[name];
-};
+ // Remove the Movie Element from the page
+ try {
+ movieElement.parentNode.removeChild(movieElement);
+ } catch (ex) {}
+ }
+
+ // Remove IE form fix reference
+ window[this.movieName] = null;
-// Gets a setting. Returns empty string if not found.
-SWFUpload.prototype.getSetting = function (name) {
- if (typeof(this.settings[name]) === "undefined") {
- return "";
- } else {
- return this.settings[name];
- }
-};
+ // Destroy other references
+ SWFUpload.instances[this.movieName] = null;
+ delete SWFUpload.instances[this.movieName];
-// Gets a setting, if the setting is undefined then return the default value
-// This does not affect or use the interal setting object.
-SWFUpload.prototype.retrieveSetting = function (value, default_value) {
- if (typeof(value) === "undefined" || value === null) {
- return default_value;
- } else {
- return value;
+ this.movieElement = null;
+ this.settings = null;
+ this.customSettings = null;
+ this.eventQueue = null;
+ this.movieName = null;
+
+
+ return true;
+ } catch (ex2) {
+ return false;
}
};
-// It loops through all the settings and displays
-// them in the debug Console.
+// Public: displayDebugInfo prints out settings and configuration
+// information about this SWFUpload instance.
+// This function (and any references to it) can be deleted when placing
+// SWFUpload in production.
SWFUpload.prototype.displayDebugInfo = function () {
- var key, debug_message = "";
+ this.debug(
+ [
+ "---SWFUpload Instance Info---\n",
+ "Version: ", SWFUpload.version, "\n",
+ "Movie Name: ", this.movieName, "\n",
+ "Settings:\n",
+ "\t", "upload_url: ", this.settings.upload_url, "\n",
+ "\t", "flash_url: ", this.settings.flash_url, "\n",
+ "\t", "use_query_string: ", this.settings.use_query_string.toString(), "\n",
+ "\t", "requeue_on_error: ", this.settings.requeue_on_error.toString(), "\n",
+ "\t", "http_success: ", this.settings.http_success.join(", "), "\n",
+ "\t", "assume_success_timeout: ", this.settings.assume_success_timeout, "\n",
+ "\t", "file_post_name: ", this.settings.file_post_name, "\n",
+ "\t", "post_params: ", this.settings.post_params.toString(), "\n",
+ "\t", "file_types: ", this.settings.file_types, "\n",
+ "\t", "file_types_description: ", this.settings.file_types_description, "\n",
+ "\t", "file_size_limit: ", this.settings.file_size_limit, "\n",
+ "\t", "file_upload_limit: ", this.settings.file_upload_limit, "\n",
+ "\t", "file_queue_limit: ", this.settings.file_queue_limit, "\n",
+ "\t", "debug: ", this.settings.debug.toString(), "\n",
+
+ "\t", "prevent_swf_caching: ", this.settings.prevent_swf_caching.toString(), "\n",
+
+ "\t", "button_placeholder_id: ", this.settings.button_placeholder_id.toString(), "\n",
+ "\t", "button_placeholder: ", (this.settings.button_placeholder ? "Set" : "Not Set"), "\n",
+ "\t", "button_image_url: ", this.settings.button_image_url.toString(), "\n",
+ "\t", "button_width: ", this.settings.button_width.toString(), "\n",
+ "\t", "button_height: ", this.settings.button_height.toString(), "\n",
+ "\t", "button_text: ", this.settings.button_text.toString(), "\n",
+ "\t", "button_text_style: ", this.settings.button_text_style.toString(), "\n",
+ "\t", "button_text_top_padding: ", this.settings.button_text_top_padding.toString(), "\n",
+ "\t", "button_text_left_padding: ", this.settings.button_text_left_padding.toString(), "\n",
+ "\t", "button_action: ", this.settings.button_action.toString(), "\n",
+ "\t", "button_disabled: ", this.settings.button_disabled.toString(), "\n",
+
+ "\t", "custom_settings: ", this.settings.custom_settings.toString(), "\n",
+ "Event Handlers:\n",
+ "\t", "swfupload_loaded_handler assigned: ", (typeof this.settings.swfupload_loaded_handler === "function").toString(), "\n",
+ "\t", "file_dialog_start_handler assigned: ", (typeof this.settings.file_dialog_start_handler === "function").toString(), "\n",
+ "\t", "file_queued_handler assigned: ", (typeof this.settings.file_queued_handler === "function").toString(), "\n",
+ "\t", "file_queue_error_handler assigned: ", (typeof this.settings.file_queue_error_handler === "function").toString(), "\n",
+ "\t", "upload_start_handler assigned: ", (typeof this.settings.upload_start_handler === "function").toString(), "\n",
+ "\t", "upload_progress_handler assigned: ", (typeof this.settings.upload_progress_handler === "function").toString(), "\n",
+ "\t", "upload_error_handler assigned: ", (typeof this.settings.upload_error_handler === "function").toString(), "\n",
+ "\t", "upload_success_handler assigned: ", (typeof this.settings.upload_success_handler === "function").toString(), "\n",
+ "\t", "upload_complete_handler assigned: ", (typeof this.settings.upload_complete_handler === "function").toString(), "\n",
+ "\t", "debug_handler assigned: ", (typeof this.settings.debug_handler === "function").toString(), "\n"
+ ].join("")
+ );
+};
+
+/* Note: addSetting and getSetting are no longer used by SWFUpload but are included
+ the maintain v2 API compatibility
+*/
+// Public: (Deprecated) addSetting adds a setting value. If the value given is undefined or null then the default_value is used.
+SWFUpload.prototype.addSetting = function (name, value, default_value) {
+ if (value == undefined) {
+ return (this.settings[name] = default_value);
+ } else {
+ return (this.settings[name] = value);
+ }
+};
- debug_message += "----- SWFUPLOAD SETTINGS ----\nID: " + this.moveName + "\n";
+// Public: (Deprecated) getSetting gets a setting. Returns an empty string if the setting was not found.
+SWFUpload.prototype.getSetting = function (name) {
+ if (this.settings[name] != undefined) {
+ return this.settings[name];
+ }
- debug_message += this.outputObject(this.settings);
+ return "";
+};
- debug_message += "----- SWFUPLOAD SETTINGS END ----\n";
- debug_message += "\n";
- this.debug(debug_message);
-};
-SWFUpload.prototype.outputObject = function (object, prefix) {
- var output = "", key;
- if (typeof(prefix) !== "string") {
- prefix = "";
- }
- if (typeof(object) !== "object") {
- return "";
- }
+// Private: callFlash handles function calls made to the Flash element.
+// Calls are made with a setTimeout for some functions to work around
+// bugs in the ExternalInterface library.
+SWFUpload.prototype.callFlash = function (functionName, argumentArray) {
+ argumentArray = argumentArray || [];
+
+ var movieElement = this.getMovieElement();
+ var returnValue, returnString;
- for (key in object) {
- if (object.hasOwnProperty(key)) {
- if (typeof(object[key]) === "object") {
- output += (prefix + key + ": { \n" + this.outputObject(object[key], "\t" + prefix) + prefix + "}" + "\n");
- } else {
- output += (prefix + key + ": " + object[key] + "\n");
- }
- }
+ // Flash's method if calling ExternalInterface methods (code adapted from MooTools).
+ try {
+ returnString = movieElement.CallFunction('<invoke name="' + functionName + '" returntype="javascript">' + __flash__argumentsToXML(argumentArray, 0) + '</invoke>');
+ returnValue = eval(returnString);
+ } catch (ex) {
+ throw "Call to " + functionName + " failed";
+ }
+
+ // Unescape file post param values
+ if (returnValue != undefined && typeof returnValue.post === "object") {
+ returnValue = this.unescapeFilePostParams(returnValue);
}
- return output;
+ return returnValue;
};
/* *****************************
to operate SWFUpload
***************************** */
+// WARNING: this function does not work in Flash Player 10
+// Public: selectFile causes a File Selection Dialog window to appear. This
+// dialog only allows 1 file to be selected.
SWFUpload.prototype.selectFile = function () {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SelectFile) === "function") {
- try {
- movie_element.SelectFile();
- }
- catch (ex) {
- this.debug("Could not call SelectFile: " + ex);
- }
- } else {
- this.debug("Could not find Flash element");
- }
-
+ this.callFlash("SelectFile");
};
+// WARNING: this function does not work in Flash Player 10
+// Public: selectFiles causes a File Selection Dialog window to appear/ This
+// dialog allows the user to select any number of files
+// Flash Bug Warning: Flash limits the number of selectable files based on the combined length of the file names.
+// If the selection name length is too long the dialog will fail in an unpredictable manner. There is no work-around
+// for this bug.
SWFUpload.prototype.selectFiles = function () {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SelectFiles) === "function") {
- try {
- movie_element.SelectFiles();
- }
- catch (ex) {
- this.debug("Could not call SelectFiles: " + ex);
- }
- } else {
- this.debug("Could not find Flash element");
- }
-
+ this.callFlash("SelectFiles");
};
-/* Start the upload. If a file_id is specified that file is uploaded. Otherwise the first
- * file in the queue is uploaded. If no files are in the queue then nothing happens.
- * This call uses setTimeout since Flash will be calling back in to JavaScript
- */
-SWFUpload.prototype.startUpload = function (file_id) {
- var self = this;
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.StartUpload) === "function") {
- setTimeout(
- function () {
- try {
- movie_element.StartUpload(file_id);
- }
- catch (ex) {
- self.debug("Could not call StartUpload: " + ex);
- }
- }, 0
- );
- } else {
- this.debug("Could not find Flash element");
- }
-
+// Public: startUpload starts uploading the first file in the queue unless
+// the optional parameter 'fileID' specifies the ID
+SWFUpload.prototype.startUpload = function (fileID) {
+ this.callFlash("StartUpload", [fileID]);
};
-/* Cancels a the file upload. You must specify a file_id */
-SWFUpload.prototype.cancelUpload = function (file_id) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.CancelUpload) === "function") {
- try {
- movie_element.CancelUpload(file_id);
- }
- catch (ex) {
- this.debug("Could not call CancelUpload: " + ex);
- }
- } else {
- this.debug("Could not find Flash element");
+// Public: cancelUpload cancels any queued file. The fileID parameter may be the file ID or index.
+// If you do not specify a fileID the current uploading file or first file in the queue is cancelled.
+// If you do not want the uploadError event to trigger you can specify false for the triggerErrorEvent parameter.
+SWFUpload.prototype.cancelUpload = function (fileID, triggerErrorEvent) {
+ if (triggerErrorEvent !== false) {
+ triggerErrorEvent = true;
}
-
+ this.callFlash("CancelUpload", [fileID, triggerErrorEvent]);
};
-// Stops the current upload. The file is re-queued. If nothing is currently uploading then nothing happens.
+// Public: stopUpload stops the current upload and requeues the file at the beginning of the queue.
+// If nothing is currently uploading then nothing happens.
SWFUpload.prototype.stopUpload = function () {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.StopUpload) === "function") {
- try {
- movie_element.StopUpload();
- }
- catch (ex) {
- this.debug("Could not call StopUpload: " + ex);
- }
- } else {
- this.debug("Could not find Flash element");
- }
-
+ this.callFlash("StopUpload");
};
/* ************************
* Settings methods
- * These methods change the settings inside SWFUpload
- * They shouldn't need to be called in a setTimeout since they
- * should not call back from Flash to JavaScript (except perhaps in a Debug call)
- * and some need to return data so setTimeout won't work.
- */
+ * These methods change the SWFUpload settings.
+ * SWFUpload settings should not be changed directly on the settings object
+ * since many of the settings need to be passed to Flash in order to take
+ * effect.
+ * *********************** */
-/* Gets the file statistics object. It looks like this (where n = number):
- {
- files_queued: n,
- complete_uploads: n,
- upload_errors: n,
- uploads_cancelled: n,
- queue_errors: n
- }
-*/
+// Public: getStats gets the file statistics object.
SWFUpload.prototype.getStats = function () {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.GetStats) === "function") {
- try {
- return movie_element.GetStats();
- }
- catch (ex) {
- this.debug("Could not call GetStats");
- }
- } else {
- this.debug("Could not find Flash element");
- }
+ return this.callFlash("GetStats");
};
-SWFUpload.prototype.setStats = function (stats_object) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetStats) === "function") {
- try {
- movie_element.SetStats(stats_object);
- }
- catch (ex) {
- this.debug("Could not call SetStats");
- }
- } else {
- this.debug("Could not find Flash element");
- }
+
+// Public: setStats changes the SWFUpload statistics. You shouldn't need to
+// change the statistics but you can. Changing the statistics does not
+// affect SWFUpload accept for the successful_uploads count which is used
+// by the upload_limit setting to determine how many files the user may upload.
+SWFUpload.prototype.setStats = function (statsObject) {
+ this.callFlash("SetStats", [statsObject]);
};
-SWFUpload.prototype.setCredentials = function(name, password) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetCredentials) === "function") {
- try {
- return movie_element.SetCredentials(name, password);
- }
- catch (ex) {
- this.debug("Could not call SetCredentials");
- }
+// Public: getFile retrieves a File object by ID or Index. If the file is
+// not found then 'null' is returned.
+SWFUpload.prototype.getFile = function (fileID) {
+ if (typeof(fileID) === "number") {
+ return this.callFlash("GetFileByIndex", [fileID]);
} else {
- this.debug("Could not find Flash element");
+ return this.callFlash("GetFile", [fileID]);
}
};
-SWFUpload.prototype.getFile = function (file_id) {
- var movie_element = this.getMovieElement();
- if (typeof(file_id) === "number") {
- if (movie_element !== null && typeof(movie_element.GetFileByIndex) === "function") {
- try {
- return movie_element.GetFileByIndex(file_id);
- }
- catch (ex) {
- this.debug("Could not call GetFileByIndex");
- }
- } else {
- this.debug("Could not find Flash element");
- }
- } else {
- if (movie_element !== null && typeof(movie_element.GetFile) === "function") {
- try {
- return movie_element.GetFile(file_id);
- }
- catch (ex) {
- this.debug("Could not call GetFile");
- }
- } else {
- this.debug("Could not find Flash element");
- }
- }
+// Public: addFileParam sets a name/value pair that will be posted with the
+// file specified by the Files ID. If the name already exists then the
+// exiting value will be overwritten.
+SWFUpload.prototype.addFileParam = function (fileID, name, value) {
+ return this.callFlash("AddFileParam", [fileID, name, value]);
};
-SWFUpload.prototype.addFileParam = function (file_id, name, value) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.AddFileParam) === "function") {
- try {
- return movie_element.AddFileParam(file_id, name, value);
- }
- catch (ex) {
- this.debug("Could not call AddFileParam");
- }
- } else {
- this.debug("Could not find Flash element");
- }
+// Public: removeFileParam removes a previously set (by addFileParam) name/value
+// pair from the specified file.
+SWFUpload.prototype.removeFileParam = function (fileID, name) {
+ this.callFlash("RemoveFileParam", [fileID, name]);
};
-SWFUpload.prototype.removeFileParam = function (file_id, name) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.RemoveFileParam) === "function") {
- try {
- return movie_element.RemoveFileParam(file_id, name);
- }
- catch (ex) {
- this.debug("Could not call AddFileParam");
- }
- } else {
- this.debug("Could not find Flash element");
- }
+// Public: setUploadUrl changes the upload_url setting.
+SWFUpload.prototype.setUploadURL = function (url) {
+ this.settings.upload_url = url.toString();
+ this.callFlash("SetUploadURL", [url]);
+};
+// Public: setPostParams changes the post_params setting
+SWFUpload.prototype.setPostParams = function (paramsObject) {
+ this.settings.post_params = paramsObject;
+ this.callFlash("SetPostParams", [paramsObject]);
};
-SWFUpload.prototype.setUploadURL = function (url) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetUploadURL) === "function") {
- try {
- this.addSetting("upload_url", url);
- movie_element.SetUploadURL(this.getSetting("upload_url"));
- }
- catch (ex) {
- this.debug("Could not call SetUploadURL");
- }
- } else {
- this.debug("Could not find Flash element in setUploadURL");
- }
+// Public: addPostParam adds post name/value pair. Each name can have only one value.
+SWFUpload.prototype.addPostParam = function (name, value) {
+ this.settings.post_params[name] = value;
+ this.callFlash("SetPostParams", [this.settings.post_params]);
};
-SWFUpload.prototype.setPostParams = function (param_object) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetPostParams) === "function") {
- try {
- this.addSetting("post_params", param_object);
- movie_element.SetPostParams(this.getSetting("post_params"));
- }
- catch (ex) {
- this.debug("Could not call SetPostParams");
- }
- } else {
- this.debug("Could not find Flash element in SetPostParams");
- }
+// Public: removePostParam deletes post name/value pair.
+SWFUpload.prototype.removePostParam = function (name) {
+ delete this.settings.post_params[name];
+ this.callFlash("SetPostParams", [this.settings.post_params]);
};
+// Public: setFileTypes changes the file_types setting and the file_types_description setting
SWFUpload.prototype.setFileTypes = function (types, description) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetFileTypes) === "function") {
- try {
- this.addSetting("file_types", types);
- this.addSetting("file_types_description", description);
- movie_element.SetFileTypes(this.getSetting("file_types"), this.getSetting("file_types_description"));
- }
- catch (ex) {
- this.debug("Could not call SetFileTypes");
- }
- } else {
- this.debug("Could not find Flash element in SetFileTypes");
- }
+ this.settings.file_types = types;
+ this.settings.file_types_description = description;
+ this.callFlash("SetFileTypes", [types, description]);
};
-SWFUpload.prototype.setFileSizeLimit = function (file_size_limit) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetFileSizeLimit) === "function") {
- try {
- this.addSetting("file_size_limit", file_size_limit);
- movie_element.SetFileSizeLimit(this.getSetting("file_size_limit"));
- }
- catch (ex) {
- this.debug("Could not call SetFileSizeLimit");
- }
- } else {
- this.debug("Could not find Flash element in SetFileSizeLimit");
- }
+// Public: setFileSizeLimit changes the file_size_limit setting
+SWFUpload.prototype.setFileSizeLimit = function (fileSizeLimit) {
+ this.settings.file_size_limit = fileSizeLimit;
+ this.callFlash("SetFileSizeLimit", [fileSizeLimit]);
};
-SWFUpload.prototype.setFileUploadLimit = function (file_upload_limit) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetFileUploadLimit) === "function") {
- try {
- this.addSetting("file_upload_limit", file_upload_limit);
- movie_element.SetFileUploadLimit(this.getSetting("file_upload_limit"));
- }
- catch (ex) {
- this.debug("Could not call SetFileUploadLimit");
- }
- } else {
- this.debug("Could not find Flash element in SetFileUploadLimit");
- }
+// Public: setFileUploadLimit changes the file_upload_limit setting
+SWFUpload.prototype.setFileUploadLimit = function (fileUploadLimit) {
+ this.settings.file_upload_limit = fileUploadLimit;
+ this.callFlash("SetFileUploadLimit", [fileUploadLimit]);
};
-SWFUpload.prototype.setFileQueueLimit = function (file_queue_limit) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetFileQueueLimit) === "function") {
- try {
- this.addSetting("file_queue_limit", file_queue_limit);
- movie_element.SetFileQueueLimit(this.getSetting("file_queue_limit"));
- }
- catch (ex) {
- this.debug("Could not call SetFileQueueLimit");
- }
- } else {
- this.debug("Could not find Flash element in SetFileQueueLimit");
- }
+// Public: setFileQueueLimit changes the file_queue_limit setting
+SWFUpload.prototype.setFileQueueLimit = function (fileQueueLimit) {
+ this.settings.file_queue_limit = fileQueueLimit;
+ this.callFlash("SetFileQueueLimit", [fileQueueLimit]);
};
-SWFUpload.prototype.setFilePostName = function (file_post_name) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetFilePostName) === "function") {
- try {
- this.addSetting("file_post_name", file_post_name);
- movie_element.SetFilePostName(this.getSetting("file_post_name"));
- }
- catch (ex) {
- this.debug("Could not call SetFilePostName");
- }
- } else {
- this.debug("Could not find Flash element in SetFilePostName");
- }
+// Public: setFilePostName changes the file_post_name setting
+SWFUpload.prototype.setFilePostName = function (filePostName) {
+ this.settings.file_post_name = filePostName;
+ this.callFlash("SetFilePostName", [filePostName]);
};
-SWFUpload.prototype.setDebugEnabled = function (debug_enabled) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.SetDebugEnabled) === "function") {
- try {
- this.addSetting("debug_enabled", debug_enabled);
- movie_element.SetDebugEnabled(this.getSetting("debug_enabled"));
- }
- catch (ex) {
- this.debug("Could not call SetDebugEnabled");
- }
- } else {
- this.debug("Could not find Flash element in SetDebugEnabled");
- }
+// Public: setUseQueryString changes the use_query_string setting
+SWFUpload.prototype.setUseQueryString = function (useQueryString) {
+ this.settings.use_query_string = useQueryString;
+ this.callFlash("SetUseQueryString", [useQueryString]);
};
-/* *******************************
- Internal Event Callers
- Don't override these! These event callers ensure that your custom event handlers
- are called safely and in order.
-******************************* */
+// Public: setRequeueOnError changes the requeue_on_error setting
+SWFUpload.prototype.setRequeueOnError = function (requeueOnError) {
+ this.settings.requeue_on_error = requeueOnError;
+ this.callFlash("SetRequeueOnError", [requeueOnError]);
+};
-/* This is the callback method that the Flash movie will call when it has been loaded and is ready to go.
- Calling this or showUI() "manually" will bypass the Flash Detection built in to SWFUpload.
- Use a ui_function setting if you want to control the UI loading after the flash has loaded.
-*/
-SWFUpload.prototype.flashReady = function () {
- // Check that the movie element is loaded correctly with its ExternalInterface methods defined
- var movie_element = this.getMovieElement();
- if (movie_element === null || typeof(movie_element.StartUpload) !== "function") {
- this.debug("ExternalInterface methods failed to initialize.");
- return;
+// Public: setHTTPSuccess changes the http_success setting
+SWFUpload.prototype.setHTTPSuccess = function (http_status_codes) {
+ if (typeof http_status_codes === "string") {
+ http_status_codes = http_status_codes.replace(" ", "").split(",");
}
- var self = this;
- if (typeof(self.flashReady_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.flashReady_handler(); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("flashReady_handler event not defined");
- }
+ this.settings.http_success = http_status_codes;
+ this.callFlash("SetHTTPSuccess", [http_status_codes]);
};
-/*
- Event Queue. Rather can call events directly from Flash they events are
- are placed in a queue and then executed. This ensures that each event is
- executed in the order it was called which is not guarenteed when calling
- setTimeout. Out of order events was especially problematic in Safari.
-*/
-SWFUpload.prototype.executeNextEvent = function () {
- var f = this.eventQueue.shift();
- if (typeof(f) === "function") {
- f();
- }
-}
-
-/* This is a chance to do something before the browse window opens */
-SWFUpload.prototype.fileDialogStart = function () {
- var self = this;
- if (typeof(self.fileDialogStart_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.fileDialogStart_handler(); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("fileDialogStart event not defined");
- }
+// Public: setHTTPSuccess changes the http_success setting
+SWFUpload.prototype.setAssumeSuccessTimeout = function (timeout_seconds) {
+ this.settings.assume_success_timeout = timeout_seconds;
+ this.callFlash("SetAssumeSuccessTimeout", [timeout_seconds]);
};
+// Public: setDebugEnabled changes the debug_enabled setting
+SWFUpload.prototype.setDebugEnabled = function (debugEnabled) {
+ this.settings.debug_enabled = debugEnabled;
+ this.callFlash("SetDebugEnabled", [debugEnabled]);
+};
-/* Called when a file is successfully added to the queue. */
-SWFUpload.prototype.fileQueued = function (file) {
- var self = this;
- if (typeof(self.fileQueued_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.fileQueued_handler(file); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("fileQueued event not defined");
+// Public: setButtonImageURL loads a button image sprite
+SWFUpload.prototype.setButtonImageURL = function (buttonImageURL) {
+ if (buttonImageURL == undefined) {
+ buttonImageURL = "";
}
+
+ this.settings.button_image_url = buttonImageURL;
+ this.callFlash("SetButtonImageURL", [buttonImageURL]);
};
-
-/* Handle errors that occur when an attempt to queue a file fails. */
-SWFUpload.prototype.fileQueueError = function (file, error_code, message) {
- var self = this;
- if (typeof(self.fileQueueError_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.fileQueueError_handler(file, error_code, message); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("fileQueueError event not defined");
+// Public: setButtonDimensions resizes the Flash Movie and button
+SWFUpload.prototype.setButtonDimensions = function (width, height) {
+ this.settings.button_width = width;
+ this.settings.button_height = height;
+
+ var movie = this.getMovieElement();
+ if (movie != undefined) {
+ movie.style.width = width + "px";
+ movie.style.height = height + "px";
}
+
+ this.callFlash("SetButtonDimensions", [width, height]);
+};
+// Public: setButtonText Changes the text overlaid on the button
+SWFUpload.prototype.setButtonText = function (html) {
+ this.settings.button_text = html;
+ this.callFlash("SetButtonText", [html]);
+};
+// Public: setButtonTextPadding changes the top and left padding of the text overlay
+SWFUpload.prototype.setButtonTextPadding = function (left, top) {
+ this.settings.button_text_top_padding = top;
+ this.settings.button_text_left_padding = left;
+ this.callFlash("SetButtonTextPadding", [left, top]);
};
-/* Called after the file dialog has closed and the selected files have been queued.
- You could call startUpload here if you want the queued files to begin uploading immediately. */
-SWFUpload.prototype.fileDialogComplete = function (num_files_selected) {
- var self = this;
- if (typeof(self.fileDialogComplete_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.fileDialogComplete_handler(num_files_selected); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("fileDialogComplete event not defined");
- }
+// Public: setButtonTextStyle changes the CSS used to style the HTML/Text overlaid on the button
+SWFUpload.prototype.setButtonTextStyle = function (css) {
+ this.settings.button_text_style = css;
+ this.callFlash("SetButtonTextStyle", [css]);
+};
+// Public: setButtonDisabled disables/enables the button
+SWFUpload.prototype.setButtonDisabled = function (isDisabled) {
+ this.settings.button_disabled = isDisabled;
+ this.callFlash("SetButtonDisabled", [isDisabled]);
+};
+// Public: setButtonAction sets the action that occurs when the button is clicked
+SWFUpload.prototype.setButtonAction = function (buttonAction) {
+ this.settings.button_action = buttonAction;
+ this.callFlash("SetButtonAction", [buttonAction]);
};
-/* Gets called when a file upload is about to be started. Return true to continue the upload. Return false to stop the upload.
- If you return false then uploadError and uploadComplete are called (like normal).
+// Public: setButtonCursor changes the mouse cursor displayed when hovering over the button
+SWFUpload.prototype.setButtonCursor = function (cursor) {
+ this.settings.button_cursor = cursor;
+ this.callFlash("SetButtonCursor", [cursor]);
+};
+
+/* *******************************
+ Flash Event Interfaces
+ These functions are used by Flash to trigger the various
+ events.
- This is a good place to do any file validation you need.
- */
-SWFUpload.prototype.uploadStart = function (file) {
- var self = this;
- if (typeof(self.fileDialogComplete_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.returnUploadStart(self.uploadStart_handler(file)); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("uploadStart event not defined");
+ All these functions a Private.
+
+ Because the ExternalInterface library is buggy the event calls
+ are added to a queue and the queue then executed by a setTimeout.
+ This ensures that events are executed in a determinate order and that
+ the ExternalInterface bugs are avoided.
+******************************* */
+
+SWFUpload.prototype.queueEvent = function (handlerName, argumentArray) {
+ // Warning: Don't call this.debug inside here or you'll create an infinite loop
+
+ if (argumentArray == undefined) {
+ argumentArray = [];
+ } else if (!(argumentArray instanceof Array)) {
+ argumentArray = [argumentArray];
}
-};
+
+ var self = this;
+ if (typeof this.settings[handlerName] === "function") {
+ // Queue the event
+ this.eventQueue.push(function () {
+ this.settings[handlerName].apply(this, argumentArray);
+ });
+
+ // Execute the next queued event
+ setTimeout(function () {
+ self.executeNextEvent();
+ }, 0);
+
+ } else if (this.settings[handlerName] !== null) {
+ throw "Event handler " + handlerName + " is unknown or is not a function";
+ }
+};
+
+// Private: Causes the next event in the queue to be executed. Since events are queued using a setTimeout
+// we must queue them in order to garentee that they are executed in order.
+SWFUpload.prototype.executeNextEvent = function () {
+ // Warning: Don't call this.debug inside here or you'll create an infinite loop
-/* Note: Internal use only. This function returns the result of uploadStart to
- flash. Since returning values in the normal way can result in Flash/JS circular
- call issues we split up the call in a Timeout. This is transparent from the API
- point of view.
-*/
-SWFUpload.prototype.returnUploadStart = function (return_value) {
- var movie_element = this.getMovieElement();
- if (movie_element !== null && typeof(movie_element.ReturnUploadStart) === "function") {
- try {
- movie_element.ReturnUploadStart(return_value);
- }
- catch (ex) {
- this.debug("Could not call ReturnUploadStart");
- }
- } else {
- this.debug("Could not find Flash element in returnUploadStart");
+ var f = this.eventQueue ? this.eventQueue.shift() : null;
+ if (typeof(f) === "function") {
+ f.apply(this);
}
};
+// Private: unescapeFileParams is part of a workaround for a flash bug where objects passed through ExternalInterface cannot have
+// properties that contain characters that are not valid for JavaScript identifiers. To work around this
+// the Flash Component escapes the parameter names and we must unescape again before passing them along.
+SWFUpload.prototype.unescapeFilePostParams = function (file) {
+ var reg = /[$]([0-9a-f]{4})/i;
+ var unescapedPost = {};
+ var uk;
+ if (file != undefined) {
+ for (var k in file.post) {
+ if (file.post.hasOwnProperty(k)) {
+ uk = k;
+ var match;
+ while ((match = reg.exec(uk)) !== null) {
+ uk = uk.replace(match[0], String.fromCharCode(parseInt("0x" + match[1], 16)));
+ }
+ unescapedPost[uk] = file.post[k];
+ }
+ }
-/* Called during upload as the file progresses. Use this event to update your UI. */
-SWFUpload.prototype.uploadProgress = function (file, bytes_complete, bytes_total) {
- var self = this;
- if (typeof(self.uploadProgress_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.uploadProgress_handler(file, bytes_complete, bytes_total); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("uploadProgress event not defined");
+ file.post = unescapedPost;
}
-};
-/* Called when an error occurs during an upload. Use error_code and the SWFUpload.UPLOAD_ERROR constants to determine
- which error occurred. The uploadComplete event is called after an error code indicating that the next file is
- ready for upload. For files cancelled out of order the uploadComplete event will not be called. */
-SWFUpload.prototype.uploadError = function (file, error_code, message) {
- var self = this;
- if (typeof(this.uploadError_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.uploadError_handler(file, error_code, message); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("uploadError event not defined");
- }
+ return file;
};
-/* This gets called when a file finishes uploading and the server-side upload script has completed and returned a 200
-status code. Any text returned by the server is available in server_data.
-**NOTE: The upload script MUST return some text or the uploadSuccess and uploadComplete events will not fire and the
-upload will become 'stuck'. */
-SWFUpload.prototype.uploadSuccess = function (file, server_data) {
- var self = this;
- if (typeof(self.uploadSuccess_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.uploadSuccess_handler(file, server_data); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("uploadSuccess event not defined");
+// Private: Called by Flash to see if JS can call in to Flash (test if External Interface is working)
+SWFUpload.prototype.testExternalInterface = function () {
+ try {
+ return this.callFlash("TestExternalInterface");
+ } catch (ex) {
+ return false;
}
};
-/* uploadComplete is called when the file is uploaded or an error occurred and SWFUpload is ready to make the next upload.
- If you want the next upload to start to automatically you can call startUpload() from this event. */
-SWFUpload.prototype.uploadComplete = function (file) {
- var self = this;
- if (typeof(self.uploadComplete_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.uploadComplete_handler(file); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.debug("uploadComplete event not defined");
- }
-};
+// Private: This event is called by Flash when it has finished loading. Don't modify this.
+// Use the swfupload_loaded_handler event setting to execute custom code when SWFUpload has loaded.
+SWFUpload.prototype.flashReady = function () {
+ // Check that the movie element is loaded correctly with its ExternalInterface methods defined
+ var movieElement = this.getMovieElement();
-/* Called by SWFUpload JavaScript and Flash functions when debug is enabled. By default it writes messages to the
- internal debug console. You can override this event and have messages written where you want. */
-SWFUpload.prototype.debug = function (message) {
- var self = this;
- if (typeof(self.debug_handler) === "function") {
- this.eventQueue[this.eventQueue.length] = function() { self.debug_handler(message); };
- setTimeout(function () { self.executeNextEvent();}, 0);
- } else {
- this.eventQueue[this.eventQueue.length] = function() { self.debugMessage(message); };
- setTimeout(function () { self.executeNextEvent();}, 0);
+ if (!movieElement) {
+ this.debug("Flash called back ready but the flash movie can't be found.");
+ return;
}
-};
-
-/* **********************************
- Default Event Handlers.
- These event handlers are used by default if an overriding handler is
- not defined in the SWFUpload settings object.
+ this.cleanUp(movieElement);
- JS Note: even though these are defined on the SWFUpload object (rather than the prototype) they
- are attached (read: copied) to a SWFUpload instance and 'this' is given the proper context.
- ********************************** */
+ this.queueEvent("swfupload_loaded_handler");
+};
-/* This is a special event handler that has no override in the settings. Flash calls this when it has
- been loaded by the browser and is ready for interaction. You should not override it. If you need
- to do something with SWFUpload has loaded then use the swfupload_loaded_handler setting.
-*/
-SWFUpload.flashReady = function () {
+// Private: removes Flash added fuctions to the DOM node to prevent memory leaks in IE.
+// This function is called by Flash each time the ExternalInterface functions are created.
+SWFUpload.prototype.cleanUp = function (movieElement) {
+ // Pro-actively unhook all the Flash functions
try {
- this.debug("Flash called back and is ready.");
-
- if (typeof(this.swfUploadLoaded_handler) === "function") {
- this.swfUploadLoaded_handler();
+ if (this.movieElement && typeof(movieElement.CallFunction) === "unknown") { // We only want to do this in IE
+ this.debug("Removing Flash functions hooks (this should only run in IE and should prevent memory leaks)");
+ for (var key in movieElement) {
+ try {
+ if (typeof(movieElement[key]) === "function") {
+ movieElement[key] = null;
+ }
+ } catch (ex) {
+ }
+ }
}
- } catch (ex) {
- this.debug(ex);
+ } catch (ex1) {
+
}
-};
-/* This is a chance to something immediately after SWFUpload has loaded.
- Like, hide the default/degraded upload form and display the SWFUpload form. */
-SWFUpload.swfUploadLoaded = function () {
+ // Fix Flashes own cleanup code so if the SWFMovie was removed from the page
+ // it doesn't display errors.
+ window["__flash__removeCallback"] = function (instance, name) {
+ try {
+ if (instance) {
+ instance[name] = null;
+ }
+ } catch (flashEx) {
+
+ }
+ };
+
};
+
/* This is a chance to do something before the browse window opens */
-SWFUpload.fileDialogStart = function () {
+SWFUpload.prototype.fileDialogStart = function () {
+ this.queueEvent("file_dialog_start_handler");
};
/* Called when a file is successfully added to the queue. */
-SWFUpload.fileQueued = function (file) {
+SWFUpload.prototype.fileQueued = function (file) {
+ file = this.unescapeFilePostParams(file);
+ this.queueEvent("file_queued_handler", file);
};
/* Handle errors that occur when an attempt to queue a file fails. */
-SWFUpload.fileQueueError = function (file, error_code, message) {
- try {
- switch (error_code) {
- case SWFUpload.QUEUE_ERROR.FILE_EXCEEDS_SIZE_LIMIT:
- this.debug("Error Code: File too big, File name: " + file.name + ", File size: " + file.size + ", Message: " + message);
- break;
- case SWFUpload.QUEUE_ERROR.ZERO_BYTE_FILE:
- this.debug("Error Code: Zero Byte File, File name: " + file.name + ", File size: " + file.size + ", Message: " + message);
- break;
- case SWFUpload.QUEUE_ERROR.QUEUE_LIMIT_EXCEEDED:
- this.debug("Error Code: Upload limit reached, File name: " + file.name + ", File size: " + file.size + ", Message: " + message);
- break;
- case SWFUpload.QUEUE_ERROR.INVALID_FILETYPE:
- this.debug("Error Code: File extension is not allowed, Message: " + message);
- break;
- default:
- this.debug("Error Code: Unhandled error occured. Errorcode: " + error_code);
- }
- } catch (ex) {
- this.debug(ex);
- }
+SWFUpload.prototype.fileQueueError = function (file, errorCode, message) {
+ file = this.unescapeFilePostParams(file);
+ this.queueEvent("file_queue_error_handler", [file, errorCode, message]);
};
/* Called after the file dialog has closed and the selected files have been queued.
You could call startUpload here if you want the queued files to begin uploading immediately. */
-SWFUpload.fileDialogComplete = function (num_files_selected) {
+SWFUpload.prototype.fileDialogComplete = function (numFilesSelected, numFilesQueued, numFilesInQueue) {
+ this.queueEvent("file_dialog_complete_handler", [numFilesSelected, numFilesQueued, numFilesInQueue]);
+};
+
+SWFUpload.prototype.uploadStart = function (file) {
+ file = this.unescapeFilePostParams(file);
+ this.queueEvent("return_upload_start_handler", file);
};
-/* Gets called when a file upload is about to be started. Return true to continue the upload. Return false to stop the upload.
- If you return false then the uploadError callback is called and then uploadComplete (like normal).
+SWFUpload.prototype.returnUploadStart = function (file) {
+ var returnValue;
+ if (typeof this.settings.upload_start_handler === "function") {
+ file = this.unescapeFilePostParams(file);
+ returnValue = this.settings.upload_start_handler.call(this, file);
+ } else if (this.settings.upload_start_handler != undefined) {
+ throw "upload_start_handler must be a function";
+ }
+
+ // Convert undefined to true so if nothing is returned from the upload_start_handler it is
+ // interpretted as 'true'.
+ if (returnValue === undefined) {
+ returnValue = true;
+ }
- This is a good place to do any file validation you need.
+ returnValue = !!returnValue;
- This is the only function that cannot be called on a setTimeout because it must return a value to Flash.
- You SHOULD NOT make any calls in to Flash (e.i, changing settings, getting stats, etc). Flash Player bugs prevent
- calls in to Flash from working reliably.
-*/
-SWFUpload.uploadStart = function (file) {
- return true;
+ this.callFlash("ReturnUploadStart", [returnValue]);
};
-// Called during upload as the file progresses
-SWFUpload.uploadProgress = function (file, bytes_complete, bytes_total) {
- this.debug("File Progress: " + file.id + ", Bytes: " + bytes_complete + ". Total: " + bytes_total);
-};
-/* This gets called when a file finishes uploading and the upload script has completed and returned a 200 status code. Any text returned by the
-server is available in server_data. The upload script must return some text or uploadSuccess will not fire (neither will uploadComplete). */
-SWFUpload.uploadSuccess = function (file, server_data) {
- this.debug("Upload Success: " + file.id + ", Server: " + server_data);
+
+SWFUpload.prototype.uploadProgress = function (file, bytesComplete, bytesTotal) {
+ file = this.unescapeFilePostParams(file);
+ this.queueEvent("upload_progress_handler", [file, bytesComplete, bytesTotal]);
};
-/* This is called last. The file is uploaded or an error occurred and SWFUpload is ready to make the next upload.
- If you want to automatically start the next file just call startUpload from here.
-*/
-SWFUpload.uploadComplete = function (file) {
- this.debug("Upload Complete: " + file.id);
+SWFUpload.prototype.uploadError = function (file, errorCode, message) {
+ file = this.unescapeFilePostParams(file);
+ this.queueEvent("upload_error_handler", [file, errorCode, message]);
};
-// Called by SWFUpload JavaScript and Flash functions when debug is enabled.
-// Override this method in your settings to call your own debug message handler
-SWFUpload.debug = function (message) {
- if (this.getSetting("debug_enabled")) {
- this.debugMessage(message);
- }
+SWFUpload.prototype.uploadSuccess = function (file, serverData, responseReceived) {
+ file = this.unescapeFilePostParams(file);
+ this.queueEvent("upload_success_handler", [file, serverData, responseReceived]);
};
-/* Called when an upload occurs during upload. For HTTP errors 'message' will contain the HTTP STATUS CODE */
-SWFUpload.uploadError = function (file, errcode, msg) {
- try {
- switch (errcode) {
- case SWFUpload.UPLOAD_ERROR.SPECIFIED_FILE_ID_NOT_FOUND:
- this.debug("Error Code: File ID specified for upload was not found, Message: " + msg);
- break;
- case SWFUpload.UPLOAD_ERROR.HTTP_ERROR:
- this.debug("Error Code: HTTP Error, File name: " + file.name + ", Message: " + msg);
- break;
- case SWFUpload.UPLOAD_ERROR.MISSING_UPLOAD_URL:
- this.debug("Error Code: No backend file, File name: " + file.name + ", Message: " + msg);
- break;
- case SWFUpload.UPLOAD_ERROR.IO_ERROR:
- this.debug("Error Code: IO Error, File name: " + file.name + ", Message: " + msg);
- break;
- case SWFUpload.UPLOAD_ERROR.SECURITY_ERROR:
- this.debug("Error Code: Security Error, File name: " + file.name + ", Message: " + msg);
- break;
- case SWFUpload.UPLOAD_ERROR.UPLOAD_LIMIT_EXCEEDED:
- this.debug("Error Code: Upload limit reached, File name: " + file.name + ", File size: " + file.size + ", Message: " + msg);
- break;
- case SWFUpload.UPLOAD_ERROR.UPLOAD_FAILED:
- this.debug("Error Code: Upload Initialization exception, File name: " + file.name + ", File size: " + file.size + ", Message: " + msg);
- break;
- case SWFUpload.UPLOAD_ERROR.FILE_VALIDATION_FAILED:
- this.debug("Error Code: uploadStart callback returned false, File name: " + file.name + ", File size: " + file.size + ", Message: " + msg);
- break;
- case SWFUpload.UPLOAD_ERROR.FILE_CANCELLED:
- this.debug("Error Code: The file upload was cancelled, File name: " + file.name + ", File size: " + file.size + ", Message: " + msg);
- break;
- case SWFUpload.UPLOAD_ERROR.UPLOAD_STOPPED:
- this.debug("Error Code: The file upload was stopped, File name: " + file.name + ", File size: " + file.size + ", Message: " + msg);
- break;
- default:
- this.debug("Error Code: Unhandled error occured. Errorcode: " + errcode);
- }
- } catch (ex) {
- this.debug(ex);
- }
+SWFUpload.prototype.uploadComplete = function (file) {
+ file = this.unescapeFilePostParams(file);
+ this.queueEvent("upload_complete_handler", file);
};
+/* Called by SWFUpload JavaScript and Flash functions when debug is enabled. By default it writes messages to the
+ internal debug console. You can override this event and have messages written where you want. */
+SWFUpload.prototype.debug = function (message) {
+ this.queueEvent("debug_handler", message);
+};
/* **********************************
The console is automatically scrolled as messages appear.
- You can override this console (to use FireBug's console for instance) by setting the debug event method to your own function
- that handles the debug message
- ********************************** */
+ If you are using your own debug handler or when you deploy to production and
+ have debug disabled you can remove these functions to reduce the file size
+ and complexity.
+********************************** */
+
+// Private: debugMessage is the default debug_handler. If you want to print debug messages
+// call the debug() function. When overriding the function your own function should
+// check to see if the debug setting is true before outputting debug information.
SWFUpload.prototype.debugMessage = function (message) {
- var exception_message, exception_values;
-
- if (typeof(message) === "object" && typeof(message.name) === "string" && typeof(message.message) === "string") {
- exception_message = "";
- exception_values = [];
- for (var key in message) {
- exception_values.push(key + ": " + message[key]);
+ if (this.settings.debug) {
+ var exceptionMessage, exceptionValues = [];
+
+ // Check for an exception object and print it nicely
+ if (typeof message === "object" && typeof message.name === "string" && typeof message.message === "string") {
+ for (var key in message) {
+ if (message.hasOwnProperty(key)) {
+ exceptionValues.push(key + ": " + message[key]);
+ }
+ }
+ exceptionMessage = exceptionValues.join("\n") || "";
+ exceptionValues = exceptionMessage.split("\n");
+ exceptionMessage = "EXCEPTION: " + exceptionValues.join("\nEXCEPTION: ");
+ SWFUpload.Console.writeLine(exceptionMessage);
+ } else {
+ SWFUpload.Console.writeLine(message);
}
- exception_message = exception_values.join("\n");
- exception_values = exception_message.split("\n");
- exception_message = "EXCEPTION: " + exception_values.join("\nEXCEPTION: ");
- SWFUpload.Console.writeLine(exception_message);
- } else {
- SWFUpload.Console.writeLine(message);
}
};