egroupware/api/js/etemplate/et2_widget_file.js

623 lines
25 KiB
JavaScript

"use strict";
/**
* EGroupware eTemplate2 - JS Number object
*
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* @package etemplate
* @subpackage api
* @link http://www.egroupware.org
* @author Nathan Gray
* @copyright Nathan Gray 2011
* @version $Id$
*/
var __extends = (this && this.__extends) || (function () {
var extendStatics = function (d, b) {
extendStatics = Object.setPrototypeOf ||
({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
return extendStatics(d, b);
};
return function (d, b) {
extendStatics(d, b);
function __() { this.constructor = d; }
d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
};
})();
Object.defineProperty(exports, "__esModule", { value: true });
/*egw:uses
et2_core_inputWidget;
phpgwapi.Resumable.resumable;
*/
var et2_core_inputWidget_1 = require("./et2_core_inputWidget");
var et2_core_widget_1 = require("./et2_core_widget");
var et2_core_inheritance_1 = require("./et2_core_inheritance");
/**
* Class which implements file upload
*
* @augments et2_inputWidget
*/
var et2_file = /** @class */ (function (_super) {
__extends(et2_file, _super);
/**
* Constructor
*
* @memberOf et2_file
*/
function et2_file(_parent, _attrs, _child) {
var _this =
// Call the inherited constructor
_super.call(this, _parent, _attrs, et2_core_inheritance_1.ClassWithAttributes.extendAttributes(et2_file._attributes, _child || {})) || this;
_this.asyncOptions = {};
_this.input = null;
_this.progress = null;
_this.span = null;
_this.node = null;
_this.input = null;
_this.progress = null;
_this.span = null;
// Contains all submit buttons need to be disabled during upload process
_this.disabled_buttons = jQuery("input[type='submit'], button");
if (!_this.options.value)
_this.options.value = {};
if (!_this.options.id) {
console.warn("File widget needs an ID. Used 'file_widget'.");
_this.options.id = "file_widget";
}
// Legacy - id ending in [] means multiple
if (_this.options.id.substr(-2) == "[]") {
_this.options.multiple = true;
}
// If ID ends in /, it's a directory - allow multiple
else if (_this.options.id.substr(-1) === "/") {
_this.options.multiple = true;
_attrs.multiple = true;
}
// Set up the URL to have the request ID & the widget ID
var instance = _this.getInstanceManager();
var self = _this;
_this.asyncOptions = jQuery.extend({
// Callbacks
onStart: function (event, file_count) {
return self.onStart(event, file_count);
},
onFinish: function (event, file_count) {
self.onFinish.apply(self, [event, file_count]);
},
onStartOne: function (event, file_name, index, file_count) {
},
onFinishOne: function (event, response, name, number, total) { return self.finishUpload(event, response, name, number, total); },
onProgress: function (event, progress, name, number, total) { return self.onProgress(event, progress, name, number, total); },
onError: function (event, name, error) { return self.onError(event, name, error); },
beforeSend: function (form) { return self.beforeSend(form); },
chunkSize: _this.options.chunk_size || 1024 * 1024,
target: egw.ajaxUrl("EGroupware\\Api\\Etemplate\\Widget\\File::ajax_upload"),
query: function (file) { return self.beforeSend(file); },
// Disable checking for already uploaded chunks
testChunks: false
}, _this.asyncOptions);
_this.asyncOptions.fieldName = _this.options.id;
_this.createInputWidget();
_this.set_readonly(_this.options.readonly);
return _this;
}
et2_file.prototype.destroy = function () {
_super.prototype.destroy.call(this);
this.set_drop_target(null);
this.node = null;
this.input = null;
this.span = null;
this.progress = null;
};
et2_file.prototype.createInputWidget = function () {
this.node = jQuery(document.createElement("div")).addClass("et2_file");
this.span = jQuery(document.createElement("span"))
.addClass('et2_file_span et2_button')
.appendTo(this.node);
if (this.options.label != '')
this.span.addClass('et2_button_text');
var span = this.span;
this.input = jQuery(document.createElement("input"))
.attr("type", "file").attr("placeholder", this.options.blur)
.addClass("et2_file_upload")
.appendTo(this.node)
.hover(function () {
jQuery(span)
.toggleClass('et2_file_spanHover');
})
.on({
mousedown: function () {
jQuery(span).addClass('et2_file_spanActive');
},
mouseup: function () {
jQuery(span).removeClass('et2_file_spanActive');
}
});
if (this.options.accept)
this.input.attr('accept', this.options.accept);
var self = this;
// trigger native input upload file
if (!this.options.readonly)
this.span.click(function () { self.input.click(); });
// Check for File interface, should fall back to normal form submit if missing
if (typeof File != "undefined" && typeof (new XMLHttpRequest()).upload != "undefined") {
this.resumable = new Resumable(this.asyncOptions);
this.resumable.assignBrowse(this.input);
this.resumable.on('fileAdded', jQuery.proxy(this._fileAdded, this));
this.resumable.on('fileProgress', jQuery.proxy(this._fileProgress, this));
this.resumable.on('fileSuccess', jQuery.proxy(this.finishUpload, this));
this.resumable.on('complete', jQuery.proxy(this.onFinish, this));
}
else {
// This may be a problem submitting via ajax
}
if (this.options.progress) {
var widget = this.getRoot().getWidgetById(this.options.progress);
if (widget) {
//may be not available at createInputWidget time
this.progress = jQuery(widget.getDOMNode());
}
}
if (!this.progress) {
this.progress = jQuery(document.createElement("div")).appendTo(this.node);
}
this.progress.addClass("progress");
if (this.options.multiple) {
this.input.attr("multiple", "multiple");
}
this.setDOMNode(this.node[0]);
};
/**
* Set a widget or DOM node as a HTML5 file drop target
*
* @param {string} new_target widget ID or DOM node ID to be used as a new target
*/
et2_file.prototype.set_drop_target = function (new_target) {
// Cancel old drop target
if (this.options.drop_target) {
var widget_1 = this.getRoot().getWidgetById(this.options.drop_target);
var drop_target_1 = widget_1 && widget_1.getDOMNode() || document.getElementById(this.options.drop_target);
if (drop_target_1) {
this.resumable.unAssignDrop(drop_target_1);
}
}
this.options.drop_target = new_target;
if (!this.options.drop_target)
return;
// Set up new drop target
var widget = this.getRoot().getWidgetById(this.options.drop_target);
var drop_target = widget && widget.getDOMNode() || document.getElementById(this.options.drop_target);
if (drop_target) {
this.resumable.assignDrop([drop_target]);
}
else {
this.egw().debug("warn", "Did not find file drop target %s", this.options.drop_target);
}
};
et2_file.prototype.attachToDOM = function () {
var res = _super.prototype.attachToDOM.call(this);
// Override parent's change, file widget will fire change when finished uploading
this.input.unbind("change.et2_inputWidget");
return res;
};
et2_file.prototype.getValue = function () {
return this.options.value ? this.options.value : this.input.val();
};
/**
* Set the value of the file widget.
*
* If you pass a FileList or list of files, it will trigger the async upload
*
* @param {FileList|File[]|false} value List of files to be uploaded, or false to reset.
* @param {Event} event Most browsers require the user to initiate file transfers in some way.
* Pass the event in, if you have it.
*/
et2_file.prototype.set_value = function (value, event) {
if (!value || typeof value == "undefined") {
value = {};
}
if (jQuery.isEmptyObject(value)) {
this.options.value = {};
if (this.resumable.progress() == 1)
this.progress.empty();
// Reset the HTML element
this.input.wrap('<form>').closest('form').get(0).reset();
this.input.unwrap();
return;
}
var addFile = jQuery.proxy(function (i, file) {
this.resumable.addFile(file, event);
}, this);
if (typeof value == 'object' && value.length && typeof value[0] == 'object' && value[0].name) {
try {
this.input[0].files = value;
jQuery.each(value, addFile);
}
catch (e) {
var self = this;
var args = arguments;
jQuery.each(value, addFile);
}
}
};
/**
* Set the value for label
* The label is used as caption for span tag which customize the HTML file upload styling
*
* @param {string} value text value of label
*/
et2_file.prototype.set_label = function (value) {
if (this.span != null && value != null) {
this.span.text(value);
}
};
et2_file.prototype.getInputNode = function () {
if (typeof this.input == 'undefined')
return false;
return this.input[0];
};
et2_file.prototype.set_mime = function (mime) {
if (!mime) {
this.options.mime = null;
}
if (mime.indexOf("/") != 0) {
// Lower case it now, if it's not a regex
this.options.mime = mime.toLowerCase();
}
else {
// Convert into a js regex
var parts = mime.substr(1).match(/(.*)\/([igm]?)$/);
this.options.mime = new RegExp(parts[1], parts.length > 2 ? parts[2] : "");
}
};
et2_file.prototype.set_multiple = function (_multiple) {
this.options.multiple = _multiple;
if (_multiple) {
return this.input.attr("multiple", "multiple");
}
return this.input.removeAttr("multiple");
};
/**
* Check to see if the provided file's mimetype matches
*
* @param f File object
* @return boolean
*/
et2_file.prototype.checkMime = function (f) {
// If missing, let the server handle it
if (!this.options.mime || !f.type)
return true;
var is_preg = (typeof this.options.mime == "object");
if (!is_preg && f.type.toLowerCase() == this.options.mime || is_preg && this.options.mime.test(f.type)) {
return true;
}
// Not right mime
return false;
};
et2_file.prototype._fileAdded = function (file, event) {
// Manual additions have no event
if (typeof event == 'undefined') {
event = {};
}
// Trigger start of uploading, calls callback
if (!this.resumable.isUploading()) {
if (!(this.onStart(event, this.resumable.files.length)))
return;
}
// Here 'this' is the input
if (this.checkMime(file.file)) {
if (this.createStatus(event, file)) {
// Disable buttons
this.disabled_buttons
.not("[disabled]")
.attr("disabled", true)
.addClass('et2_button_ro')
.removeClass('et2_clickable')
.css('cursor', 'default');
// Actually start uploading
this.resumable.upload();
}
}
else {
// Wrong mime type - show in the list of files
return this.createStatus(this.egw().lang("File is of wrong type (%1 != %2)!", file.file.type, this.options.mime), file);
}
};
/**
* Add in the request id
*/
et2_file.prototype.beforeSend = function (form) {
var instance = this.getInstanceManager();
return {
request_id: instance.etemplate_exec_id,
widget_id: this.id
};
};
/**
* Disables submit buttons while uploading
*/
et2_file.prototype.onStart = function (event, file_count) {
// Hide any previous errors
this.hideMessage();
event.data = this;
//Add dropdown_progress
if (this.options.progress_dropdownlist) {
this._build_progressDropDownList();
}
// Callback
if (this.options.onStart)
return et2_call(this.options.onStart, event, file_count);
return true;
};
/**
* Re-enables submit buttons when done
*/
et2_file.prototype.onFinish = function () {
this.disabled_buttons.attr("disabled", 0).css('cursor', 'pointer').removeClass('et2_button_ro');
var file_count = this.resumable.files.length;
// Remove files from list
while (this.resumable.files.length > 0) {
this.resumable.removeFile(this.resumable.files[this.resumable.files.length - 1]);
}
var event = jQuery.Event('upload');
event.data = this;
var result = false;
//Remove progress_dropDown_fileList class and unbind the click handler from body
if (this.options.progress_dropdownlist) {
this.progress.removeClass("progress_dropDown_fileList");
jQuery(this.node).find('span').removeClass('totalProgress_loader');
jQuery('body').off('click');
}
if (this.options.onFinish && !jQuery.isEmptyObject(this.getValue())) {
result = et2_call(this.options.onFinish, event, file_count);
}
else {
result = (file_count == 0 || !jQuery.isEmptyObject(this.getValue()));
}
if (result) {
// Fire legacy change action when done
this.change(this.input);
}
};
/**
* Build up dropdown progress with total count indicator
*
* @todo Implement totalProgress bar instead of ajax-loader, in order to show how much percent of uploading is completed
*/
et2_file.prototype._build_progressDropDownList = function () {
this.progress.addClass("progress_dropDown_fileList");
//Add uploading indicator and bind hover handler on it
jQuery(this.node).find('span').addClass('totalProgress_loader');
jQuery(this.node).find('span.et2_file_span').hover(function () {
jQuery('.progress_dropDown_fileList').show();
});
//Bind click handler to dismiss the dropdown while uploading
jQuery('body').on('click', function (event) {
if (event.target.className != 'remove') {
jQuery('.progress_dropDown_fileList').hide();
}
});
};
/**
* Creates the elements used for displaying the file, and it's upload status, and
* attaches them to the DOM
*
* @param _event Either the event, or an error message
*/
et2_file.prototype.createStatus = function (_event, file) {
var error = (typeof _event == "object" ? "" : _event);
if (this.options.max_file_size && file.size > this.options.max_file_size) {
error = this.egw().lang("File too large. Maximum %1", et2_vfsSize.prototype.human_size(this.options.max_file_size));
}
if (this.options.progress) {
var widget = this.getRoot().getWidgetById(this.options.progress);
if (widget) {
this.progress = jQuery(widget.getDOMNode());
this.progress.addClass("progress");
}
}
if (this.progress) {
var fileName = file.fileName || 'file';
var status = jQuery("<li data-file='" + fileName.replace(/'/g, '&quot') + "'>" + fileName
+ "<div class='remove'/><span class='progressBar'><p/></span></li>")
.appendTo(this.progress);
jQuery("div.remove", status).on('click', file, jQuery.proxy(this.cancel, this));
if (error != "") {
status.addClass("message ui-state-error");
status.append("<div>" + error + "</diff>");
jQuery(".progressBar", status).css("display", "none");
}
}
return error == "";
};
et2_file.prototype._fileProgress = function (file) {
if (this.progress) {
jQuery("li[data-file='" + file.fileName.replace(/'/g, '&quot') + "'] > span.progressBar > p").css("width", Math.ceil(file.progress() * 100) + "%");
}
return true;
};
et2_file.prototype.onError = function (event, name, error) {
console.warn(event, name, error);
};
/**
* A file upload is finished, update the UI
*/
et2_file.prototype.finishUpload = function (file, response) {
var name = file.fileName || 'file';
if (typeof response == 'string')
response = jQuery.parseJSON(response);
if (response.response[0] && typeof response.response[0].data.length == 'undefined') {
if (typeof this.options.value !== 'object' || !this.options.multiple) {
this.set_value({});
}
for (var key in response.response[0].data) {
if (typeof response.response[0].data[key] == "string") {
// Message from server - probably error
jQuery("[data-file='" + name.replace(/'/g, '&quot') + "']", this.progress)
.addClass("error")
.css("display", "block")
.text(response.response[0].data[key]);
}
else {
this.options.value[key] = response.response[0].data[key];
// If not multiple, we already destroyed the status, so re-create it
if (!this.options.multiple) {
this.createStatus({}, file);
}
if (this.progress) {
jQuery("[data-file='" + name.replace(/'/g, '&quot') + "']", this.progress).addClass("message success");
}
}
}
}
else if (this.progress) {
jQuery("[data-file='" + name.replace(/'/g, '&quot') + "']", this.progress)
.addClass("ui-state-error")
.css("display", "block")
.text(this.egw().lang("Server error"));
}
var event = jQuery.Event('upload');
event.data = this;
// Callback
if (typeof this.onFinishOne == 'function') {
this.onFinishOne(event, response, name);
}
else if (this.options.onFinishOne) {
et2_call(this.options.onFinishOne, event, response, name);
}
return true;
};
/**
* Remove a file from the list of values
*
* @param {File|string} File object, or file name, to remove
*/
et2_file.prototype.remove_file = function (file) {
//console.info(filename);
if (typeof file == 'string') {
file = { fileName: file };
}
for (var key in this.options.value) {
if (this.options.value[key].name == file.fileName) {
delete this.options.value[key];
jQuery('[data-file="' + file.fileName.replace(/'/g, '&quot') + '"]', this.node).remove();
return;
}
}
if (file.isComplete && !file.isComplete() && file.cancel)
file.cancel();
};
/**
* Cancel a file - event callback
*/
et2_file.prototype.cancel = function (e) {
e.preventDefault();
// Look for file name in list
var target = jQuery(e.target).parents("li");
this.remove_file(e.data);
// In case it didn't make it to the list (error)
target.remove();
jQuery(e.target).remove();
};
/**
* Set readonly
*
* @param {boolean} _ro boolean readonly state, true means readonly
*/
et2_file.prototype.set_readonly = function (_ro) {
if (typeof _ro != "undefined") {
this.options.readonly = _ro;
this.span.toggleClass('et2_file_ro', _ro);
if (this.options.readonly) {
this.span.unbind('click');
}
else {
var self = this;
this.span.off().bind('click', function () { self.input.click(); });
}
}
};
et2_file._attributes = {
"multiple": {
"name": "Multiple files",
"type": "boolean",
"default": false,
"description": "Allow the user to select more than one file to upload at a time. Subject to browser support."
},
"max_file_size": {
"name": "Maximum file size",
"type": "integer",
"default": 0,
"description": "Largest file accepted, in bytes. Subject to server limitations. 8MB = 8388608"
},
"mime": {
"name": "Allowed file types",
"type": "string",
"default": et2_no_init,
"description": "Mime type (eg: image/png) or regex (eg: /^text\//i) for allowed file types"
},
"blur": {
"name": "Placeholder",
"type": "string",
"default": "",
"description": "This text get displayed if an input-field is empty and does not have the input-focus (blur). It can be used to show a default value or a kind of help-text."
},
"progress": {
"name": "Progress node",
"type": "string",
"default": et2_no_init,
"description": "The ID of an alternate node (div) to display progress and results. The Node is fetched with et2 getWidgetById so you MUST use the id assigned in XET-File (it may not be available at creation time, so we (re)check on createStatus time)"
},
"onStart": {
"name": "Start event handler",
"type": "any",
"default": et2_no_init,
"description": "A (js) function called when an upload starts. Return true to continue with upload, false to cancel."
},
"onFinish": {
"name": "Finish event handler",
"type": "any",
"default": et2_no_init,
"description": "A (js) function called when all files to be uploaded are finished."
},
drop_target: {
"name": "Optional, additional drop target for HTML5 uploads",
"type": "string",
"default": et2_no_init,
"description": "The ID of an additional drop target for HTML5 drag-n-drop file uploads"
},
label: {
"name": "Label of file upload",
"type": "string",
"default": "Choose file...",
"description": "String caption to be displayed on file upload span"
},
progress_dropdownlist: {
"name": "List on files in progress like dropdown",
"type": "boolean",
"default": false,
"description": "Style list of files in uploading progress like dropdown list with a total upload progress indicator"
},
onFinishOne: {
"name": "Finish event handler for each one",
"type": "js",
"default": et2_no_init,
"description": "A (js) function called when a file to be uploaded is finished."
},
accept: {
"name": "Acceptable extensions",
"type": "string",
"default": '',
"description": "Define types of files that the server accepts. Multiple types can be seperated by comma and the default is to accept everything."
},
chunk_size: {
"name": "Chunk size",
"type": "integer",
"default": 1024 * 1024,
"description": "Max chunk size, gets set from server-side PHP (max_upload_size-1M)/2" // last chunk can be up to 2*chunk_size!
}
};
return et2_file;
}(et2_core_inputWidget_1.et2_inputWidget));
exports.et2_file = et2_file;
et2_core_widget_1.et2_register_widget(et2_file, ["file"]);
//# sourceMappingURL=et2_widget_file.js.map