root / drupal7 / misc / ajax.js @ 6b24a280
1 | 85ad3d82 | Assos Assos | (function ($) { |
---|---|---|---|
2 | |||
3 | /**
|
||
4 | * Provides Ajax page updating via jQuery $.ajax (Asynchronous JavaScript and XML).
|
||
5 | *
|
||
6 | * Ajax is a method of making a request via JavaScript while viewing an HTML
|
||
7 | * page. The request returns an array of commands encoded in JSON, which is
|
||
8 | * then executed to make any changes that are necessary to the page.
|
||
9 | *
|
||
10 | * Drupal uses this file to enhance form elements with #ajax['path'] and
|
||
11 | * #ajax['wrapper'] properties. If set, this file will automatically be included
|
||
12 | * to provide Ajax capabilities.
|
||
13 | */
|
||
14 | |||
15 | Drupal.ajax = Drupal.ajax || {}; |
||
16 | |||
17 | 08f5d39b | Assos Assos | Drupal.settings.urlIsAjaxTrusted = Drupal.settings.urlIsAjaxTrusted || {}; |
18 | |||
19 | 85ad3d82 | Assos Assos | /**
|
20 | * Attaches the Ajax behavior to each Ajax form element.
|
||
21 | */
|
||
22 | Drupal.behaviors.AJAX = { |
||
23 | attach: function (context, settings) { |
||
24 | // Load all Ajax behaviors specified in the settings.
|
||
25 | for (var base in settings.ajax) { |
||
26 | if (!$('#' + base + '.ajax-processed').length) { |
||
27 | var element_settings = settings.ajax[base];
|
||
28 | |||
29 | if (typeof element_settings.selector == 'undefined') { |
||
30 | element_settings.selector = '#' + base;
|
||
31 | } |
||
32 | $(element_settings.selector).each(function () { |
||
33 | element_settings.element = this;
|
||
34 | Drupal.ajax[base] = new Drupal.ajax(base, this, element_settings); |
||
35 | }); |
||
36 | |||
37 | $('#' + base).addClass('ajax-processed'); |
||
38 | } |
||
39 | } |
||
40 | |||
41 | // Bind Ajax behaviors to all items showing the class.
|
||
42 | $('.use-ajax:not(.ajax-processed)').addClass('ajax-processed').each(function () { |
||
43 | var element_settings = {};
|
||
44 | // Clicked links look better with the throbber than the progress bar.
|
||
45 | element_settings.progress = { 'type': 'throbber' }; |
||
46 | |||
47 | // For anchor tags, these will go to the target of the anchor rather
|
||
48 | // than the usual location.
|
||
49 | if ($(this).attr('href')) { |
||
50 | element_settings.url = $(this).attr('href'); |
||
51 | element_settings.event = 'click';
|
||
52 | } |
||
53 | var base = $(this).attr('id'); |
||
54 | Drupal.ajax[base] = new Drupal.ajax(base, this, element_settings); |
||
55 | }); |
||
56 | |||
57 | // This class means to submit the form to the action using Ajax.
|
||
58 | $('.use-ajax-submit:not(.ajax-processed)').addClass('ajax-processed').each(function () { |
||
59 | var element_settings = {};
|
||
60 | |||
61 | // Ajax submits specified in this manner automatically submit to the
|
||
62 | // normal form action.
|
||
63 | element_settings.url = $(this.form).attr('action'); |
||
64 | // Form submit button clicks need to tell the form what was clicked so
|
||
65 | // it gets passed in the POST request.
|
||
66 | element_settings.setClick = true;
|
||
67 | // Form buttons use the 'click' event rather than mousedown.
|
||
68 | element_settings.event = 'click';
|
||
69 | // Clicked form buttons look better with the throbber than the progress bar.
|
||
70 | element_settings.progress = { 'type': 'throbber' }; |
||
71 | |||
72 | var base = $(this).attr('id'); |
||
73 | Drupal.ajax[base] = new Drupal.ajax(base, this, element_settings); |
||
74 | }); |
||
75 | } |
||
76 | }; |
||
77 | |||
78 | /**
|
||
79 | * Ajax object.
|
||
80 | *
|
||
81 | * All Ajax objects on a page are accessible through the global Drupal.ajax
|
||
82 | * object and are keyed by the submit button's ID. You can access them from
|
||
83 | * your module's JavaScript file to override properties or functions.
|
||
84 | *
|
||
85 | * For example, if your Ajax enabled button has the ID 'edit-submit', you can
|
||
86 | * redefine the function that is called to insert the new content like this
|
||
87 | * (inside a Drupal.behaviors attach block):
|
||
88 | * @code
|
||
89 | * Drupal.behaviors.myCustomAJAXStuff = {
|
||
90 | * attach: function (context, settings) {
|
||
91 | * Drupal.ajax['edit-submit'].commands.insert = function (ajax, response, status) {
|
||
92 | * new_content = $(response.data);
|
||
93 | * $('#my-wrapper').append(new_content);
|
||
94 | * alert('New content was appended to #my-wrapper');
|
||
95 | * }
|
||
96 | * }
|
||
97 | * };
|
||
98 | * @endcode
|
||
99 | */
|
||
100 | Drupal.ajax = function (base, element, element_settings) { |
||
101 | var defaults = {
|
||
102 | url: 'system/ajax', |
||
103 | event: 'mousedown', |
||
104 | keypress: true, |
||
105 | selector: '#' + base, |
||
106 | effect: 'none', |
||
107 | speed: 'none', |
||
108 | method: 'replaceWith', |
||
109 | progress: {
|
||
110 | type: 'throbber', |
||
111 | message: Drupal.t('Please wait...') |
||
112 | }, |
||
113 | submit: {
|
||
114 | 'js': true |
||
115 | } |
||
116 | }; |
||
117 | |||
118 | $.extend(this, defaults, element_settings); |
||
119 | |||
120 | this.element = element;
|
||
121 | this.element_settings = element_settings;
|
||
122 | |||
123 | // Replacing 'nojs' with 'ajax' in the URL allows for an easy method to let
|
||
124 | // the server detect when it needs to degrade gracefully.
|
||
125 | // There are five scenarios to check for:
|
||
126 | // 1. /nojs/
|
||
127 | // 2. /nojs$ - The end of a URL string.
|
||
128 | // 3. /nojs? - Followed by a query (with clean URLs enabled).
|
||
129 | // E.g.: path/nojs?destination=foobar
|
||
130 | // 4. /nojs& - Followed by a query (without clean URLs enabled).
|
||
131 | // E.g.: ?q=path/nojs&destination=foobar
|
||
132 | // 5. /nojs# - Followed by a fragment.
|
||
133 | // E.g.: path/nojs#myfragment
|
||
134 | this.url = element_settings.url.replace(/\/nojs(\/|$|\?|&|#)/g, '/ajax$1'); |
||
135 | 08f5d39b | Assos Assos | // If the 'nojs' version of the URL is trusted, also trust the 'ajax' version.
|
136 | if (Drupal.settings.urlIsAjaxTrusted[element_settings.url]) {
|
||
137 | Drupal.settings.urlIsAjaxTrusted[this.url] = true; |
||
138 | } |
||
139 | |||
140 | 85ad3d82 | Assos Assos | this.wrapper = '#' + element_settings.wrapper; |
141 | |||
142 | // If there isn't a form, jQuery.ajax() will be used instead, allowing us to
|
||
143 | // bind Ajax to links as well.
|
||
144 | if (this.element.form) { |
||
145 | this.form = $(this.element.form); |
||
146 | } |
||
147 | |||
148 | // Set the options for the ajaxSubmit function.
|
||
149 | // The 'this' variable will not persist inside of the options object.
|
||
150 | var ajax = this; |
||
151 | ajax.options = { |
||
152 | url: ajax.url,
|
||
153 | data: ajax.submit,
|
||
154 | beforeSerialize: function (element_settings, options) { |
||
155 | return ajax.beforeSerialize(element_settings, options);
|
||
156 | }, |
||
157 | beforeSubmit: function (form_values, element_settings, options) { |
||
158 | ajax.ajaxing = true;
|
||
159 | return ajax.beforeSubmit(form_values, element_settings, options);
|
||
160 | }, |
||
161 | beforeSend: function (xmlhttprequest, options) { |
||
162 | ajax.ajaxing = true;
|
||
163 | return ajax.beforeSend(xmlhttprequest, options);
|
||
164 | }, |
||
165 | 08f5d39b | Assos Assos | success: function (response, status, xmlhttprequest) { |
166 | 85ad3d82 | Assos Assos | // Sanity check for browser support (object expected).
|
167 | // When using iFrame uploads, responses must be returned as a string.
|
||
168 | if (typeof response == 'string') { |
||
169 | response = $.parseJSON(response);
|
||
170 | } |
||
171 | 08f5d39b | Assos Assos | |
172 | // Prior to invoking the response's commands, verify that they can be
|
||
173 | // trusted by checking for a response header. See
|
||
174 | // ajax_set_verification_header() for details.
|
||
175 | // - Empty responses are harmless so can bypass verification. This avoids
|
||
176 | // an alert message for server-generated no-op responses that skip Ajax
|
||
177 | // rendering.
|
||
178 | // - Ajax objects with trusted URLs (e.g., ones defined server-side via
|
||
179 | // #ajax) can bypass header verification. This is especially useful for
|
||
180 | // Ajax with multipart forms. Because IFRAME transport is used, the
|
||
181 | // response headers cannot be accessed for verification.
|
||
182 | if (response !== null && !Drupal.settings.urlIsAjaxTrusted[ajax.url]) { |
||
183 | if (xmlhttprequest.getResponseHeader('X-Drupal-Ajax-Token') !== '1') { |
||
184 | var customMessage = Drupal.t("The response failed verification so will not be processed."); |
||
185 | return ajax.error(xmlhttprequest, ajax.url, customMessage);
|
||
186 | } |
||
187 | } |
||
188 | |||
189 | 85ad3d82 | Assos Assos | return ajax.success(response, status);
|
190 | }, |
||
191 | 08f5d39b | Assos Assos | complete: function (xmlhttprequest, status) { |
192 | 85ad3d82 | Assos Assos | ajax.ajaxing = false;
|
193 | if (status == 'error' || status == 'parsererror') { |
||
194 | 08f5d39b | Assos Assos | return ajax.error(xmlhttprequest, ajax.url);
|
195 | 85ad3d82 | Assos Assos | } |
196 | }, |
||
197 | dataType: 'json', |
||
198 | type: 'POST' |
||
199 | }; |
||
200 | |||
201 | 6b24a280 | Assos Assos | // For multipart forms (e.g., file uploads), jQuery Form targets the form
|
202 | // submission to an iframe instead of using an XHR object. The initial "src"
|
||
203 | // of the iframe, prior to the form submission, is set to options.iframeSrc.
|
||
204 | // "about:blank" is the semantically correct, standards-compliant, way to
|
||
205 | // initialize a blank iframe; however, some old IE versions (possibly only 6)
|
||
206 | // incorrectly report a mixed content warning when iframes with an
|
||
207 | // "about:blank" src are added to a parent document with an https:// origin.
|
||
208 | // jQuery Form works around this by defaulting to "javascript:false" instead,
|
||
209 | // but that breaks on Chrome 83, so here we force the semantically correct
|
||
210 | // behavior for all browsers except old IE.
|
||
211 | // @see https://www.drupal.org/project/drupal/issues/3143016
|
||
212 | // @see https://github.com/jquery-form/form/blob/df9cb101b9c9c085c8d75ad980c7ff1cf62063a1/jquery.form.js#L68
|
||
213 | // @see https://bugs.chromium.org/p/chromium/issues/detail?id=1084874
|
||
214 | // @see https://html.spec.whatwg.org/multipage/browsers.html#creating-browsing-contexts
|
||
215 | // @see https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy
|
||
216 | if (navigator.userAgent.indexOf("MSIE") === -1) { |
||
217 | ajax.options.iframeSrc = 'about:blank';
|
||
218 | } |
||
219 | |||
220 | 85ad3d82 | Assos Assos | // Bind the ajaxSubmit function to the element event.
|
221 | $(ajax.element).bind(element_settings.event, function (event) { |
||
222 | 08f5d39b | Assos Assos | if (!Drupal.settings.urlIsAjaxTrusted[ajax.url] && !Drupal.urlIsLocal(ajax.url)) {
|
223 | throw new Error(Drupal.t('The callback URL is not local and not trusted: !url', {'!url': ajax.url})); |
||
224 | } |
||
225 | 85ad3d82 | Assos Assos | return ajax.eventResponse(this, event); |
226 | }); |
||
227 | |||
228 | // If necessary, enable keyboard submission so that Ajax behaviors
|
||
229 | // can be triggered through keyboard input as well as e.g. a mousedown
|
||
230 | // action.
|
||
231 | if (element_settings.keypress) {
|
||
232 | $(ajax.element).keypress(function (event) { |
||
233 | return ajax.keypressResponse(this, event); |
||
234 | }); |
||
235 | } |
||
236 | |||
237 | // If necessary, prevent the browser default action of an additional event.
|
||
238 | // For example, prevent the browser default action of a click, even if the
|
||
239 | // AJAX behavior binds to mousedown.
|
||
240 | if (element_settings.prevent) {
|
||
241 | $(ajax.element).bind(element_settings.prevent, false); |
||
242 | } |
||
243 | }; |
||
244 | |||
245 | /**
|
||
246 | * Handle a key press.
|
||
247 | *
|
||
248 | * The Ajax object will, if instructed, bind to a key press response. This
|
||
249 | * will test to see if the key press is valid to trigger this event and
|
||
250 | * if it is, trigger it for us and prevent other keypresses from triggering.
|
||
251 | * In this case we're handling RETURN and SPACEBAR keypresses (event codes 13
|
||
252 | * and 32. RETURN is often used to submit a form when in a textfield, and
|
||
253 | * SPACE is often used to activate an element without submitting.
|
||
254 | */
|
||
255 | Drupal.ajax.prototype.keypressResponse = function (element, event) { |
||
256 | // Create a synonym for this to reduce code confusion.
|
||
257 | var ajax = this; |
||
258 | |||
259 | // Detect enter key and space bar and allow the standard response for them,
|
||
260 | // except for form elements of type 'text' and 'textarea', where the
|
||
261 | // spacebar activation causes inappropriate activation if #ajax['keypress'] is
|
||
262 | // TRUE. On a text-type widget a space should always be a space.
|
||
263 | if (event.which == 13 || (event.which == 32 && element.type != 'text' && element.type != 'textarea')) { |
||
264 | $(ajax.element_settings.element).trigger(ajax.element_settings.event);
|
||
265 | return false; |
||
266 | } |
||
267 | }; |
||
268 | |||
269 | /**
|
||
270 | * Handle an event that triggers an Ajax response.
|
||
271 | *
|
||
272 | * When an event that triggers an Ajax response happens, this method will
|
||
273 | * perform the actual Ajax call. It is bound to the event using
|
||
274 | * bind() in the constructor, and it uses the options specified on the
|
||
275 | * ajax object.
|
||
276 | */
|
||
277 | Drupal.ajax.prototype.eventResponse = function (element, event) { |
||
278 | // Create a synonym for this to reduce code confusion.
|
||
279 | var ajax = this; |
||
280 | |||
281 | // Do not perform another ajax command if one is already in progress.
|
||
282 | if (ajax.ajaxing) {
|
||
283 | return false; |
||
284 | } |
||
285 | |||
286 | try {
|
||
287 | if (ajax.form) {
|
||
288 | // If setClick is set, we must set this to ensure that the button's
|
||
289 | // value is passed.
|
||
290 | if (ajax.setClick) {
|
||
291 | // Mark the clicked button. 'form.clk' is a special variable for
|
||
292 | // ajaxSubmit that tells the system which element got clicked to
|
||
293 | // trigger the submit. Without it there would be no 'op' or
|
||
294 | // equivalent.
|
||
295 | element.form.clk = element; |
||
296 | } |
||
297 | |||
298 | ajax.form.ajaxSubmit(ajax.options); |
||
299 | } |
||
300 | else {
|
||
301 | ajax.beforeSerialize(ajax.element, ajax.options); |
||
302 | $.ajax(ajax.options);
|
||
303 | } |
||
304 | } |
||
305 | catch (e) {
|
||
306 | // Unset the ajax.ajaxing flag here because it won't be unset during
|
||
307 | // the complete response.
|
||
308 | ajax.ajaxing = false;
|
||
309 | alert("An error occurred while attempting to process " + ajax.options.url + ": " + e.message); |
||
310 | } |
||
311 | |||
312 | // For radio/checkbox, allow the default event. On IE, this means letting
|
||
313 | // it actually check the box.
|
||
314 | if (typeof element.type != 'undefined' && (element.type == 'checkbox' || element.type == 'radio')) { |
||
315 | return true; |
||
316 | } |
||
317 | else {
|
||
318 | return false; |
||
319 | } |
||
320 | |||
321 | }; |
||
322 | |||
323 | /**
|
||
324 | * Handler for the form serialization.
|
||
325 | *
|
||
326 | * Runs before the beforeSend() handler (see below), and unlike that one, runs
|
||
327 | * before field data is collected.
|
||
328 | */
|
||
329 | Drupal.ajax.prototype.beforeSerialize = function (element, options) { |
||
330 | // Allow detaching behaviors to update field values before collecting them.
|
||
331 | // This is only needed when field values are added to the POST data, so only
|
||
332 | // when there is a form such that this.form.ajaxSubmit() is used instead of
|
||
333 | // $.ajax(). When there is no form and $.ajax() is used, beforeSerialize()
|
||
334 | // isn't called, but don't rely on that: explicitly check this.form.
|
||
335 | if (this.form) { |
||
336 | var settings = this.settings || Drupal.settings; |
||
337 | Drupal.detachBehaviors(this.form, settings, 'serialize'); |
||
338 | } |
||
339 | |||
340 | // Prevent duplicate HTML ids in the returned markup.
|
||
341 | // @see drupal_html_id()
|
||
342 | options.data['ajax_html_ids[]'] = [];
|
||
343 | $('[id]').each(function () { |
||
344 | options.data['ajax_html_ids[]'].push(this.id); |
||
345 | }); |
||
346 | |||
347 | // Allow Drupal to return new JavaScript and CSS files to load without
|
||
348 | // returning the ones already loaded.
|
||
349 | // @see ajax_base_page_theme()
|
||
350 | // @see drupal_get_css()
|
||
351 | // @see drupal_get_js()
|
||
352 | options.data['ajax_page_state[theme]'] = Drupal.settings.ajaxPageState.theme;
|
||
353 | options.data['ajax_page_state[theme_token]'] = Drupal.settings.ajaxPageState.theme_token;
|
||
354 | for (var key in Drupal.settings.ajaxPageState.css) { |
||
355 | options.data['ajax_page_state[css][' + key + ']'] = 1; |
||
356 | } |
||
357 | for (var key in Drupal.settings.ajaxPageState.js) { |
||
358 | options.data['ajax_page_state[js][' + key + ']'] = 1; |
||
359 | } |
||
360 | }; |
||
361 | |||
362 | /**
|
||
363 | * Modify form values prior to form submission.
|
||
364 | */
|
||
365 | Drupal.ajax.prototype.beforeSubmit = function (form_values, element, options) { |
||
366 | // This function is left empty to make it simple to override for modules
|
||
367 | // that wish to add functionality here.
|
||
368 | }; |
||
369 | |||
370 | /**
|
||
371 | * Prepare the Ajax request before it is sent.
|
||
372 | */
|
||
373 | Drupal.ajax.prototype.beforeSend = function (xmlhttprequest, options) { |
||
374 | // For forms without file inputs, the jQuery Form plugin serializes the form
|
||
375 | // values, and then calls jQuery's $.ajax() function, which invokes this
|
||
376 | // handler. In this circumstance, options.extraData is never used. For forms
|
||
377 | // with file inputs, the jQuery Form plugin uses the browser's normal form
|
||
378 | // submission mechanism, but captures the response in a hidden IFRAME. In this
|
||
379 | // circumstance, it calls this handler first, and then appends hidden fields
|
||
380 | // to the form to submit the values in options.extraData. There is no simple
|
||
381 | // way to know which submission mechanism will be used, so we add to extraData
|
||
382 | // regardless, and allow it to be ignored in the former case.
|
||
383 | if (this.form) { |
||
384 | options.extraData = options.extraData || {}; |
||
385 | |||
386 | // Let the server know when the IFRAME submission mechanism is used. The
|
||
387 | // server can use this information to wrap the JSON response in a TEXTAREA,
|
||
388 | // as per http://jquery.malsup.com/form/#file-upload.
|
||
389 | options.extraData.ajax_iframe_upload = '1';
|
||
390 | |||
391 | // The triggering element is about to be disabled (see below), but if it
|
||
392 | // contains a value (e.g., a checkbox, textfield, select, etc.), ensure that
|
||
393 | // value is included in the submission. As per above, submissions that use
|
||
394 | // $.ajax() are already serialized prior to the element being disabled, so
|
||
395 | // this is only needed for IFRAME submissions.
|
||
396 | var v = $.fieldValue(this.element); |
||
397 | if (v !== null) { |
||
398 | f842d52a | Julien Enselme | options.extraData[this.element.name] = Drupal.checkPlain(v);
|
399 | 85ad3d82 | Assos Assos | } |
400 | } |
||
401 | |||
402 | // Disable the element that received the change to prevent user interface
|
||
403 | // interaction while the Ajax request is in progress. ajax.ajaxing prevents
|
||
404 | // the element from triggering a new request, but does not prevent the user
|
||
405 | // from changing its value.
|
||
406 | $(this.element).addClass('progress-disabled').attr('disabled', true); |
||
407 | |||
408 | // Insert progressbar or throbber.
|
||
409 | if (this.progress.type == 'bar') { |
||
410 | var progressBar = new Drupal.progressBar('ajax-progress-' + this.element.id, eval(this.progress.update_callback), this.progress.method, eval(this.progress.error_callback)); |
||
411 | if (this.progress.message) { |
||
412 | progressBar.setProgress(-1, this.progress.message); |
||
413 | } |
||
414 | if (this.progress.url) { |
||
415 | progressBar.startMonitoring(this.progress.url, this.progress.interval || 1500); |
||
416 | } |
||
417 | this.progress.element = $(progressBar.element).addClass('ajax-progress ajax-progress-bar'); |
||
418 | this.progress.object = progressBar;
|
||
419 | $(this.element).after(this.progress.element); |
||
420 | } |
||
421 | else if (this.progress.type == 'throbber') { |
||
422 | this.progress.element = $('<div class="ajax-progress ajax-progress-throbber"><div class="throbber"> </div></div>'); |
||
423 | if (this.progress.message) { |
||
424 | $('.throbber', this.progress.element).after('<div class="message">' + this.progress.message + '</div>'); |
||
425 | } |
||
426 | $(this.element).after(this.progress.element); |
||
427 | } |
||
428 | }; |
||
429 | |||
430 | /**
|
||
431 | * Handler for the form redirection completion.
|
||
432 | */
|
||
433 | Drupal.ajax.prototype.success = function (response, status) { |
||
434 | // Remove the progress element.
|
||
435 | if (this.progress.element) { |
||
436 | $(this.progress.element).remove(); |
||
437 | } |
||
438 | if (this.progress.object) { |
||
439 | this.progress.object.stopMonitoring();
|
||
440 | } |
||
441 | $(this.element).removeClass('progress-disabled').removeAttr('disabled'); |
||
442 | |||
443 | Drupal.freezeHeight(); |
||
444 | |||
445 | for (var i in response) { |
||
446 | if (response.hasOwnProperty(i) && response[i]['command'] && this.commands[response[i]['command']]) { |
||
447 | this.commands[response[i]['command']](this, response[i], status); |
||
448 | } |
||
449 | } |
||
450 | |||
451 | // Reattach behaviors, if they were detached in beforeSerialize(). The
|
||
452 | // attachBehaviors() called on the new content from processing the response
|
||
453 | // commands is not sufficient, because behaviors from the entire form need
|
||
454 | // to be reattached.
|
||
455 | if (this.form) { |
||
456 | var settings = this.settings || Drupal.settings; |
||
457 | Drupal.attachBehaviors(this.form, settings);
|
||
458 | } |
||
459 | |||
460 | Drupal.unfreezeHeight(); |
||
461 | |||
462 | // Remove any response-specific settings so they don't get used on the next
|
||
463 | // call by mistake.
|
||
464 | this.settings = null; |
||
465 | }; |
||
466 | |||
467 | /**
|
||
468 | * Build an effect object which tells us how to apply the effect when adding new HTML.
|
||
469 | */
|
||
470 | Drupal.ajax.prototype.getEffect = function (response) { |
||
471 | var type = response.effect || this.effect; |
||
472 | var speed = response.speed || this.speed; |
||
473 | |||
474 | var effect = {};
|
||
475 | if (type == 'none') { |
||
476 | effect.showEffect = 'show';
|
||
477 | effect.hideEffect = 'hide';
|
||
478 | effect.showSpeed = '';
|
||
479 | } |
||
480 | else if (type == 'fade') { |
||
481 | effect.showEffect = 'fadeIn';
|
||
482 | effect.hideEffect = 'fadeOut';
|
||
483 | effect.showSpeed = speed; |
||
484 | } |
||
485 | else {
|
||
486 | effect.showEffect = type + 'Toggle';
|
||
487 | effect.hideEffect = type + 'Toggle';
|
||
488 | effect.showSpeed = speed; |
||
489 | } |
||
490 | |||
491 | return effect;
|
||
492 | }; |
||
493 | |||
494 | /**
|
||
495 | * Handler for the form redirection error.
|
||
496 | */
|
||
497 | 08f5d39b | Assos Assos | Drupal.ajax.prototype.error = function (xmlhttprequest, uri, customMessage) { |
498 | b0dc3a2e | Julien Enselme | Drupal.displayAjaxError(Drupal.ajaxError(xmlhttprequest, uri, customMessage)); |
499 | 85ad3d82 | Assos Assos | // Remove the progress element.
|
500 | if (this.progress.element) { |
||
501 | $(this.progress.element).remove(); |
||
502 | } |
||
503 | if (this.progress.object) { |
||
504 | this.progress.object.stopMonitoring();
|
||
505 | } |
||
506 | // Undo hide.
|
||
507 | $(this.wrapper).show(); |
||
508 | // Re-enable the element.
|
||
509 | $(this.element).removeClass('progress-disabled').removeAttr('disabled'); |
||
510 | // Reattach behaviors, if they were detached in beforeSerialize().
|
||
511 | if (this.form) { |
||
512 | 08f5d39b | Assos Assos | var settings = this.settings || Drupal.settings; |
513 | 85ad3d82 | Assos Assos | Drupal.attachBehaviors(this.form, settings);
|
514 | } |
||
515 | }; |
||
516 | |||
517 | /**
|
||
518 | * Provide a series of commands that the server can request the client perform.
|
||
519 | */
|
||
520 | Drupal.ajax.prototype.commands = { |
||
521 | /**
|
||
522 | * Command to insert new content into the DOM.
|
||
523 | */
|
||
524 | insert: function (ajax, response, status) { |
||
525 | // Get information from the response. If it is not there, default to
|
||
526 | // our presets.
|
||
527 | var wrapper = response.selector ? $(response.selector) : $(ajax.wrapper); |
||
528 | var method = response.method || ajax.method;
|
||
529 | var effect = ajax.getEffect(response);
|
||
530 | |||
531 | // We don't know what response.data contains: it might be a string of text
|
||
532 | // without HTML, so don't rely on jQuery correctly iterpreting
|
||
533 | // $(response.data) as new HTML rather than a CSS selector. Also, if
|
||
534 | // response.data contains top-level text nodes, they get lost with either
|
||
535 | // $(response.data) or $('<div></div>').replaceWith(response.data).
|
||
536 | var new_content_wrapped = $('<div></div>').html(response.data); |
||
537 | var new_content = new_content_wrapped.contents();
|
||
538 | |||
539 | // For legacy reasons, the effects processing code assumes that new_content
|
||
540 | // consists of a single top-level element. Also, it has not been
|
||
541 | // sufficiently tested whether attachBehaviors() can be successfully called
|
||
542 | // with a context object that includes top-level text nodes. However, to
|
||
543 | // give developers full control of the HTML appearing in the page, and to
|
||
544 | // enable Ajax content to be inserted in places where DIV elements are not
|
||
545 | // allowed (e.g., within TABLE, TR, and SPAN parents), we check if the new
|
||
546 | // content satisfies the requirement of a single top-level element, and
|
||
547 | // only use the container DIV created above when it doesn't. For more
|
||
548 | // information, please see http://drupal.org/node/736066.
|
||
549 | if (new_content.length != 1 || new_content.get(0).nodeType != 1) { |
||
550 | new_content = new_content_wrapped; |
||
551 | } |
||
552 | |||
553 | // If removing content from the wrapper, detach behaviors first.
|
||
554 | switch (method) {
|
||
555 | case 'html': |
||
556 | case 'replaceWith': |
||
557 | case 'replaceAll': |
||
558 | case 'empty': |
||
559 | case 'remove': |
||
560 | var settings = response.settings || ajax.settings || Drupal.settings;
|
||
561 | Drupal.detachBehaviors(wrapper, settings); |
||
562 | } |
||
563 | |||
564 | // Add the new content to the page.
|
||
565 | wrapper[method](new_content); |
||
566 | |||
567 | // Immediately hide the new content if we're using any effects.
|
||
568 | if (effect.showEffect != 'show') { |
||
569 | new_content.hide(); |
||
570 | } |
||
571 | |||
572 | // Determine which effect to use and what content will receive the
|
||
573 | // effect, then show the new content.
|
||
574 | if ($('.ajax-new-content', new_content).length > 0) { |
||
575 | $('.ajax-new-content', new_content).hide(); |
||
576 | new_content.show(); |
||
577 | $('.ajax-new-content', new_content)[effect.showEffect](effect.showSpeed); |
||
578 | } |
||
579 | else if (effect.showEffect != 'show') { |
||
580 | new_content[effect.showEffect](effect.showSpeed); |
||
581 | } |
||
582 | |||
583 | // Attach all JavaScript behaviors to the new content, if it was successfully
|
||
584 | // added to the page, this if statement allows #ajax['wrapper'] to be
|
||
585 | // optional.
|
||
586 | if (new_content.parents('html').length > 0) { |
||
587 | // Apply any settings from the returned JSON if available.
|
||
588 | var settings = response.settings || ajax.settings || Drupal.settings;
|
||
589 | Drupal.attachBehaviors(new_content, settings); |
||
590 | } |
||
591 | }, |
||
592 | |||
593 | /**
|
||
594 | * Command to remove a chunk from the page.
|
||
595 | */
|
||
596 | remove: function (ajax, response, status) { |
||
597 | var settings = response.settings || ajax.settings || Drupal.settings;
|
||
598 | Drupal.detachBehaviors($(response.selector), settings);
|
||
599 | $(response.selector).remove();
|
||
600 | }, |
||
601 | |||
602 | /**
|
||
603 | * Command to mark a chunk changed.
|
||
604 | */
|
||
605 | changed: function (ajax, response, status) { |
||
606 | if (!$(response.selector).hasClass('ajax-changed')) { |
||
607 | $(response.selector).addClass('ajax-changed'); |
||
608 | if (response.asterisk) {
|
||
609 | $(response.selector).find(response.asterisk).append(' <span class="ajax-changed">*</span> '); |
||
610 | } |
||
611 | } |
||
612 | }, |
||
613 | |||
614 | /**
|
||
615 | * Command to provide an alert.
|
||
616 | */
|
||
617 | alert: function (ajax, response, status) { |
||
618 | alert(response.text, response.title); |
||
619 | }, |
||
620 | |||
621 | /**
|
||
622 | * Command to provide the jQuery css() function.
|
||
623 | */
|
||
624 | css: function (ajax, response, status) { |
||
625 | $(response.selector).css(response.argument);
|
||
626 | }, |
||
627 | |||
628 | /**
|
||
629 | * Command to set the settings that will be used for other commands in this response.
|
||
630 | */
|
||
631 | settings: function (ajax, response, status) { |
||
632 | if (response.merge) {
|
||
633 | $.extend(true, Drupal.settings, response.settings); |
||
634 | } |
||
635 | else {
|
||
636 | ajax.settings = response.settings; |
||
637 | } |
||
638 | }, |
||
639 | |||
640 | /**
|
||
641 | * Command to attach data using jQuery's data API.
|
||
642 | */
|
||
643 | data: function (ajax, response, status) { |
||
644 | $(response.selector).data(response.name, response.value);
|
||
645 | }, |
||
646 | |||
647 | /**
|
||
648 | * Command to apply a jQuery method.
|
||
649 | */
|
||
650 | invoke: function (ajax, response, status) { |
||
651 | var $element = $(response.selector); |
||
652 | $element[response.method].apply($element, response.arguments); |
||
653 | }, |
||
654 | |||
655 | /**
|
||
656 | * Command to restripe a table.
|
||
657 | */
|
||
658 | restripe: function (ajax, response, status) { |
||
659 | // :even and :odd are reversed because jQuery counts from 0 and
|
||
660 | // we count from 1, so we're out of sync.
|
||
661 | // Match immediate children of the parent element to allow nesting.
|
||
662 | $('> tbody > tr:visible, > tr:visible', $(response.selector)) |
||
663 | .removeClass('odd even')
|
||
664 | .filter(':even').addClass('odd').end() |
||
665 | .filter(':odd').addClass('even'); |
||
666 | 42e6daf3 | Julien Enselme | }, |
667 | |||
668 | b4adf10d | Assos Assos | /**
|
669 | * Command to add css.
|
||
670 | *
|
||
671 | * Uses the proprietary addImport method if available as browsers which
|
||
672 | * support that method ignore @import statements in dynamically added
|
||
673 | * stylesheets.
|
||
674 | */
|
||
675 | add_css: function (ajax, response, status) { |
||
676 | // Add the styles in the normal way.
|
||
677 | $('head').prepend(response.data); |
||
678 | // Add imports in the styles using the addImport method if available.
|
||
679 | var match, importMatch = /^@import url\("(.*)"\);$/igm; |
||
680 | if (document.styleSheets[0].addImport && importMatch.test(response.data)) { |
||
681 | importMatch.lastIndex = 0;
|
||
682 | while (match = importMatch.exec(response.data)) {
|
||
683 | document.styleSheets[0].addImport(match[1]); |
||
684 | } |
||
685 | } |
||
686 | }, |
||
687 | |||
688 | 42e6daf3 | Julien Enselme | /**
|
689 | * Command to update a form's build ID.
|
||
690 | */
|
||
691 | updateBuildId: function(ajax, response, status) { |
||
692 | 4444412d | Julien Enselme | $('input[name="form_build_id"][value="' + response['old'] + '"]').val(response['new']); |
693 | 85ad3d82 | Assos Assos | } |
694 | }; |
||
695 | |||
696 | })(jQuery); |