66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * This module provides a UI for file selection and multiple file upload capability using
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * Flash as a transport engine.
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * The supported features include: automatic upload queue management, upload progress
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * tracking, file filtering, server response retrieval and error reporting.
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @module uploader-flash
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich// Shorthands for external modules
6a0b5391dbcaace88784e407eb97b46fc8ffb619Allen Rabinovich SELECT_FILES = getCN(UPLOADER, 'selectfiles-button');
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * This module provides a UI for file selection and multiple file upload capability
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * using Flash as a transport engine.
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @class UploaderFlash
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @extends Widget
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @constructor
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param {Object} config Configuration object.
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich UploaderFlash.superclass.constructor.apply ( this, arguments );
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen RabinovichY.UploaderFlash = Y.extend(UploaderFlash, Y.Widget, {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Stored value of the current button state (based on
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * mouse events dispatched by the Flash player)
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property _buttonState
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {String}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Stored value of the current button focus state (based
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * on keyboard and mouse events).
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property _buttonFocus
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Boolean}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Stored value of the unique id for the container that holds the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Flash uploader.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property _swfContainerId
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {String}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Stored reference to the instance of SWF used to host the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Flash uploader.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property _swfReference
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {SWF}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Stored reference to the instance of Uploader.Queue used to manage
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * the upload process. This is a read-only property that only exists
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * during an active upload process. Only one queue can be active at
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * a time; if an upload start is attempted while a queue is active,
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * it will be ignored.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property queue
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Y.Uploader.Queue}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Stored event bindings for keyboard navigation to and from the uploader.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property _tabElementBindings
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Object}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Construction logic executed during UploaderFlash instantiation.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method initializer
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich initializer : function () {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich // Assign protected variable values
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich // Publish available events
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that files have been selected.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event fileselect
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `fileselect` with the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * following payload:
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>fileList</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>An `Array` of files selected by the user, encapsulated
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * in Y.FileFlash objects.</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that an upload of multiple files has been started.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event uploadstart
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * @param event {Event} The event object for the `uploadstart`.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that an upload of a specific file has started.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event fileuploadstart
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `fileuploadstart` with the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * following payload:
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * <dt>file</dt>
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * <dd>A reference to the Y.File that dispatched the event.</dd>
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * <dt>originEvent</dt>
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * <dd>The original event dispatched by Y.File.</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Reports on upload progress of a specific file.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event uploadprogress
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `uploadprogress` with the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * following payload:
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>bytesLoaded</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The number of bytes of the file that has been uploaded</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>bytesTotal</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The total number of bytes in the file</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>percentLoaded</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The fraction of the file that has been uploaded, out of 100</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>originEvent</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The original event dispatched by the SWF uploader</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Reports on the total upload progress of the file list.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event totaluploadprogress
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `totaluploadprogress` with the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * following payload:
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>bytesLoaded</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The number of bytes of the file list that has been uploaded</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>bytesTotal</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The total number of bytes in the file list</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>percentLoaded</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The fraction of the file list that has been uploaded, out of 100</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that a single file upload has been completed.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event uploadcomplete
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `uploadcomplete` with the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * following payload:
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * <dt>file</dt>
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * <dd>The pointer to the instance of `Y.File` whose upload has been completed.</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>originEvent</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The original event fired by the SWF Uploader</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>data</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>Data returned by the server.</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that the upload process of the entire file list has been completed.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event alluploadscomplete
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `alluploadscomplete`.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that a error has occurred in a specific file's upload process.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event uploaderror
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `uploaderror` with the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * following payload:
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>originEvent</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The original error event fired by the SWF Uploader. </dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>file</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The pointer at the instance of Y.FileFlash that returned the error.</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>source</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The source of the upload error, either "io" or "http"</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dt>message</dt>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <dd>The message that accompanied the error. Corresponds to the text of
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * the error in cases where source is "io", and to the HTTP status for
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich cases where source is "http".</dd>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that a mouse has begun hovering over the `Select Files` button.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event mouseenter
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `mouseenter` event.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that a mouse has stopped hovering over the `Select Files` button.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event mouseleave
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `mouseleave` event.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that a mouse button has been pressed over the `Select Files` button.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event mousedown
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `mousedown` event.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that a mouse button has been released over the `Select Files` button.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event mouseup
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `mouseup` event.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Signals that a mouse has been clicked over the `Select Files` button.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @event click
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event {Event} The event object for the `click` event.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Creates the DOM structure for the UploaderFlash.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * UploaderFlash's DOM structure consists of two layers: the base "Select Files"
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * button that can be replaced by the developer's widget of choice; and a transparent
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Flash overlay positoned above the button that captures all input events.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The `position` style attribute of the `boundingBox` of the `Uploader` widget
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * is forced to be `relative`, in order to accommodate the Flash player overlay
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * (which is `position`ed `absolute`ly).
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method renderUI
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich renderUI : function () {
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich selFilesButton = this.get("selectFilesButton");
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich boundingBox.setStyle("position", "relative");
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich selFilesButton.setStyles({width: "100%", height: "100%"});
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich contentBox.append(Y.Node.create(substitute(UploaderFlash.FLASH_CONTAINER,
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich var flashContainer = Y.one("#" + this._swfContainerId);
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich this._swfReference = new Y.SWF(flashContainer, this.get("swfURL"), params);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Binds handlers to the UploaderFlash UI events and propagates attribute
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * values to the Flash player.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The propagation of initial values is set to occur once the Flash player
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * instance is ready (as indicated by the `swfReady` event.)
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method bindUI
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich bindUI : function () {
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich this._swfReference.on("swfReady", function () {
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich this.after("multipleFilesChange", this._setMultipleFiles, this);
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich this.after("fileFiltersChange", this._setFileFilters, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.after("enabledChange", this._triggerEnabled, this);
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich this._swfReference.on("fileselect", this._updateFileList, this);
6a0b5391dbcaace88784e407eb97b46fc8ffb619Allen Rabinovich this.after("tabElementsChange", this._attachTabElements);
70837a7c5871ea73a84ab67d8c34fcd9d2daa31cAllen Rabinovich // this._swfReference.on("trace", function (ev) {console.log(ev.message);});
6a0b5391dbcaace88784e407eb97b46fc8ffb619Allen Rabinovich this._swfReference.on("mouseenter", function () {
6a0b5391dbcaace88784e407eb97b46fc8ffb619Allen Rabinovich this._swfReference.on("mouseleave", function () {
6a0b5391dbcaace88784e407eb97b46fc8ffb619Allen Rabinovich this._swfReference.on("mousedown", function () {
6a0b5391dbcaace88784e407eb97b46fc8ffb619Allen Rabinovich this._swfReference.on("mouseup", function () {
6a0b5391dbcaace88784e407eb97b46fc8ffb619Allen Rabinovich this._swfReference.on("click", function () {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Attaches keyboard bindings to enabling tabbing to and from the instance of the Flash
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * player in the Uploader widget. If the previous and next elements are specified, the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * keyboard bindings enable the user to tab from the `tabElements["from"]` node to the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Flash-powered "Select Files" button, and to the `tabElements["to"]` node.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method _attachTabElements
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param ev {Event} Optional event payload if called as a `tabElementsChange` handler.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich if (this.get("tabElements") !== null && this.get("tabElements").from !== null && this.get("tabElements").to !== null) {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich if (this._tabElementBindings !== null) {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._tabElementBindings.tabforward.detach();
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich var fromElement = Y.one(this.get("tabElements").from);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich var toElement = Y.one(this.get("tabElements").to);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._tabElementBindings.from = fromElement.on("keydown", function (ev) {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference._swf.setAttribute("tabindex", 0);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference._swf.setAttribute("role", "button");
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference._swf.setAttribute("aria-label", this.get("selectButtonLabel"));
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._tabElementBindings.to = toElement.on("keydown", function (ev) {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference._swf.setAttribute("tabindex", 0);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference._swf.setAttribute("role", "button");
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference._swf.setAttribute("aria-label", this.get("selectButtonLabel"));
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._tabElementBindings.tabback = this._swfReference.on("tabback", function (ev) {this._swfReference._swf.blur(); setTimeout(function () {fromElement.focus();}, 30);}, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._tabElementBindings.tabforward = this._swfReference.on("tabforward", function (ev) {this._swfReference._swf.blur(); setTimeout(function () {toElement.focus();}, 30);}, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._tabElementBindings.focus = this._swfReference._swf.on("focus", function (ev) {this._buttonFocus = true; this._setButtonClass("focus", true);}, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._tabElementBindings.blur = this._swfReference._swf.on("blur", function (ev) {this._buttonFocus = false; this._setButtonClass("focus", false);}, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich else if (this._tabElementBindings !== null) {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._tabElementBindings.tabforward.detach();
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Adds or removes a specified state CSS class to the underlying uploader button.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method _setButtonClass
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param state {String} The name of the state enumerated in `buttonClassNames` attribute
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * from which to derive the needed class name.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param add {Boolean} A Boolean indicating whether to add or remove the class.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.get("selectFilesButton").addClass(this.get("buttonClassNames")[state]);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.get("selectFilesButton").removeClass(this.get("buttonClassNames")[state]);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Syncs the state of the `fileFilters` attribute between the instance of UploaderFlash
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * and the Flash player.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method _setFileFilters
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich if (this._swfReference && this.get("fileFilters") !== null) {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference.callSWF("setFileFilters", [this.get("fileFilters")]);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Syncs the state of the `multipleFiles` attribute between this class
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * and the Flash uploader.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method _setMultipleFiles
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference.callSWF("setAllowMultipleFiles", [this.get("multipleFiles")]);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Syncs the state of the `enabled` attribute between this class
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * and the Flash uploader.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method _triggerEnabled
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference._swf.setAttribute("aria-disabled", "false");
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this._swfReference._swf.setAttribute("aria-disabled", "true");
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Adjusts the content of the `fileList` based on the results of file selection
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * and the `appendNewFiles` attribute. If the `appendNewFiles` attribute is true,
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * then selected files are appended to the existing list; otherwise, the list is
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * cleared and populated with the newly selected files.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method _updateFileList
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param ev {Event} The file selection event received from the uploader.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich newFileConf.name = value.fileReference.name;
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich newFileConf.size = value.fileReference.size;
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich newFileConf.type = value.fileReference.type;
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich newFileConf.dateCreated = value.fileReference.creationDate;
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich newFileConf.dateModified = value.fileReference.modificationDate;
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.fire("fileselect", {fileList: parsedFiles});
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.get("appendNewFiles") ? oldfiles.concat(parsedFiles) : parsedFiles );
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Handles and retransmits events fired by `Y.FileFlash` and `Y.Uploader.Queue`.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method _uploadEventHandler
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param event The event dispatched during the upload process.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich case "file:uploadstart":
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich case "file:uploadprogress":
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich case "uploaderqueue:totaluploadprogress":
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich case "file:uploadcomplete":
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich case "uploaderqueue:alluploadscomplete":
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich case "uploaderqueue:uploaderror":
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Starts the upload of a specific file.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method upload
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param file {Y.FileFlash} Reference to the instance of the file to be uploaded.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param url {String} The URL to upload the file to.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param postVars {Object} (optional) A set of key-value pairs to send as variables along with the file upload HTTP request.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * If not specified, the values from the attribute `postVarsPerFile` are used instead.
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich var uploadURL = url || this.get("uploadURL"),
9b1ad7c4722db362bee7d39c851c94ba95f118b8Allen Rabinovich postVars = postvars || this.get("postVarsPerFile"),
9b1ad7c4722db362bee7d39c851c94ba95f118b8Allen Rabinovich postVars = postVars.hasOwnProperty(fileId) ? postVars[fileId] : postVars;
9b1ad7c4722db362bee7d39c851c94ba95f118b8Allen Rabinovich file.on("uploadstart", this._uploadStartHandler, this);
9b1ad7c4722db362bee7d39c851c94ba95f118b8Allen Rabinovich file.on("uploadprogress", this._uploadProgressHandler, this);
9b1ad7c4722db362bee7d39c851c94ba95f118b8Allen Rabinovich file.on("uploadcomplete", this._uploadCompleteHandler, this);
9b1ad7c4722db362bee7d39c851c94ba95f118b8Allen Rabinovich file.on("uploaderror", this._uploadErrorHandler, this);
9b1ad7c4722db362bee7d39c851c94ba95f118b8Allen Rabinovich file.startUpload(uploadURL, postVars, this.get("fileFieldName"));
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Starts the upload of all files on the file list, using an automated queue.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method uploadAll
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param url {String} The URL to upload the files to.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param postVars {Object} (optional) A set of key-value pairs to send as variables along with the file upload HTTP request.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * If not specified, the values from the attribute `postVarsPerFile` are used instead.
9b1ad7c4722db362bee7d39c851c94ba95f118b8Allen Rabinovich this.uploadThese(this.get("fileList"), url, postvars);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Starts the upload of the files specified in the first argument, using an automated queue.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @method uploadThese
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param files {Array} The list of files to upload.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param url {String} The URL to upload the files to.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @param postVars {Object} (optional) A set of key-value pairs to send as variables along with the file upload HTTP request.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * If not specified, the values from the attribute `postVarsPerFile` are used instead.
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich uploadThese : function (files, url, postvars) {
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich var uploadURL = url || this.get("uploadURL"),
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich postVars = postvars || this.get("postVarsPerFile");
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.queue = new UploaderQueue({simUploads: this.get("simLimit"),
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.queue.on("uploadstart", this._uploadEventHandler, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.queue.on("uploadprogress", this._uploadEventHandler, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.queue.on("totaluploadprogress", this._uploadEventHandler, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.queue.on("uploadcomplete", this._uploadEventHandler, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.queue.on("alluploadscomplete", this._uploadEventHandler, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.queue.on("alluploadscancelled", function (ev) {this.queue = null;}, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich this.queue.on("uploaderror", this._uploadEventHandler, this);
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The template for the Flash player container. Since the Flash player container needs
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * to completely overlay the &lquot;Select Files&rqot; control, it's positioned absolutely,
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * with width and height set to 100% of the parent.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property FLASH_CONTAINER
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {String}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default "<div id='{swfContainerId}' style='position:absolute; top:0px; left: 0px; margin: 0; padding: 0; border: 0; width:100%; height:100%'></div>"
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich FLASH_CONTAINER: "<div id='{swfContainerId}' style='position:absolute; top:0px; left: 0px; margin: 0; padding: 0; border: 0; width:100%; height:100%'></div>",
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The template for the "Select Files" button.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property SELECT_FILES_BUTTON
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {String}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default "<button type='button' class='yui3-button' tabindex='-1'>{selectButtonLabel}</button>"
a9a4fee30864f00049b02201b1af50ada7f769e3Allen Rabinovich SELECT_FILES_BUTTON: "<button type='button' class='yui3-button' tabindex='-1'>{selectButtonLabel}</button>",
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The static property reflecting the type of uploader that `Y.Uploader`
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * aliases. The UploaderFlash value is `"flash"`.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property TYPE
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {String}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The identity of the widget.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property NAME
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type String
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default 'uploader'
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Static property used to define the default attribute configuration of
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * the Widget.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @property ATTRS
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Object}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * A Boolean indicating whether newly selected files should be appended
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * to the existing file list, or whether they should replace it.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute appendNewFiles
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Boolean}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default true
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The names of CSS classes that correspond to different button states
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * of the "Select Files" control. These classes are assigned to the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * "Select Files" control based on the mouse states reported by the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * Flash player. The keys for the class names are:
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> <strong>`hover`</strong>: the class corresponding to mouse hovering over
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * the "Select Files" button.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> <strong>`active`</strong>: the class corresponding to mouse down state of
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * the "Select Files" button.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> <strong>`disabled`</strong>: the class corresponding to the disabled state
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * of the "Select Files" button.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> <strong>`focus`</strong>: the class corresponding to the focused state of
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * the "Select Files" button.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute buttonClassNames
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Object}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default { hover: "yui3-button-hover",
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * active: "yui3-button-active",
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * disabled: "yui3-button-disabled",
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * focus: "yui3-button-selected"
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * A Boolean indicating whether the uploader is enabled or disabled for user input.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute enabled
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Boolean}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default true
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The action performed when an upload error occurs for a specific file being uploaded.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The possible values are:
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> <strong>`UploaderQueue.CONTINUE`</strong>: the error is ignored and the upload process is continued.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> <strong>`UploaderQueue.STOP`</strong>: the upload process is stopped as soon as any other parallel file
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * uploads are finished.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> <strong>`UploaderQueue.RESTART_ASAP`</strong>: the file is added back to the front of the queue.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> <strong>`UploaderQueue.RESTART_AFTER`</strong>: the file is added to the back of the queue.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute errorAction
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {String}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default UploaderQueue.CONTINUE
6a0b5391dbcaace88784e407eb97b46fc8ffb619Allen Rabinovich return (val === UploaderQueue.CONTINUE || val === UploaderQueue.STOP || val === UploaderQueue.RESTART_ASAP || val === UploaderQueue.RESTART_AFTER);
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * An array indicating what fileFilters should be applied to the file
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * selection dialog. Each element in the array should be an object with
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * the following key-value pairs:
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich * description : String
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich extensions: String of the form &lquot;*.ext1;*.ext2;*.ext3;...&rquot;
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @attribute fileFilters
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @type {Array}
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @default null
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * A String specifying what should be the POST field name for the file
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * content in the upload request.
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @attribute fileFieldName
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @type {String}
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @default Filedata
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * The array of files to be uploaded. All elements in the array
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * must be instances of `Y.FileFlash` and be instantiated with a `fileId`
7211944935145abdba8a3ea3b17621ec264d8e21Allen Rabinovich * retrieved from an instance of the uploader.
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @attribute fileList
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @type {Array}
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @default []
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * A Boolean indicating whether multiple file selection is enabled.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute multipleFiles
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Boolean}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default false
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * An object, keyed by `fileId`, containing sets of key-value pairs
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * that should be passed as POST variables along with each corresponding
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * file. This attribute is only used if no POST variables are specifed
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * in the upload method call.
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @attribute postVarsPerFile
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @type {Object}
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @default {}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The label for the "Select Files" widget. This is the value that replaces the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * `{selectButtonLabel}` token in the `SELECT_FILES_BUTTON` template.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute selectButtonLabel
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @type {String}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default "Select Files"
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * The widget that serves as the "Select Files" control for the file uploader
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute selectFilesButton
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Node | Widget}
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * @default A standard HTML button with YUI CSS Button skin.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich valueFn: function () {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich return Y.Node.create(substitute(Y.UploaderFlash.SELECT_FILES_BUTTON, {selectButtonLabel: this.get("selectButtonLabel")}));
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The number of files that can be uploaded
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * simultaneously if the automatic queue management
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * is used. This value can be in the range between 2
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute simLimit
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Number}
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * The URL to the SWF file of the flash uploader. A copy local to
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * the server that hosts the page on which the uploader appears is
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * recommended.
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @attribute swfURL
66900b43227bf441b6a6b1084af2c96ce2c747c8Allen Rabinovich * @type {String}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default "CDN Prefix + uploader/assets/flashuploader.swf" with a
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * random GET parameter for IE (to prevent buggy behavior when the SWF
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * is cached).
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich valueFn: function () {
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich var prefix = Y.Env.cdn + "uploader/assets/flashuploader.swf";
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich return (prefix + "?t=" + Y.guid("uploader"));
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The id's or `Node` references of the DOM elements that precede
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * and follow the `Select Files` button in the tab order. Specifying
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * these allows keyboard navigation to and from the Flash player
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * layer of the uploader.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * The two keys corresponding to the DOM elements are:
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> `from`: the id or the `Node` reference corresponding to the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * DOM element that precedes the `Select Files` button in the tab order.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * <li> `to`: the id or the `Node` reference corresponding to the
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * DOM element that follows the `Select Files` button in the tab order.</li>
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute tabElements
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {Object}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default null
76438e9b6959cc0bd7e35fb9cf5a11c87a37f744Allen Rabinovich * The URL to which file upload requested are POSTed. Only used if a different url is not passed to the upload method call.
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @attribute uploadURL
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @type {String}
ec749fdeacb8e11cb7a9dd6dcebd1538b953059eAllen Rabinovich * @default ""