mirror of
https://github.com/go-gitea/gitea.git
synced 2025-04-27 03:21:37 +00:00
608ccc32e5
We would never update or build fomantic again, we have forked it as a private library long time ago. So just put the JS and CSS files in "fomantic/build" into git. And use "import" to use them. Remove "form.js", rewrite "tab" component. All source code is from official Fomantic UI build. Will apply patches in separate PRs.
1178 lines
39 KiB
JavaScript
1178 lines
39 KiB
JavaScript
/*!
|
|
* # Fomantic-UI - API
|
|
* http://github.com/fomantic/Fomantic-UI/
|
|
*
|
|
*
|
|
* Released under the MIT license
|
|
* http://opensource.org/licenses/MIT
|
|
*
|
|
*/
|
|
|
|
;(function ($, window, document, undefined) {
|
|
|
|
'use strict';
|
|
|
|
$.isWindow = $.isWindow || function(obj) {
|
|
return obj != null && obj === obj.window;
|
|
};
|
|
|
|
window = (typeof window != 'undefined' && window.Math == Math)
|
|
? window
|
|
: (typeof self != 'undefined' && self.Math == Math)
|
|
? self
|
|
: Function('return this')()
|
|
;
|
|
|
|
$.api = $.fn.api = function(parameters) {
|
|
|
|
var
|
|
// use window context if none specified
|
|
$allModules = $.isFunction(this)
|
|
? $(window)
|
|
: $(this),
|
|
moduleSelector = $allModules.selector || '',
|
|
time = new Date().getTime(),
|
|
performance = [],
|
|
|
|
query = arguments[0],
|
|
methodInvoked = (typeof query == 'string'),
|
|
queryArguments = [].slice.call(arguments, 1),
|
|
|
|
returnedValue
|
|
;
|
|
|
|
$allModules
|
|
.each(function() {
|
|
var
|
|
settings = ( $.isPlainObject(parameters) )
|
|
? $.extend(true, {}, $.fn.api.settings, parameters)
|
|
: $.extend({}, $.fn.api.settings),
|
|
|
|
// internal aliases
|
|
namespace = settings.namespace,
|
|
metadata = settings.metadata,
|
|
selector = settings.selector,
|
|
error = settings.error,
|
|
className = settings.className,
|
|
|
|
// define namespaces for modules
|
|
eventNamespace = '.' + namespace,
|
|
moduleNamespace = 'module-' + namespace,
|
|
|
|
// element that creates request
|
|
$module = $(this),
|
|
$form = $module.closest(selector.form),
|
|
|
|
// context used for state
|
|
$context = (settings.stateContext)
|
|
? $(settings.stateContext)
|
|
: $module,
|
|
|
|
// request details
|
|
ajaxSettings,
|
|
requestSettings,
|
|
url,
|
|
data,
|
|
requestStartTime,
|
|
|
|
// standard module
|
|
element = this,
|
|
context = $context[0],
|
|
instance = $module.data(moduleNamespace),
|
|
module
|
|
;
|
|
|
|
module = {
|
|
|
|
initialize: function() {
|
|
if(!methodInvoked) {
|
|
module.bind.events();
|
|
}
|
|
module.instantiate();
|
|
},
|
|
|
|
instantiate: function() {
|
|
module.verbose('Storing instance of module', module);
|
|
instance = module;
|
|
$module
|
|
.data(moduleNamespace, instance)
|
|
;
|
|
},
|
|
|
|
destroy: function() {
|
|
module.verbose('Destroying previous module for', element);
|
|
$module
|
|
.removeData(moduleNamespace)
|
|
.off(eventNamespace)
|
|
;
|
|
},
|
|
|
|
bind: {
|
|
events: function() {
|
|
var
|
|
triggerEvent = module.get.event()
|
|
;
|
|
if( triggerEvent ) {
|
|
module.verbose('Attaching API events to element', triggerEvent);
|
|
$module
|
|
.on(triggerEvent + eventNamespace, module.event.trigger)
|
|
;
|
|
}
|
|
else if(settings.on == 'now') {
|
|
module.debug('Querying API endpoint immediately');
|
|
module.query();
|
|
}
|
|
}
|
|
},
|
|
|
|
decode: {
|
|
json: function(response) {
|
|
if(response !== undefined && typeof response == 'string') {
|
|
try {
|
|
response = JSON.parse(response);
|
|
}
|
|
catch(e) {
|
|
// isnt json string
|
|
}
|
|
}
|
|
return response;
|
|
}
|
|
},
|
|
|
|
read: {
|
|
cachedResponse: function(url) {
|
|
var
|
|
response
|
|
;
|
|
if(window.Storage === undefined) {
|
|
module.error(error.noStorage);
|
|
return;
|
|
}
|
|
response = sessionStorage.getItem(url);
|
|
module.debug('Using cached response', url, response);
|
|
response = module.decode.json(response);
|
|
return response;
|
|
}
|
|
},
|
|
write: {
|
|
cachedResponse: function(url, response) {
|
|
if(response && response === '') {
|
|
module.debug('Response empty, not caching', response);
|
|
return;
|
|
}
|
|
if(window.Storage === undefined) {
|
|
module.error(error.noStorage);
|
|
return;
|
|
}
|
|
if( $.isPlainObject(response) ) {
|
|
response = JSON.stringify(response);
|
|
}
|
|
sessionStorage.setItem(url, response);
|
|
module.verbose('Storing cached response for url', url, response);
|
|
}
|
|
},
|
|
|
|
query: function() {
|
|
|
|
if(module.is.disabled()) {
|
|
module.debug('Element is disabled API request aborted');
|
|
return;
|
|
}
|
|
|
|
if(module.is.loading()) {
|
|
if(settings.interruptRequests) {
|
|
module.debug('Interrupting previous request');
|
|
module.abort();
|
|
}
|
|
else {
|
|
module.debug('Cancelling request, previous request is still pending');
|
|
return;
|
|
}
|
|
}
|
|
|
|
// pass element metadata to url (value, text)
|
|
if(settings.defaultData) {
|
|
$.extend(true, settings.urlData, module.get.defaultData());
|
|
}
|
|
|
|
// Add form content
|
|
if(settings.serializeForm) {
|
|
settings.data = module.add.formData(settings.data);
|
|
}
|
|
|
|
// call beforesend and get any settings changes
|
|
requestSettings = module.get.settings();
|
|
|
|
// check if before send cancelled request
|
|
if(requestSettings === false) {
|
|
module.cancelled = true;
|
|
module.error(error.beforeSend);
|
|
return;
|
|
}
|
|
else {
|
|
module.cancelled = false;
|
|
}
|
|
|
|
// get url
|
|
url = module.get.templatedURL();
|
|
|
|
if(!url && !module.is.mocked()) {
|
|
module.error(error.missingURL);
|
|
return;
|
|
}
|
|
|
|
// replace variables
|
|
url = module.add.urlData( url );
|
|
// missing url parameters
|
|
if( !url && !module.is.mocked()) {
|
|
return;
|
|
}
|
|
|
|
requestSettings.url = settings.base + url;
|
|
|
|
// look for jQuery ajax parameters in settings
|
|
ajaxSettings = $.extend(true, {}, settings, {
|
|
type : settings.method || settings.type,
|
|
data : data,
|
|
url : settings.base + url,
|
|
beforeSend : settings.beforeXHR,
|
|
success : function() {},
|
|
failure : function() {},
|
|
complete : function() {}
|
|
});
|
|
|
|
module.debug('Querying URL', ajaxSettings.url);
|
|
module.verbose('Using AJAX settings', ajaxSettings);
|
|
if(settings.cache === 'local' && module.read.cachedResponse(url)) {
|
|
module.debug('Response returned from local cache');
|
|
module.request = module.create.request();
|
|
module.request.resolveWith(context, [ module.read.cachedResponse(url) ]);
|
|
return;
|
|
}
|
|
|
|
if( !settings.throttle ) {
|
|
module.debug('Sending request', data, ajaxSettings.method);
|
|
module.send.request();
|
|
}
|
|
else {
|
|
if(!settings.throttleFirstRequest && !module.timer) {
|
|
module.debug('Sending request', data, ajaxSettings.method);
|
|
module.send.request();
|
|
module.timer = setTimeout(function(){}, settings.throttle);
|
|
}
|
|
else {
|
|
module.debug('Throttling request', settings.throttle);
|
|
clearTimeout(module.timer);
|
|
module.timer = setTimeout(function() {
|
|
if(module.timer) {
|
|
delete module.timer;
|
|
}
|
|
module.debug('Sending throttled request', data, ajaxSettings.method);
|
|
module.send.request();
|
|
}, settings.throttle);
|
|
}
|
|
}
|
|
|
|
},
|
|
|
|
should: {
|
|
removeError: function() {
|
|
return ( settings.hideError === true || (settings.hideError === 'auto' && !module.is.form()) );
|
|
}
|
|
},
|
|
|
|
is: {
|
|
disabled: function() {
|
|
return ($module.filter(selector.disabled).length > 0);
|
|
},
|
|
expectingJSON: function() {
|
|
return settings.dataType === 'json' || settings.dataType === 'jsonp';
|
|
},
|
|
form: function() {
|
|
return $module.is('form') || $context.is('form');
|
|
},
|
|
mocked: function() {
|
|
return (settings.mockResponse || settings.mockResponseAsync || settings.response || settings.responseAsync);
|
|
},
|
|
input: function() {
|
|
return $module.is('input');
|
|
},
|
|
loading: function() {
|
|
return (module.request)
|
|
? (module.request.state() == 'pending')
|
|
: false
|
|
;
|
|
},
|
|
abortedRequest: function(xhr) {
|
|
if(xhr && xhr.readyState !== undefined && xhr.readyState === 0) {
|
|
module.verbose('XHR request determined to be aborted');
|
|
return true;
|
|
}
|
|
else {
|
|
module.verbose('XHR request was not aborted');
|
|
return false;
|
|
}
|
|
},
|
|
validResponse: function(response) {
|
|
if( (!module.is.expectingJSON()) || !$.isFunction(settings.successTest) ) {
|
|
module.verbose('Response is not JSON, skipping validation', settings.successTest, response);
|
|
return true;
|
|
}
|
|
module.debug('Checking JSON returned success', settings.successTest, response);
|
|
if( settings.successTest(response) ) {
|
|
module.debug('Response passed success test', response);
|
|
return true;
|
|
}
|
|
else {
|
|
module.debug('Response failed success test', response);
|
|
return false;
|
|
}
|
|
}
|
|
},
|
|
|
|
was: {
|
|
cancelled: function() {
|
|
return (module.cancelled || false);
|
|
},
|
|
succesful: function() {
|
|
module.verbose('This behavior will be deleted due to typo. Use "was successful" instead.');
|
|
return module.was.successful();
|
|
},
|
|
successful: function() {
|
|
return (module.request && module.request.state() == 'resolved');
|
|
},
|
|
failure: function() {
|
|
return (module.request && module.request.state() == 'rejected');
|
|
},
|
|
complete: function() {
|
|
return (module.request && (module.request.state() == 'resolved' || module.request.state() == 'rejected') );
|
|
}
|
|
},
|
|
|
|
add: {
|
|
urlData: function(url, urlData) {
|
|
var
|
|
requiredVariables,
|
|
optionalVariables
|
|
;
|
|
if(url) {
|
|
requiredVariables = url.match(settings.regExp.required);
|
|
optionalVariables = url.match(settings.regExp.optional);
|
|
urlData = urlData || settings.urlData;
|
|
if(requiredVariables) {
|
|
module.debug('Looking for required URL variables', requiredVariables);
|
|
$.each(requiredVariables, function(index, templatedString) {
|
|
var
|
|
// allow legacy {$var} style
|
|
variable = (templatedString.indexOf('$') !== -1)
|
|
? templatedString.substr(2, templatedString.length - 3)
|
|
: templatedString.substr(1, templatedString.length - 2),
|
|
value = ($.isPlainObject(urlData) && urlData[variable] !== undefined)
|
|
? urlData[variable]
|
|
: ($module.data(variable) !== undefined)
|
|
? $module.data(variable)
|
|
: ($context.data(variable) !== undefined)
|
|
? $context.data(variable)
|
|
: urlData[variable]
|
|
;
|
|
// remove value
|
|
if(value === undefined) {
|
|
module.error(error.requiredParameter, variable, url);
|
|
url = false;
|
|
return false;
|
|
}
|
|
else {
|
|
module.verbose('Found required variable', variable, value);
|
|
value = (settings.encodeParameters)
|
|
? module.get.urlEncodedValue(value)
|
|
: value
|
|
;
|
|
url = url.replace(templatedString, value);
|
|
}
|
|
});
|
|
}
|
|
if(optionalVariables) {
|
|
module.debug('Looking for optional URL variables', requiredVariables);
|
|
$.each(optionalVariables, function(index, templatedString) {
|
|
var
|
|
// allow legacy {/$var} style
|
|
variable = (templatedString.indexOf('$') !== -1)
|
|
? templatedString.substr(3, templatedString.length - 4)
|
|
: templatedString.substr(2, templatedString.length - 3),
|
|
value = ($.isPlainObject(urlData) && urlData[variable] !== undefined)
|
|
? urlData[variable]
|
|
: ($module.data(variable) !== undefined)
|
|
? $module.data(variable)
|
|
: ($context.data(variable) !== undefined)
|
|
? $context.data(variable)
|
|
: urlData[variable]
|
|
;
|
|
// optional replacement
|
|
if(value !== undefined) {
|
|
module.verbose('Optional variable Found', variable, value);
|
|
url = url.replace(templatedString, value);
|
|
}
|
|
else {
|
|
module.verbose('Optional variable not found', variable);
|
|
// remove preceding slash if set
|
|
if(url.indexOf('/' + templatedString) !== -1) {
|
|
url = url.replace('/' + templatedString, '');
|
|
}
|
|
else {
|
|
url = url.replace(templatedString, '');
|
|
}
|
|
}
|
|
});
|
|
}
|
|
}
|
|
return url;
|
|
},
|
|
formData: function(data) {
|
|
var
|
|
canSerialize = ($.fn.serializeObject !== undefined),
|
|
formData = (canSerialize)
|
|
? $form.serializeObject()
|
|
: $form.serialize(),
|
|
hasOtherData
|
|
;
|
|
data = data || settings.data;
|
|
hasOtherData = $.isPlainObject(data);
|
|
|
|
if(hasOtherData) {
|
|
if(canSerialize) {
|
|
module.debug('Extending existing data with form data', data, formData);
|
|
data = $.extend(true, {}, data, formData);
|
|
}
|
|
else {
|
|
module.error(error.missingSerialize);
|
|
module.debug('Cant extend data. Replacing data with form data', data, formData);
|
|
data = formData;
|
|
}
|
|
}
|
|
else {
|
|
module.debug('Adding form data', formData);
|
|
data = formData;
|
|
}
|
|
return data;
|
|
}
|
|
},
|
|
|
|
send: {
|
|
request: function() {
|
|
module.set.loading();
|
|
module.request = module.create.request();
|
|
if( module.is.mocked() ) {
|
|
module.mockedXHR = module.create.mockedXHR();
|
|
}
|
|
else {
|
|
module.xhr = module.create.xhr();
|
|
}
|
|
settings.onRequest.call(context, module.request, module.xhr);
|
|
}
|
|
},
|
|
|
|
event: {
|
|
trigger: function(event) {
|
|
module.query();
|
|
if(event.type == 'submit' || event.type == 'click') {
|
|
event.preventDefault();
|
|
}
|
|
},
|
|
xhr: {
|
|
always: function() {
|
|
// nothing special
|
|
},
|
|
done: function(response, textStatus, xhr) {
|
|
var
|
|
context = this,
|
|
elapsedTime = (new Date().getTime() - requestStartTime),
|
|
timeLeft = (settings.loadingDuration - elapsedTime),
|
|
translatedResponse = ( $.isFunction(settings.onResponse) )
|
|
? module.is.expectingJSON() && !settings.rawResponse
|
|
? settings.onResponse.call(context, $.extend(true, {}, response))
|
|
: settings.onResponse.call(context, response)
|
|
: false
|
|
;
|
|
timeLeft = (timeLeft > 0)
|
|
? timeLeft
|
|
: 0
|
|
;
|
|
if(translatedResponse) {
|
|
module.debug('Modified API response in onResponse callback', settings.onResponse, translatedResponse, response);
|
|
response = translatedResponse;
|
|
}
|
|
if(timeLeft > 0) {
|
|
module.debug('Response completed early delaying state change by', timeLeft);
|
|
}
|
|
setTimeout(function() {
|
|
if( module.is.validResponse(response) ) {
|
|
module.request.resolveWith(context, [response, xhr]);
|
|
}
|
|
else {
|
|
module.request.rejectWith(context, [xhr, 'invalid']);
|
|
}
|
|
}, timeLeft);
|
|
},
|
|
fail: function(xhr, status, httpMessage) {
|
|
var
|
|
context = this,
|
|
elapsedTime = (new Date().getTime() - requestStartTime),
|
|
timeLeft = (settings.loadingDuration - elapsedTime)
|
|
;
|
|
timeLeft = (timeLeft > 0)
|
|
? timeLeft
|
|
: 0
|
|
;
|
|
if(timeLeft > 0) {
|
|
module.debug('Response completed early delaying state change by', timeLeft);
|
|
}
|
|
setTimeout(function() {
|
|
if( module.is.abortedRequest(xhr) ) {
|
|
module.request.rejectWith(context, [xhr, 'aborted', httpMessage]);
|
|
}
|
|
else {
|
|
module.request.rejectWith(context, [xhr, 'error', status, httpMessage]);
|
|
}
|
|
}, timeLeft);
|
|
}
|
|
},
|
|
request: {
|
|
done: function(response, xhr) {
|
|
module.debug('Successful API Response', response);
|
|
if(settings.cache === 'local' && url) {
|
|
module.write.cachedResponse(url, response);
|
|
module.debug('Saving server response locally', module.cache);
|
|
}
|
|
settings.onSuccess.call(context, response, $module, xhr);
|
|
},
|
|
complete: function(firstParameter, secondParameter) {
|
|
var
|
|
xhr,
|
|
response
|
|
;
|
|
// have to guess callback parameters based on request success
|
|
if( module.was.successful() ) {
|
|
response = firstParameter;
|
|
xhr = secondParameter;
|
|
}
|
|
else {
|
|
xhr = firstParameter;
|
|
response = module.get.responseFromXHR(xhr);
|
|
}
|
|
module.remove.loading();
|
|
settings.onComplete.call(context, response, $module, xhr);
|
|
},
|
|
fail: function(xhr, status, httpMessage) {
|
|
var
|
|
// pull response from xhr if available
|
|
response = module.get.responseFromXHR(xhr),
|
|
errorMessage = module.get.errorFromRequest(response, status, httpMessage)
|
|
;
|
|
if(status == 'aborted') {
|
|
module.debug('XHR Aborted (Most likely caused by page navigation or CORS Policy)', status, httpMessage);
|
|
settings.onAbort.call(context, status, $module, xhr);
|
|
return true;
|
|
}
|
|
else if(status == 'invalid') {
|
|
module.debug('JSON did not pass success test. A server-side error has most likely occurred', response);
|
|
}
|
|
else if(status == 'error') {
|
|
if(xhr !== undefined) {
|
|
module.debug('XHR produced a server error', status, httpMessage);
|
|
// make sure we have an error to display to console
|
|
if( (xhr.status < 200 || xhr.status >= 300) && httpMessage !== undefined && httpMessage !== '') {
|
|
module.error(error.statusMessage + httpMessage, ajaxSettings.url);
|
|
}
|
|
settings.onError.call(context, errorMessage, $module, xhr);
|
|
}
|
|
}
|
|
|
|
if(settings.errorDuration && status !== 'aborted') {
|
|
module.debug('Adding error state');
|
|
module.set.error();
|
|
if( module.should.removeError() ) {
|
|
setTimeout(module.remove.error, settings.errorDuration);
|
|
}
|
|
}
|
|
module.debug('API Request failed', errorMessage, xhr);
|
|
settings.onFailure.call(context, response, $module, xhr);
|
|
}
|
|
}
|
|
},
|
|
|
|
create: {
|
|
|
|
request: function() {
|
|
// api request promise
|
|
return $.Deferred()
|
|
.always(module.event.request.complete)
|
|
.done(module.event.request.done)
|
|
.fail(module.event.request.fail)
|
|
;
|
|
},
|
|
|
|
mockedXHR: function () {
|
|
var
|
|
// xhr does not simulate these properties of xhr but must return them
|
|
textStatus = false,
|
|
status = false,
|
|
httpMessage = false,
|
|
responder = settings.mockResponse || settings.response,
|
|
asyncResponder = settings.mockResponseAsync || settings.responseAsync,
|
|
asyncCallback,
|
|
response,
|
|
mockedXHR
|
|
;
|
|
|
|
mockedXHR = $.Deferred()
|
|
.always(module.event.xhr.complete)
|
|
.done(module.event.xhr.done)
|
|
.fail(module.event.xhr.fail)
|
|
;
|
|
|
|
if(responder) {
|
|
if( $.isFunction(responder) ) {
|
|
module.debug('Using specified synchronous callback', responder);
|
|
response = responder.call(context, requestSettings);
|
|
}
|
|
else {
|
|
module.debug('Using settings specified response', responder);
|
|
response = responder;
|
|
}
|
|
// simulating response
|
|
mockedXHR.resolveWith(context, [ response, textStatus, { responseText: response }]);
|
|
}
|
|
else if( $.isFunction(asyncResponder) ) {
|
|
asyncCallback = function(response) {
|
|
module.debug('Async callback returned response', response);
|
|
|
|
if(response) {
|
|
mockedXHR.resolveWith(context, [ response, textStatus, { responseText: response }]);
|
|
}
|
|
else {
|
|
mockedXHR.rejectWith(context, [{ responseText: response }, status, httpMessage]);
|
|
}
|
|
};
|
|
module.debug('Using specified async response callback', asyncResponder);
|
|
asyncResponder.call(context, requestSettings, asyncCallback);
|
|
}
|
|
return mockedXHR;
|
|
},
|
|
|
|
xhr: function() {
|
|
var
|
|
xhr
|
|
;
|
|
// ajax request promise
|
|
xhr = $.ajax(ajaxSettings)
|
|
.always(module.event.xhr.always)
|
|
.done(module.event.xhr.done)
|
|
.fail(module.event.xhr.fail)
|
|
;
|
|
module.verbose('Created server request', xhr, ajaxSettings);
|
|
return xhr;
|
|
}
|
|
},
|
|
|
|
set: {
|
|
error: function() {
|
|
module.verbose('Adding error state to element', $context);
|
|
$context.addClass(className.error);
|
|
},
|
|
loading: function() {
|
|
module.verbose('Adding loading state to element', $context);
|
|
$context.addClass(className.loading);
|
|
requestStartTime = new Date().getTime();
|
|
}
|
|
},
|
|
|
|
remove: {
|
|
error: function() {
|
|
module.verbose('Removing error state from element', $context);
|
|
$context.removeClass(className.error);
|
|
},
|
|
loading: function() {
|
|
module.verbose('Removing loading state from element', $context);
|
|
$context.removeClass(className.loading);
|
|
}
|
|
},
|
|
|
|
get: {
|
|
responseFromXHR: function(xhr) {
|
|
return $.isPlainObject(xhr)
|
|
? (module.is.expectingJSON())
|
|
? module.decode.json(xhr.responseText)
|
|
: xhr.responseText
|
|
: false
|
|
;
|
|
},
|
|
errorFromRequest: function(response, status, httpMessage) {
|
|
return ($.isPlainObject(response) && response.error !== undefined)
|
|
? response.error // use json error message
|
|
: (settings.error[status] !== undefined) // use server error message
|
|
? settings.error[status]
|
|
: httpMessage
|
|
;
|
|
},
|
|
request: function() {
|
|
return module.request || false;
|
|
},
|
|
xhr: function() {
|
|
return module.xhr || false;
|
|
},
|
|
settings: function() {
|
|
var
|
|
runSettings
|
|
;
|
|
runSettings = settings.beforeSend.call($module, settings);
|
|
if(runSettings) {
|
|
if(runSettings.success !== undefined) {
|
|
module.debug('Legacy success callback detected', runSettings);
|
|
module.error(error.legacyParameters, runSettings.success);
|
|
runSettings.onSuccess = runSettings.success;
|
|
}
|
|
if(runSettings.failure !== undefined) {
|
|
module.debug('Legacy failure callback detected', runSettings);
|
|
module.error(error.legacyParameters, runSettings.failure);
|
|
runSettings.onFailure = runSettings.failure;
|
|
}
|
|
if(runSettings.complete !== undefined) {
|
|
module.debug('Legacy complete callback detected', runSettings);
|
|
module.error(error.legacyParameters, runSettings.complete);
|
|
runSettings.onComplete = runSettings.complete;
|
|
}
|
|
}
|
|
if(runSettings === undefined) {
|
|
module.error(error.noReturnedValue);
|
|
}
|
|
if(runSettings === false) {
|
|
return runSettings;
|
|
}
|
|
return (runSettings !== undefined)
|
|
? $.extend(true, {}, runSettings)
|
|
: $.extend(true, {}, settings)
|
|
;
|
|
},
|
|
urlEncodedValue: function(value) {
|
|
var
|
|
decodedValue = window.decodeURIComponent(value),
|
|
encodedValue = window.encodeURIComponent(value),
|
|
alreadyEncoded = (decodedValue !== value)
|
|
;
|
|
if(alreadyEncoded) {
|
|
module.debug('URL value is already encoded, avoiding double encoding', value);
|
|
return value;
|
|
}
|
|
module.verbose('Encoding value using encodeURIComponent', value, encodedValue);
|
|
return encodedValue;
|
|
},
|
|
defaultData: function() {
|
|
var
|
|
data = {}
|
|
;
|
|
if( !$.isWindow(element) ) {
|
|
if( module.is.input() ) {
|
|
data.value = $module.val();
|
|
}
|
|
else if( module.is.form() ) {
|
|
|
|
}
|
|
else {
|
|
data.text = $module.text();
|
|
}
|
|
}
|
|
return data;
|
|
},
|
|
event: function() {
|
|
if( $.isWindow(element) || settings.on == 'now' ) {
|
|
module.debug('API called without element, no events attached');
|
|
return false;
|
|
}
|
|
else if(settings.on == 'auto') {
|
|
if( $module.is('input') ) {
|
|
return (element.oninput !== undefined)
|
|
? 'input'
|
|
: (element.onpropertychange !== undefined)
|
|
? 'propertychange'
|
|
: 'keyup'
|
|
;
|
|
}
|
|
else if( $module.is('form') ) {
|
|
return 'submit';
|
|
}
|
|
else {
|
|
return 'click';
|
|
}
|
|
}
|
|
else {
|
|
return settings.on;
|
|
}
|
|
},
|
|
templatedURL: function(action) {
|
|
action = action || $module.data(metadata.action) || settings.action || false;
|
|
url = $module.data(metadata.url) || settings.url || false;
|
|
if(url) {
|
|
module.debug('Using specified url', url);
|
|
return url;
|
|
}
|
|
if(action) {
|
|
module.debug('Looking up url for action', action, settings.api);
|
|
if(settings.api[action] === undefined && !module.is.mocked()) {
|
|
module.error(error.missingAction, settings.action, settings.api);
|
|
return;
|
|
}
|
|
url = settings.api[action];
|
|
}
|
|
else if( module.is.form() ) {
|
|
url = $module.attr('action') || $context.attr('action') || false;
|
|
module.debug('No url or action specified, defaulting to form action', url);
|
|
}
|
|
return url;
|
|
}
|
|
},
|
|
|
|
abort: function() {
|
|
var
|
|
xhr = module.get.xhr()
|
|
;
|
|
if( xhr && xhr.state() !== 'resolved') {
|
|
module.debug('Cancelling API request');
|
|
xhr.abort();
|
|
}
|
|
},
|
|
|
|
// reset state
|
|
reset: function() {
|
|
module.remove.error();
|
|
module.remove.loading();
|
|
},
|
|
|
|
setting: function(name, value) {
|
|
module.debug('Changing setting', name, value);
|
|
if( $.isPlainObject(name) ) {
|
|
$.extend(true, settings, name);
|
|
}
|
|
else if(value !== undefined) {
|
|
if($.isPlainObject(settings[name])) {
|
|
$.extend(true, settings[name], value);
|
|
}
|
|
else {
|
|
settings[name] = value;
|
|
}
|
|
}
|
|
else {
|
|
return settings[name];
|
|
}
|
|
},
|
|
internal: function(name, value) {
|
|
if( $.isPlainObject(name) ) {
|
|
$.extend(true, module, name);
|
|
}
|
|
else if(value !== undefined) {
|
|
module[name] = value;
|
|
}
|
|
else {
|
|
return module[name];
|
|
}
|
|
},
|
|
debug: function() {
|
|
if(!settings.silent && settings.debug) {
|
|
if(settings.performance) {
|
|
module.performance.log(arguments);
|
|
}
|
|
else {
|
|
module.debug = Function.prototype.bind.call(console.info, console, settings.name + ':');
|
|
module.debug.apply(console, arguments);
|
|
}
|
|
}
|
|
},
|
|
verbose: function() {
|
|
if(!settings.silent && settings.verbose && settings.debug) {
|
|
if(settings.performance) {
|
|
module.performance.log(arguments);
|
|
}
|
|
else {
|
|
module.verbose = Function.prototype.bind.call(console.info, console, settings.name + ':');
|
|
module.verbose.apply(console, arguments);
|
|
}
|
|
}
|
|
},
|
|
error: function() {
|
|
if(!settings.silent) {
|
|
module.error = Function.prototype.bind.call(console.error, console, settings.name + ':');
|
|
module.error.apply(console, arguments);
|
|
}
|
|
},
|
|
performance: {
|
|
log: function(message) {
|
|
var
|
|
currentTime,
|
|
executionTime,
|
|
previousTime
|
|
;
|
|
if(settings.performance) {
|
|
currentTime = new Date().getTime();
|
|
previousTime = time || currentTime;
|
|
executionTime = currentTime - previousTime;
|
|
time = currentTime;
|
|
performance.push({
|
|
'Name' : message[0],
|
|
'Arguments' : [].slice.call(message, 1) || '',
|
|
//'Element' : element,
|
|
'Execution Time' : executionTime
|
|
});
|
|
}
|
|
clearTimeout(module.performance.timer);
|
|
module.performance.timer = setTimeout(module.performance.display, 500);
|
|
},
|
|
display: function() {
|
|
var
|
|
title = settings.name + ':',
|
|
totalTime = 0
|
|
;
|
|
time = false;
|
|
clearTimeout(module.performance.timer);
|
|
$.each(performance, function(index, data) {
|
|
totalTime += data['Execution Time'];
|
|
});
|
|
title += ' ' + totalTime + 'ms';
|
|
if(moduleSelector) {
|
|
title += ' \'' + moduleSelector + '\'';
|
|
}
|
|
if( (console.group !== undefined || console.table !== undefined) && performance.length > 0) {
|
|
console.groupCollapsed(title);
|
|
if(console.table) {
|
|
console.table(performance);
|
|
}
|
|
else {
|
|
$.each(performance, function(index, data) {
|
|
console.log(data['Name'] + ': ' + data['Execution Time']+'ms');
|
|
});
|
|
}
|
|
console.groupEnd();
|
|
}
|
|
performance = [];
|
|
}
|
|
},
|
|
invoke: function(query, passedArguments, context) {
|
|
var
|
|
object = instance,
|
|
maxDepth,
|
|
found,
|
|
response
|
|
;
|
|
passedArguments = passedArguments || queryArguments;
|
|
context = element || context;
|
|
if(typeof query == 'string' && object !== undefined) {
|
|
query = query.split(/[\. ]/);
|
|
maxDepth = query.length - 1;
|
|
$.each(query, function(depth, value) {
|
|
var camelCaseValue = (depth != maxDepth)
|
|
? value + query[depth + 1].charAt(0).toUpperCase() + query[depth + 1].slice(1)
|
|
: query
|
|
;
|
|
if( $.isPlainObject( object[camelCaseValue] ) && (depth != maxDepth) ) {
|
|
object = object[camelCaseValue];
|
|
}
|
|
else if( object[camelCaseValue] !== undefined ) {
|
|
found = object[camelCaseValue];
|
|
return false;
|
|
}
|
|
else if( $.isPlainObject( object[value] ) && (depth != maxDepth) ) {
|
|
object = object[value];
|
|
}
|
|
else if( object[value] !== undefined ) {
|
|
found = object[value];
|
|
return false;
|
|
}
|
|
else {
|
|
module.error(error.method, query);
|
|
return false;
|
|
}
|
|
});
|
|
}
|
|
if ( $.isFunction( found ) ) {
|
|
response = found.apply(context, passedArguments);
|
|
}
|
|
else if(found !== undefined) {
|
|
response = found;
|
|
}
|
|
if(Array.isArray(returnedValue)) {
|
|
returnedValue.push(response);
|
|
}
|
|
else if(returnedValue !== undefined) {
|
|
returnedValue = [returnedValue, response];
|
|
}
|
|
else if(response !== undefined) {
|
|
returnedValue = response;
|
|
}
|
|
return found;
|
|
}
|
|
};
|
|
|
|
if(methodInvoked) {
|
|
if(instance === undefined) {
|
|
module.initialize();
|
|
}
|
|
module.invoke(query);
|
|
}
|
|
else {
|
|
if(instance !== undefined) {
|
|
instance.invoke('destroy');
|
|
}
|
|
module.initialize();
|
|
}
|
|
})
|
|
;
|
|
|
|
return (returnedValue !== undefined)
|
|
? returnedValue
|
|
: this
|
|
;
|
|
};
|
|
|
|
$.api.settings = {
|
|
|
|
name : 'API',
|
|
namespace : 'api',
|
|
|
|
debug : false,
|
|
verbose : false,
|
|
performance : true,
|
|
|
|
// object containing all templates endpoints
|
|
api : {},
|
|
|
|
// whether to cache responses
|
|
cache : true,
|
|
|
|
// whether new requests should abort previous requests
|
|
interruptRequests : true,
|
|
|
|
// event binding
|
|
on : 'auto',
|
|
|
|
// context for applying state classes
|
|
stateContext : false,
|
|
|
|
// duration for loading state
|
|
loadingDuration : 0,
|
|
|
|
// whether to hide errors after a period of time
|
|
hideError : 'auto',
|
|
|
|
// duration for error state
|
|
errorDuration : 2000,
|
|
|
|
// whether parameters should be encoded with encodeURIComponent
|
|
encodeParameters : true,
|
|
|
|
// API action to use
|
|
action : false,
|
|
|
|
// templated URL to use
|
|
url : false,
|
|
|
|
// base URL to apply to all endpoints
|
|
base : '',
|
|
|
|
// data that will
|
|
urlData : {},
|
|
|
|
// whether to add default data to url data
|
|
defaultData : true,
|
|
|
|
// whether to serialize closest form
|
|
serializeForm : false,
|
|
|
|
// how long to wait before request should occur
|
|
throttle : 0,
|
|
|
|
// whether to throttle first request or only repeated
|
|
throttleFirstRequest : true,
|
|
|
|
// standard ajax settings
|
|
method : 'get',
|
|
data : {},
|
|
dataType : 'json',
|
|
|
|
// mock response
|
|
mockResponse : false,
|
|
mockResponseAsync : false,
|
|
|
|
// aliases for mock
|
|
response : false,
|
|
responseAsync : false,
|
|
|
|
// whether onResponse should work with response value without force converting into an object
|
|
rawResponse : false,
|
|
|
|
// callbacks before request
|
|
beforeSend : function(settings) { return settings; },
|
|
beforeXHR : function(xhr) {},
|
|
onRequest : function(promise, xhr) {},
|
|
|
|
// after request
|
|
onResponse : false, // function(response) { },
|
|
|
|
// response was successful, if JSON passed validation
|
|
onSuccess : function(response, $module) {},
|
|
|
|
// request finished without aborting
|
|
onComplete : function(response, $module) {},
|
|
|
|
// failed JSON success test
|
|
onFailure : function(response, $module) {},
|
|
|
|
// server error
|
|
onError : function(errorMessage, $module) {},
|
|
|
|
// request aborted
|
|
onAbort : function(errorMessage, $module) {},
|
|
|
|
successTest : false,
|
|
|
|
// errors
|
|
error : {
|
|
beforeSend : 'The before send function has aborted the request',
|
|
error : 'There was an error with your request',
|
|
exitConditions : 'API Request Aborted. Exit conditions met',
|
|
JSONParse : 'JSON could not be parsed during error handling',
|
|
legacyParameters : 'You are using legacy API success callback names',
|
|
method : 'The method you called is not defined',
|
|
missingAction : 'API action used but no url was defined',
|
|
missingSerialize : 'jquery-serialize-object is required to add form data to an existing data object',
|
|
missingURL : 'No URL specified for api event',
|
|
noReturnedValue : 'The beforeSend callback must return a settings object, beforeSend ignored.',
|
|
noStorage : 'Caching responses locally requires session storage',
|
|
parseError : 'There was an error parsing your request',
|
|
requiredParameter : 'Missing a required URL parameter: ',
|
|
statusMessage : 'Server gave an error: ',
|
|
timeout : 'Your request timed out'
|
|
},
|
|
|
|
regExp : {
|
|
required : /\{\$*[A-z0-9]+\}/g,
|
|
optional : /\{\/\$*[A-z0-9]+\}/g,
|
|
},
|
|
|
|
className: {
|
|
loading : 'loading',
|
|
error : 'error'
|
|
},
|
|
|
|
selector: {
|
|
disabled : '.disabled',
|
|
form : 'form'
|
|
},
|
|
|
|
metadata: {
|
|
action : 'action',
|
|
url : 'url'
|
|
}
|
|
};
|
|
|
|
|
|
|
|
})( jQuery, window, document );
|