• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

divio / django-cms / #30138

19 Nov 2025 07:08AM UTC coverage: 89.921% (+12.2%) from 77.7%
#30138

push

travis-ci

web-flow
Merge 47ea1d265 into e10689d2d

1337 of 2148 branches covered (62.24%)

9207 of 10239 relevant lines covered (89.92%)

11.19 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

96.66
/cms/static/cms/js/modules/cms.modal.js
1
/*
2
 * Copyright https://github.com/divio/django-cms
3
 */
4

5
import ChangeTracker from './cms.changetracker';
6
import keyboard from './keyboard';
7

8
import $ from 'jquery';
9
import './jquery.transition';
10
import { trap, untrap } from './trap';
11

12
import { Helpers, KEYS } from './cms.base';
13
import { showLoader, hideLoader } from './loader';
14

15
var previousKeyboardContext;
16
var previouslyFocusedElement;
17

18
/**
19
 * The modal is triggered via API calls from the backend either
20
 * through the toolbar navigation or from plugins. The APIs allow to
21
 * open content from a url (iframe) or inject html directly.
22
 *
23
 * @class Modal
24
 * @namespace CMS
25
 */
26
class Modal {
27
    constructor(options) {
28
        this.options = $.extend(true, {}, Modal.options, options);
163✔
29

30
        // elements
31
        this._setupUI();
163✔
32

33
        // states and events
34
        this.click = 'click.cms.modal';
163✔
35
        this.pointerDown = 'pointerdown.cms.modal contextmenu.cms.modal';
163✔
36
        this.pointerUp = 'pointerup.cms.modal pointercancel.cms.modal';
163✔
37
        this.pointerMove = 'pointermove.cms.modal';
163✔
38
        this.doubleClick = 'dblclick.cms.modal';
163✔
39
        this.touchEnd = 'touchend.cms.modal';
163✔
40
        this.keyUp = 'keyup.cms.modal';
163✔
41
        this.maximized = false;
163✔
42
        this.minimized = false;
163✔
43
        this.triggerMaximized = false;
163✔
44
        this.saved = false;
163✔
45

46
        this._beforeUnloadHandler = this._beforeUnloadHandler.bind(this);
163✔
47
    }
48

49
    /**
50
     * Stores all jQuery references within `this.ui`.
51
     *
52
     * @method _setupUI
53
     * @private
54
     */
55
    _setupUI() {
56
        var modal = $('.cms-modal');
163✔
57

58
        this.ui = {
163✔
59
            modal: modal,
60
            body: $('html'),
61
            window: $(window),
62
            toolbarLeftPart: $('.cms-toolbar-left'),
63
            minimizeButton: modal.find('.cms-modal-minimize'),
64
            maximizeButton: modal.find('.cms-modal-maximize'),
65
            title: modal.find('.cms-modal-title'),
66
            titlePrefix: modal.find('.cms-modal-title-prefix'),
67
            titleSuffix: modal.find('.cms-modal-title-suffix'),
68
            resize: modal.find('.cms-modal-resize'),
69
            breadcrumb: modal.find('.cms-modal-breadcrumb'),
70
            closeAndCancel: modal.find('.cms-modal-close, .cms-modal-cancel'),
71
            modalButtons: modal.find('.cms-modal-buttons'),
72
            modalBody: modal.find('.cms-modal-body'),
73
            frame: modal.find('.cms-modal-frame'),
74
            shim: modal.find('.cms-modal-shim')
75
        };
76
    }
77

78
    /**
79
     * Sets up all the event handlers, such as maximize/minimize and resizing.
80
     *
81
     * @method _events
82
     * @private
83
     */
84
    _events() {
85
        var that = this;
34✔
86

87
        // modal behaviours
88
        this.ui.minimizeButton
34✔
89
            .off(this.click + ' ' + this.touchEnd + ' ' + this.keyUp)
90
            .on(this.click + ' ' + this.touchEnd + ' ' + this.keyUp, function(e) {
91
                if (e.type !== 'keyup' || (e.type === 'keyup' && e.keyCode === KEYS.ENTER)) {
4!
92
                    e.preventDefault();
4✔
93
                    that.minimize();
4✔
94
                }
95
            });
96
        this.ui.maximizeButton
34✔
97
            .off(this.click + ' ' + this.touchEnd + ' ' + this.keyUp)
98
            .on(this.click + ' ' + this.touchEnd + ' ' + this.keyUp, function(e) {
99
                if (e.type !== 'keyup' || (e.type === 'keyup' && e.keyCode === KEYS.ENTER)) {
4!
100
                    e.preventDefault();
4✔
101
                    that.maximize();
4✔
102
                }
103
            });
104

105
        this.ui.title.off(this.pointerDown).on(this.pointerDown, function(e) {
34✔
106
            e.preventDefault();
4✔
107
            that._startMove(e);
4✔
108
        });
109
        this.ui.title.off(this.doubleClick).on(this.doubleClick, function() {
34✔
110
            that.maximize();
2✔
111
        });
112

113
        this.ui.resize.off(this.pointerDown).on(this.pointerDown, function(e) {
34✔
114
            e.preventDefault();
4✔
115
            that._startResize(e);
4✔
116
        });
117

118
        this.ui.closeAndCancel
34✔
119
            .off(this.click + ' ' + this.touchEnd + ' ' + this.keyUp)
120
            .on(this.click + ' ' + this.touchEnd + ' ' + this.keyUp, function(e) {
121
                if (e.type !== 'keyup' || (e.type === 'keyup' && e.keyCode === KEYS.ENTER)) {
4!
122
                    e.preventDefault();
4✔
123
                    that._cancelHandler();
4✔
124
                }
125
            });
126

127
        // elements within the window
128
        this.ui.breadcrumb.off(this.click, 'a').on(this.click, 'a', function(e) {
34✔
129
            e.preventDefault();
2✔
130
            that._changeIframe($(this));
2✔
131
        });
132
    }
133

134
    /**
135
     * Opens the modal either in an iframe or renders markup.
136
     *
137
     * @method open
138
     * @chainable
139
     * @param {Object} opts either `opts.url` or `opts.html` are required
140
     * @param {Object[]} [opts.breadcrumbs] collection of breadcrumb items
141
     * @param {String|HTMLNode|jQuery} [opts.html] html markup to render
142
     * @param {String} [opts.title] modal window main title (bold)
143
     * @param {String} [opts.subtitle] modal window secondary title (normal)
144
     * @param {String} [opts.url] url to render iframe, takes precedence over `opts.html`
145
     * @param {Number} [opts.width] sets the width of the modal
146
     * @param {Number} [opts.height] sets the height of the modal
147
     * @returns {Class} this
148
     */
149
    open(opts) {
150
        // setup internals
151
        if (!((opts && opts.url) || (opts && opts.html))) {
35✔
152
            throw new Error('The arguments passed to "open" were invalid.');
4✔
153
        }
154

155
        // We have to rebind events every time we open a modal
156
        // because the event handlers contain references to the instance
157
        // and since we reuse the same markup we need to update
158
        // that instance reference every time.
159
        this._events();
31✔
160

161
        Helpers.dispatchEvent('modal-load', { instance: this });
31✔
162
        // // trigger the event also on the dom element,
163
        // // because if we load another modal while one is already open
164
        // // the older instance won't receive any updates
165
        // this.ui.modal.trigger('cms.modal.load');
166

167
        // common elements state
168
        this.ui.resize.toggle(this.options.resizable);
31✔
169
        this.ui.minimizeButton.toggle(this.options.minimizable);
31✔
170
        this.ui.maximizeButton.toggle(this.options.maximizable);
31✔
171

172
        const position = this._calculateNewPosition(opts);
31✔
173

174
        this.ui.maximizeButton.removeClass('cms-modal-maximize-active');
31✔
175
        this.maximized = false;
31✔
176

177
        // because a new instance is called, we have to ensure minimized state is removed #3620
178
        if (this.ui.body.hasClass('cms-modal-minimized')) {
31✔
179
            this.minimized = true;
1✔
180
            this.minimize();
1✔
181
        }
182

183
        // clear elements
184
        this.ui.modalButtons.empty();
31✔
185
        this.ui.breadcrumb.empty();
31✔
186

187
        // remove class from modal when no breadcrumbs is rendered
188
        this.ui.modal.removeClass('cms-modal-has-breadcrumb');
31✔
189

190
        // hide tooltip
191
        CMS.API.Tooltip.hide();
31✔
192

193
        // redirect to iframe rendering if url is provided
194
        if (opts.url) {
31✔
195
            this._loadIframe({
1✔
196
                url: opts.url,
197
                title: opts.title,
198
                breadcrumbs: opts.breadcrumbs
199
            });
200
        } else {
201
            // if url is not provided we go for html
202
            this._loadMarkup({
30✔
203
                html: opts.html,
204
                title: opts.title,
205
                subtitle: opts.subtitle
206
            });
207
        }
208

209
        Helpers.dispatchEvent('modal-loaded', { instance: this });
31✔
210

211
        var currentContext = keyboard.getContext();
31✔
212

213
        if (currentContext !== 'modal') {
31✔
214
            previousKeyboardContext = keyboard.getContext();
9✔
215
            previouslyFocusedElement = $(document.activeElement);
9✔
216
        }
217

218
        // display modal
219
        this._show(
31✔
220
            $.extend(
221
                {
222
                    duration: this.options.modalDuration
223
                },
224
                position
225
            )
226
        );
227

228
        keyboard.setContext('modal');
31✔
229
        return this;
31✔
230
    }
231

232
    /**
233
     * Calculates coordinates and dimensions for modal placement
234
     *
235
     * @method _calculateNewPosition
236
     * @private
237
     * @param {Object} [opts]
238
     * @param {Number} [opts.width] desired width of the modal
239
     * @param {Number} [opts.height] desired height of the modal
240
     * @returns {Object}
241
     */
242
    // eslint-disable-next-line complexity
243
    _calculateNewPosition(opts) {
244
        // lets set the modal width and height to the size of the browser
245
        var widthOffset = 300; // adds margin left and right
48✔
246
        var heightOffset = 300; // adds margin top and bottom;
48✔
247
        var screenWidth = this.ui.window.width();
48✔
248
        var screenHeight = this.ui.window.height();
48✔
249
        var modalWidth = opts.width || this.options.minWidth;
48✔
250
        var modalHeight = opts.height || this.options.minHeight;
48✔
251
        // screen width and height calculation, WC = width
252
        var screenWidthCalc = screenWidth >= modalWidth + widthOffset;
48✔
253
        var screenHeightCalc = screenHeight >= modalHeight + heightOffset;
48✔
254

255
        var width = screenWidthCalc && !opts.width ? screenWidth - widthOffset : modalWidth;
48✔
256
        var height = screenHeightCalc && !opts.height ? screenHeight - heightOffset : modalHeight;
48✔
257

258
        var currentLeft = this.ui.modal.css('left');
48✔
259
        var currentTop = this.ui.modal.css('top');
48✔
260
        var newLeft;
261
        var newTop;
262

263
        // jquery made me do it
264
        if (currentLeft === '50%') {
48✔
265
            currentLeft = screenWidth / 2;
27✔
266
        }
267
        if (currentTop === '50%') {
48✔
268
            currentTop = screenHeight / 2;
27✔
269
        }
270

271
        currentTop = parseInt(currentTop, 10);
48✔
272
        currentLeft = parseInt(currentLeft, 10);
48✔
273

274
        // if new width/height go out of the screen - reset position to center of screen
275
        if (
48✔
276
            width / 2 + currentLeft > screenWidth ||
174✔
277
            height / 2 + currentTop > screenHeight ||
278
            currentLeft - width / 2 < 0 ||
279
            currentTop - height / 2 < 0
280
        ) {
281
            newLeft = screenWidth / 2;
13✔
282
            newTop = screenHeight / 2;
13✔
283
        }
284

285
        // in case, the modal is larger than the window, we trigger fullscreen mode
286
        if (width >= screenWidth || height >= screenHeight) {
48✔
287
            this.triggerMaximized = true;
3✔
288
        }
289

290
        return {
48✔
291
            width: width,
292
            height: height,
293
            top: newTop,
294
            left: newLeft
295
        };
296
    }
297

298
    /**
299
     * Animation helper for opening the sideframe.
300
     *
301
     * @method _show
302
     * @private
303
     * @param {Object} opts
304
     * @param {Number} opts.width width of the modal
305
     * @param {Number} opts.height height of the modal
306
     * @param {Number} opts.left left in px of the center of the modal
307
     * @param {Number} opts.top top in px of the center of the modal
308
     * @param {Number} opts.duration speed of opening, ms (not really used yet)
309
     */
310
    _show(opts) {
311
        // we need to position the modal in the center
312
        var that = this;
41✔
313
        var width = opts.width;
41✔
314
        var height = opts.height;
41✔
315
        var speed = opts.duration;
41✔
316
        var top = opts.top;
41✔
317
        var left = opts.left;
41✔
318

319
        if (this.ui.modal.hasClass('cms-modal-open')) {
41✔
320
            this.ui.modal.addClass('cms-modal-morphing');
1✔
321
        }
322

323
        this.ui.modal.css({
41✔
324
            display: 'block',
325
            width: width,
326
            height: height,
327
            top: top,
328
            left: left,
329
            'margin-left': -(width / 2),
330
            'margin-top': -(height / 2)
331
        });
332
        // setImmediate is required to go into the next frame
333
        setTimeout(function() {
41✔
334
            that.ui.modal.addClass('cms-modal-open');
41✔
335
        }, 0);
336

337
        this.ui.modal
41✔
338
            .one('cmsTransitionEnd', function() {
339
                that.ui.modal.removeClass('cms-modal-morphing');
37✔
340
                that.ui.modal.css({
37✔
341
                    'margin-left': -(width / 2),
342
                    'margin-top': -(height / 2)
343
                });
344

345
                // check if we should maximize
346
                if (that.triggerMaximized) {
37✔
347
                    that.maximize();
1✔
348
                }
349

350
                // changed locked status to allow other modals again
351
                CMS.API.locked = false;
37✔
352
                Helpers.dispatchEvent('modal-shown', { instance: that });
37✔
353
            })
354
            .emulateTransitionEnd(speed);
355

356
        // add esc close event
357
        this.ui.body.off('keydown.cms.close').on('keydown.cms.close', function(e) {
41✔
358
            if (e.keyCode === KEYS.ESC && that.options.closeOnEsc) {
6✔
359
                e.stopPropagation();
3✔
360
                if (that._confirmDirtyEscCancel()) {
3✔
361
                    that._cancelHandler();
2✔
362
                }
363
            }
364
        });
365

366
        // set focus to modal
367
        this.ui.modal.focus();
41✔
368
    }
369

370
    /**
371
     * Closes the current instance.
372
     *
373
     * @method close
374
     * @returns {Boolean|void}
375
     */
376
    close() {
377
        var event = Helpers.dispatchEvent('modal-close', { instance: this });
10✔
378

379
        if (event.isDefaultPrevented()) {
10✔
380
            return false;
1✔
381
        }
382

383
        Helpers._getWindow().removeEventListener('beforeunload', this._beforeUnloadHandler);
9✔
384

385
        // handle refresh option
386
        if (this.options.onClose) {
9✔
387
            Helpers.reloadBrowser(this.options.onClose, false);
1✔
388
        }
389
        untrap(this.ui.body[0]);
9✔
390
        keyboard.setContext(previousKeyboardContext);
9✔
391
        try {
9✔
392
            previouslyFocusedElement.focus();
9✔
393
        } catch {}
394

395
        this._hide({
9✔
396
            duration: this.options.modalDuration / 2
397
        });
398
    }
399

400
    /**
401
     * Animation helper for closing the iframe.
402
     *
403
     * @method _hide
404
     * @private
405
     * @param {Object} opts
406
     * @param {Number} [opts.duration=this.options.modalDuration] animation duration
407
     */
408
    _hide(opts) {
409
        var that = this;
16✔
410
        var duration = this.options.modalDuration;
16✔
411

412
        if (opts && opts.duration) {
16✔
413
            duration = opts.duration;
9✔
414
        }
415

416
        this.ui.frame.empty();
16✔
417
        this.ui.modalBody.removeClass('cms-loader');
16✔
418
        this.ui.modal.removeClass('cms-modal-open');
16✔
419
        this.ui.modal
16✔
420
            .one('cmsTransitionEnd', function() {
421
                that.ui.modal.css('display', 'none');
9✔
422
            })
423
            .emulateTransitionEnd(duration);
424

425
        // reset maximize or minimize states for #3111
426
        setTimeout(function() {
16✔
427
            if (that.minimized) {
13✔
428
                that.minimize();
1✔
429
            }
430
            if (that.maximized) {
13✔
431
                that.maximize();
1✔
432
            }
433
            hideLoader();
13✔
434
            Helpers.dispatchEvent('modal-closed', { instance: that });
13✔
435
        }, this.options.duration);
436

437
        this.ui.body.off('keydown.cms.close');
16✔
438
    }
439

440
    /**
441
     * Minimizes the modal onto the toolbar.
442
     *
443
     * @method minimize
444
     * @returns {Boolean|void}
445
     */
446
    minimize() {
447
        var MINIMIZED_OFFSET = 50;
11✔
448

449
        // cancel action if maximized
450
        if (this.maximized) {
11✔
451
            return false;
1✔
452
        }
453

454
        if (this.minimized === false) {
10✔
455
            // save initial state
456
            this.ui.modal.data('css', this.ui.modal.css(['left', 'top', 'margin-left', 'margin-top']));
5✔
457

458
            // minimize
459
            this.ui.body.addClass('cms-modal-minimized');
5✔
460
            this.ui.modal.css({
5✔
461
                left: this.ui.toolbarLeftPart.outerWidth(true) + MINIMIZED_OFFSET
462
            });
463

464
            this.minimized = true;
5✔
465
        } else {
466
            // maximize
467
            this.ui.body.removeClass('cms-modal-minimized');
5✔
468
            this.ui.modal.css(this.ui.modal.data('css'));
5✔
469

470
            this.minimized = false;
5✔
471
        }
472
    }
473

474
    /**
475
     * Maximizes the window according to the browser size.
476
     *
477
     * @method maximize
478
     * @returns {Boolean|void}
479
     */
480
    maximize() {
481
        // cancel action when minimized
482
        if (this.minimized) {
11✔
483
            return false;
1✔
484
        }
485

486
        if (this.maximized === false) {
10✔
487
            // save initial state
488
            this.ui.modal.data(
5✔
489
                'css',
490
                this.ui.modal.css(['left', 'top', 'margin-left', 'margin-top', 'width', 'height'])
491
            );
492

493
            this.ui.body.addClass('cms-modal-maximized');
5✔
494

495
            this.maximized = true;
5✔
496
            Helpers.dispatchEvent('modal-maximized', { instance: this });
5✔
497
        } else {
498
            // minimize
499
            this.ui.body.removeClass('cms-modal-maximized');
5✔
500
            this.ui.modal.css(this.ui.modal.data('css'));
5✔
501

502
            this.maximized = false;
5✔
503
            Helpers.dispatchEvent('modal-restored', { instance: this });
5✔
504
        }
505
    }
506

507
    /**
508
     * Initiates the start move event from `_events`.
509
     *
510
     * @method _startMove
511
     * @private
512
     * @param {Object} pointerEvent passes starting event
513
     * @returns {Boolean|void}
514
     */
515
    _startMove(pointerEvent) {
516
        // cancel if maximized or minimized
517
        if (this.maximized || this.minimized) {
9✔
518
            return false;
2✔
519
        }
520

521
        var that = this;
7✔
522
        var position = this.ui.modal.position();
7✔
523
        var left;
524
        var top;
525

526
        this.ui.shim.show();
7✔
527

528
        // create event for stopping
529
        this.ui.body.on(this.pointerUp, function(e) {
7✔
530
            that._stopMove(e);
2✔
531
        });
532

533
        this.ui.body
7✔
534
            .on(this.pointerMove, function(e) {
535
                left = position.left - (pointerEvent.originalEvent.pageX - e.originalEvent.pageX);
1✔
536
                top = position.top - (pointerEvent.originalEvent.pageY - e.originalEvent.pageY);
1✔
537

538
                that.ui.modal.css({
1✔
539
                    left: left,
540
                    top: top
541
                });
542
            });
543

544
        // Disable touch actions during modal move
545
        document.body.style.touchAction = 'none';
7✔
546
    }
547

548
    /**
549
     * Initiates the stop move event from `_startMove`.
550
     *
551
     * @method _stopMove
552
     * @private
553
     */
554
    _stopMove() {
555
        this.ui.shim.hide();
3✔
556
        this.ui.body.off(this.pointerMove + ' ' + this.pointerUp);
3✔
557
        // Re-enable touch actions
558
        document.body.style.touchAction = '';
3✔
559
    }
560

561
    /**
562
     * Initiates the start resize event from `_events`.
563
     *
564
     * @method _startResize
565
     * @private
566
     * @param {Object} pointerEvent passes starting event
567
     * @returns {Boolean|void}
568
     */
569
    _startResize(pointerEvent) {
570
        // cancel if in fullscreen
571
        if (this.maximized) {
9✔
572
            return false;
1✔
573
        }
574
        // continue
575
        var that = this;
8✔
576
        var width = this.ui.modal.width();
8✔
577
        var height = this.ui.modal.height();
8✔
578
        var modalLeft = this.ui.modal.position().left;
8✔
579
        var modalTop = this.ui.modal.position().top;
8✔
580
        var resizeDir = this.ui.resize.css('direction') === 'rtl' ? -1 : +1;
8!
581

582
        // create event for stopping
583
        this.ui.body.on(this.pointerUp, function(e) {
8✔
584
            that._stopResize(e);
2✔
585
        });
586

587
        this.ui.shim.show();
8✔
588

589
        this.ui.body
8✔
590
            .on(this.pointerMove, function(e) {
591
                var mvX = pointerEvent.originalEvent.pageX - e.originalEvent.pageX;
3✔
592
                var mvY = pointerEvent.originalEvent.pageY - e.originalEvent.pageY;
3✔
593
                var w = width - resizeDir * mvX * 2;
3✔
594
                var h = height - mvY * 2;
3✔
595
                var wMin = that.options.minWidth;
3✔
596
                var hMin = that.options.minHeight;
3✔
597
                var left = resizeDir * mvX + modalLeft;
3✔
598
                var top = mvY + modalTop;
3✔
599

600
                // add some limits
601
                if (w <= wMin) {
3✔
602
                    w = wMin;
1✔
603
                    left = modalLeft + width / 2 - w / 2;
1✔
604
                }
605
                if (h <= hMin) {
3✔
606
                    h = hMin;
1✔
607
                    top = modalTop + height / 2 - h / 2;
1✔
608
                }
609

610
                // set centered animation
611
                that.ui.modal.css({
3✔
612
                    width: w,
613
                    height: h,
614
                    left: left,
615
                    top: top
616
                });
617
            });
618

619
        // Disable touch actions during modal resize
620
        document.body.style.touchAction = 'none';
8✔
621
    }
622

623
    /**
624
     * Initiates the stop resize event from `_startResize`.
625
     *
626
     * @method _stopResize
627
     * @private
628
     */
629
    _stopResize() {
630
        this.ui.shim.hide();
3✔
631
        this.ui.body.off(this.pointerMove + ' ' + this.pointerUp);
3✔
632
        // Re-enable touch actions
633
        document.body.style.touchAction = '';
3✔
634
    }
635

636
    /**
637
     * Sets the breadcrumb inside the modal.
638
     *
639
     * @method _setBreadcrumb
640
     * @private
641
     * @param {Object[]} breadcrumbs renderes breadcrumb on modal
642
     * @returns {Boolean|void}
643
     */
644
    _setBreadcrumb(breadcrumbs) {
645
        var crumb = '';
11✔
646
        var template = '<a href="{1}" class="{2}"><span>{3}</span></a>';
11✔
647

648
        // cancel if there is no breadcrumbs)
649
        if (!breadcrumbs || breadcrumbs.length <= 1) {
11✔
650
            return false;
3✔
651
        }
652
        if (!breadcrumbs[0].title) {
8✔
653
            return false;
1✔
654
        }
655

656
        // add class to modal
657
        this.ui.modal.addClass('cms-modal-has-breadcrumb');
7✔
658

659
        // load breadcrumbs
660
        $.each(breadcrumbs, function(index, item) {
7✔
661
            // check if the item is the last one
662
            var last = index >= breadcrumbs.length - 1 ? 'active' : '';
21✔
663

664
            // render breadcrumbs
665
            crumb += template.replace('{1}', item.url).replace('{2}', last).replace('{3}', item.title);
21✔
666
        });
667

668
        // attach elements
669
        this.ui.breadcrumb.html(crumb);
7✔
670
    }
671

672
    /**
673
     * Sets the buttons inside the modal.
674
     *
675
     * @method _setButtons
676
     * @private
677
     * @param {jQuery} iframe loaded iframe element
678
     */
679
    _setButtons(iframe) {
680
        var djangoSuit = iframe.contents().find('.suit-columns').length > 0;
4✔
681
        var that = this;
4✔
682
        var group = $('<div class="cms-modal-item-buttons"></div>');
4✔
683
        var render = $('<div class="cms-modal-buttons-inner"></div>');
4✔
684
        var cancel = $('<a href="#" class="cms-btn">' + CMS.config.lang.cancel + '</a>');
4✔
685
        var row;
686
        var tmp;
687

688
        // istanbul ignore if
689
        if (djangoSuit) {
4✔
690
            row = iframe.contents().find('.save-box:eq(0)');
691
        } else {
692
            row = iframe.contents().find('.submit-row:eq(0)');
4✔
693
        }
694
        var form = iframe.contents().find('form');
4✔
695

696
        // avoids conflict between the browser's form validation and Django's validation
697
        form.on('submit', function() {
4✔
698
            // default submit button was clicked
699
            // meaning, if you have save - it should close the iframe,
700
            // if you hit save and continue editing it should be default form behaviour
701
            if (that.hideFrame) {
3✔
702
                that.ui.modal.find('.cms-modal-frame iframe').hide();
2✔
703
                // page has been saved, run checkup
704
                that.saved = true;
2✔
705
            }
706
        });
707
        var buttons = row.find('input, a, button');
4✔
708

709
        // these are the buttons _inside_ the iframe
710
        // we need to listen to this click event to support submitting
711
        // a form by pressing enter inside of a field
712
        // click is actually triggered by submit
713
        buttons.on('click', function() {
4✔
714
            if ($(this).hasClass('default')) {
2✔
715
                that.hideFrame = true;
1✔
716
            }
717
        });
718

719
        // hide all submit-rows
720
        iframe.contents().find('.submit-row').hide();
4✔
721

722
        // if there are no given buttons within the submit-row area
723
        // scan deeper within the form itself
724
        // istanbul ignore next
725
        if (!buttons.length) {
726
            row = iframe.contents().find('body:not(.change-list) #content form:eq(0)');
727
            buttons = row.find('input[type="submit"], button[type="submit"]');
728
            buttons.addClass('deletelink').hide();
729
        }
730

731
        // loop over input buttons
732
        buttons.each(function(index, btn) {
4✔
733
            var item = $(btn);
16✔
734

735
            item.attr('data-rel', '_' + index);
16✔
736

737
            // cancel if item is a hidden input
738
            if (item.attr('type') === 'hidden') {
16✔
739
                return false;
3✔
740
            }
741

742
            var title = item.attr('value') || item.text();
13✔
743
            var cls = 'cms-btn';
13✔
744

745
            if (item.is('button')) {
13✔
746
                title = item.text();
4✔
747
            }
748

749
            // set additional special css classes
750
            if (item.hasClass('default')) {
13✔
751
                cls = 'cms-btn cms-btn-action';
4✔
752
            }
753
            if (item.hasClass('deletelink')) {
13✔
754
                cls = 'cms-btn cms-btn-caution';
3✔
755
            }
756

757
            var el = $('<a href="#" class="' + cls + ' ' + item.attr('class') + '">' + title + '</a>');
13✔
758

759

760
            el.on(that.click + ' ' + that.touchEnd, function(e) {
13✔
761
                e.preventDefault();
5✔
762

763
                if (item.is('a')) {
5✔
764
                    that._loadIframe({
2✔
765
                        url: Helpers.updateUrlWithPath(item.prop('href')),
766
                        name: title
767
                    });
768
                }
769

770
                // trigger only when blue action buttons are triggered
771
                if (item.hasClass('default') || item.hasClass('deletelink')) {
5✔
772
                    // hide iframe when using buttons other than submit
773
                    if (item.hasClass('default')) {
3✔
774
                        // submit button uses the form's submit event
775
                        that.hideFrame = true;
2✔
776
                    } else {
777
                        that.ui.modal.find('.cms-modal-frame iframe').hide();
1✔
778
                        // page has been saved or deleted, run checkup
779
                        that.saved = true;
1✔
780
                    }
781
                }
782

783
                if (item.is('input') || item.is('button')) {
5✔
784
                    that.ui.modalBody.addClass('cms-loader');
3✔
785
                    var frm = item[0].form;
3✔
786

787
                    // In Firefox with 1Password extension installed (FF 45 1password 4.5.6 at least)
788
                    // the item[0].click() doesn't work, which notably breaks
789
                    // deletion of the plugin. Workaround is that if the clicked button
790
                    // is the only button in the form - submit a form, otherwise
791
                    // click on the button
792
                    if (frm.querySelectorAll('button, input[type="button"], input[type="submit"]').length > 1) {
3✔
793
                        // we need to use native `.click()` event specifically
794
                        // as we are inside an iframe and magic is happening
795
                        item[0].click();
2✔
796
                    } else {
797
                        // have to dispatch native submit event so all the submit handlers
798
                        // can be fired, see #5590
799
                        var evt = new CustomEvent('submit', { bubbles: false, cancelable: true });
1✔
800

801
                        if (frm.dispatchEvent(evt)) {
1!
802
                            // triggering submit event in webkit based browsers won't
803
                            // actually submit the form, while in Gecko-based ones it
804
                            // will and calling frm.submit() would throw NS_ERROR_UNEXPECTED
805
                            try {
×
806
                                frm.submit();
×
807
                            } catch {}
808
                        }
809
                    }
810
                }
811
            });
812
            el.wrap(group);
13✔
813

814
            // append element
815
            render.append(el.parent());
13✔
816
        });
817

818
        // manually add cancel button at the end
819
        cancel.on(that.click, function(e) {
4✔
820
            e.preventDefault();
1✔
821
            that._cancelHandler();
1✔
822
        });
823
        cancel.wrap(group);
4✔
824
        render.append(cancel.parent());
4✔
825

826
        // prepare groups
827
        render.find('.cms-btn-group').unwrap();
4✔
828
        tmp = render.find('.cms-btn-group').clone(true, true);
4✔
829
        render.find('.cms-btn-group').remove();
4✔
830
        render.append(tmp.wrapAll(group.clone().addClass('cms-modal-item-buttons-left')).parent());
4✔
831

832
        // render buttons
833
        this.ui.modalButtons.html(render);
4✔
834
    }
835

836
    /**
837
     * Version where the modal loads an iframe.
838
     *
839
     * @method _loadIframe
840
     * @private
841
     * @param {Object} opts
842
     * @param {String} opts.url url to render iframe, takes presedence over opts.html
843
     * @param {Object[]} [opts.breadcrumbs] collection of breadcrumb items
844
     * @param {String} [opts.title] modal window main title (bold)
845
     */
846
    _loadIframe(opts) {
847
        var that = this;
30✔
848
        const SHOW_LOADER_TIMEOUT = 500;
30✔
849

850
        opts.url = Helpers.makeURL(opts.url);
30✔
851
        opts.title = opts.title || '';
30✔
852
        opts.breadcrumbs = opts.breadcrumbs || '';
30✔
853

854
        showLoader();
30✔
855

856
        // set classes
857
        this.ui.modal.removeClass('cms-modal-markup');
30✔
858
        this.ui.modal.addClass('cms-modal-iframe');
30✔
859

860
        // we need to render the breadcrumb
861
        this._setBreadcrumb(opts.breadcrumbs);
30✔
862

863
        // now refresh the content
864
        var holder = this.ui.frame;
30✔
865
        var iframe = $('<iframe tabindex="0" src="' + opts.url + '" class="" frameborder="0" />');
30✔
866

867
        // set correct title
868
        var titlePrefix = this.ui.titlePrefix;
30✔
869
        var titleSuffix = this.ui.titleSuffix;
30✔
870

871
        iframe.css('visibility', 'hidden');
30✔
872
        titlePrefix.text(opts.title || '');
30✔
873
        titleSuffix.text('');
30✔
874

875
        // ensure previous iframe is hidden
876
        holder.find('iframe').css('visibility', 'hidden');
30✔
877
        const loaderTimeout = setTimeout(() => that.ui.modalBody.addClass('cms-loader'), SHOW_LOADER_TIMEOUT);
30✔
878

879
        // attach load event for iframe to prevent flicker effects
880
        // eslint-disable-next-line complexity
881
        iframe.on('load', function() {
30✔
882
            clearTimeout(loaderTimeout);
27✔
883
            var messages;
884
            var messageList;
885
            var contents;
886
            var body;
887
            var innerTitle;
888
            var bc;
889

890
            // check if iframe can be accessed
891
            try {
27✔
892
                contents = iframe.contents();
27✔
893
                body = contents.find('body');
26✔
894
            } catch {
895
                CMS.API.Messages.open({
1✔
896
                    message: '<strong>' + CMS.config.lang.errorLoadingEditForm + '</strong>',
897
                    error: true,
898
                    delay: 0
899
                });
900
                that.close();
1✔
901
                return;
1✔
902
            }
903

904
            // trap focus within modal
905
            trap(body[0]);
26✔
906

907
            // check if we are redirected - should only happen after successful form submission
908
            const redirect = body.find('a.cms-view-new-object').attr('href');
26✔
909

910
            if (redirect) {
26!
911
                Helpers.reloadBrowser(redirect, false);
×
912
                return true;
×
913
            }
914

915
            // If the response contains the close-frame (and potentially the data bridge),
916
            // the form was saved successfully
917
            that.saved = that.saved || body.hasClass('cms-close-frame');
26✔
918

919
            // tabindex is required for keyboard navigation
920
            // body.attr('tabindex', '0');
921
            iframe.on('focus', function() {
26✔
922
                if (this.contentWindow) {
1!
923
                    this.contentWindow.focus();
1✔
924
                }
925
            });
926

927
            Modal._setupCtrlEnterSave(document);
26✔
928
            // istanbul ignore else
929
            if (iframe[0].contentWindow && iframe[0].contentWindow.document) {
26✔
930
                Modal._setupCtrlEnterSave(iframe[0].contentWindow.document);
26✔
931
            }
932
            // for ckeditor we need to go deeper
933
            // istanbul ignore next
934
            if (iframe[0].contentWindow && iframe[0].contentWindow.CMS && iframe[0].contentWindow.CMS.CKEditor) {
935
                $(iframe[0].contentWindow.document).ready(function() {
936
                    // setTimeout is required to battle CKEditor initialisation
937
                    setTimeout(function() {
938
                        var editor = iframe[0].contentWindow.CMS.CKEditor.editor;
939

940
                        if (editor) {
941
                            editor.on('instanceReady', function(e) {
942
                                Modal._setupCtrlEnterSave(
943
                                    $(e.editor.container.$).find('iframe')[0].contentWindow.document
944
                                );
945
                            });
946
                        }
947
                    }, 100); // eslint-disable-line
948
                });
949
            }
950

951
            var saveSuccess = Boolean(contents.find('.messagelist :not(".error")').length);
26✔
952

953
            // in case message didn't appear, assume that admin page is actually a success
954
            // istanbul ignore if
955
            if (!saveSuccess) {
26✔
956
                saveSuccess =
957
                    Boolean(contents.find('.dashboard #content-main').length) &&
958
                    !contents.find('.messagelist .error').length;
959
            }
960

961
            // show messages in toolbar if provided
962
            messageList = contents.find('.messagelist');
26✔
963
            messages = messageList.find('li');
26✔
964
            if (messages.length) {
26✔
965
                CMS.API.Messages.open({
10✔
966
                    message: messages.eq(0).html()
967
                });
968
            }
969
            messageList.remove();
26✔
970

971
            // inject css class
972
            body.addClass('cms-admin cms-admin-modal');
26✔
973

974
            // hide loaders
975
            that.ui.modalBody.removeClass('cms-loader');
26✔
976
            hideLoader();
26✔
977

978
            // determine if we should close the modal or reload
979
            if (messages.length && that.enforceReload) {
26!
980
                that.ui.modalBody.addClass('cms-loader');
×
981
                showLoader();
×
982
                Helpers.reloadBrowser();
×
983
            }
984
            if (messages.length && that.enforceClose) {
26✔
985
                that.close();
1✔
986
                return false;
1✔
987
            }
988

989
            // adding django hacks
990
            contents.find('.viewsitelink').attr('target', '_top');
25✔
991

992
            // set modal buttons
993
            that._setButtons($(this));
25✔
994

995
            // when an error occurs, reset the saved status so the form can be checked and validated again
996
            if (
25✔
997
                contents.find('.errornote').length ||
74✔
998
                contents.find('.errorlist').length ||
999
                (that.saved && !saveSuccess)
1000
            ) {
1001
                that.saved = false;
3✔
1002
            }
1003

1004
            // when the window has been changed pressing the blue or red button, we need to run a reload check
1005
            // also check that no delete-confirmation is required
1006
            if (that.saved && saveSuccess && !contents.find('.delete-confirmation').length) {
25✔
1007
                that.ui.modalBody.addClass('cms-loader');
1✔
1008
                if (that.options.onClose) {
1!
1009
                    showLoader();
×
1010
                    Helpers.reloadBrowser(
×
1011
                        that.options.onClose ? that.options.onClose : window.location.href,
×
1012
                        false,
1013
                        true
1014
                    );
1015
                } else {
1016
                    // hello ckeditor
1017
                    Helpers.removeEventListener('modal-close.text-plugin');
1✔
1018
                    that.close();
1✔
1019
                    // Serve the data bridge:
1020
                    // We have a special case here cause the CMS namespace
1021
                    // can be either inside the current window or the parent
1022
                    const dataBridge = body[0].querySelector('script#data-bridge');
1✔
1023

1024
                    if (dataBridge) {
1!
1025
                        // the dataBridge is used to access plugin information from different resources
1026
                        // Do NOT move this!!!
1027
                        try {
×
1028
                            CMS.API.Helpers.dataBridge = JSON.parse(dataBridge.textContent);
×
1029
                            CMS.API.Helpers.onPluginSave();
×
1030
                        } catch {
1031
                            // istanbul ignore next
1032
                            Helpers.reloadBrowser();
1033
                        }
1034
                    }
1035
                }
1036
            } else {
1037
                if (that.ui.modal.hasClass('cms-modal-open')) {
24!
1038
                    // show modal if hidden
1039
                    that.ui.modal.show();
×
1040
                }
1041
                iframe.show();
24✔
1042
                // set title of not provided
1043
                innerTitle = contents.find('#content h1:eq(0)');
24✔
1044

1045
                // case when there is no prefix
1046
                // istanbul ignore next: never happens
1047
                if (opts.title === undefined && that.ui.titlePrefix.text() === '') {
1048
                    bc = contents.find('.breadcrumbs').contents();
1049
                    that.ui.titlePrefix.text(bc.eq(bc.length - 1).text().replace('›', '').trim());
1050
                }
1051

1052
                if (titlePrefix.text().trim() === '') {
24✔
1053
                    titlePrefix.text(innerTitle.text());
23✔
1054
                } else {
1055
                    titleSuffix.text(innerTitle.text());
1✔
1056
                }
1057
                innerTitle.remove();
24✔
1058

1059
                // than show
1060
                iframe.css('visibility', 'visible');
24✔
1061

1062
                // append ready state
1063
                iframe.data('ready', true);
24✔
1064

1065
                // attach close event
1066
                body.on('keydown.cms', function(e) {
24✔
1067
                    if (e.keyCode === KEYS.ESC && that.options.closeOnEsc) {
3✔
1068
                        e.stopPropagation();
2✔
1069
                        if (that._confirmDirtyEscCancel()) {
2✔
1070
                            that._cancelHandler();
1✔
1071
                        }
1072
                    }
1073
                });
1074

1075
                // figure out if .object-tools is available
1076
                if (contents.find('.object-tools').length) {
24✔
1077
                    contents.find('#content').css('padding-top', 38); // eslint-disable-line
8✔
1078
                }
1079

1080
                // this is required for IE11. we assume that when the modal is opened the user is going to interact
1081
                // with it. if we don't focus the body directly the next time the user clicks on a field inside
1082
                // the iframe the focus will be stolen by body thus requiring two clicks. this immediately focuses the
1083
                // iframe body on load except if something is already focused there
1084
                // (django tries to focus first field by default)
1085
                setTimeout(() => {
24✔
1086
                    if (!iframe[0] || !iframe[0].contentDocument || !iframe[0].contentDocument.documentElement) {
23✔
1087
                        return;
22✔
1088
                    }
1089
                    if ($(iframe[0].contentDocument.documentElement).find(':focus').length) {
1!
1090
                        return;
×
1091
                    }
1092
                    iframe.trigger('focus');
1✔
1093
                }, 0);
1094
            }
1095

1096
            that._attachContentPreservingHandlers(iframe);
25✔
1097
        });
1098

1099
        // inject
1100
        holder.html(iframe);
30✔
1101
    }
1102

1103
    /**
1104
     * Adds handlers to prevent accidental refresh / modal close
1105
     * that could lead to loss of data.
1106
     *
1107
     * @method _attachContentPreservingHandlers
1108
     * @private
1109
     * @param {jQuery} iframe
1110
     */
1111
    _attachContentPreservingHandlers(iframe) {
1112
        var that = this;
26✔
1113

1114
        that.tracker = new ChangeTracker(iframe);
26✔
1115

1116
        Helpers._getWindow().addEventListener('beforeunload', this._beforeUnloadHandler);
26✔
1117
    }
1118

1119
    /**
1120
     * @method _beforeUnloadHandler
1121
     * @private
1122
     * @param {Event} e
1123
     * @returns {String|void}
1124
     */
1125
    _beforeUnloadHandler(e) {
1126
        if (this.tracker.isFormChanged()) {
3✔
1127
            e.returnValue = CMS.config.lang.confirmDirty;
2✔
1128
            return e.returnValue;
2✔
1129
        }
1130
    }
1131

1132
    /**
1133
     * Similar functionality as in `_attachContentPreservingHandlers` but for canceling
1134
     * the modal with the ESC button.
1135
     *
1136
     * @method _confirmDirtyEscCancel
1137
     * @private
1138
     * @returns {Boolean}
1139
     */
1140
    _confirmDirtyEscCancel() {
1141
        if (this.tracker && this.tracker.isFormChanged()) {
6✔
1142
            return Helpers.secureConfirm(CMS.config.lang.confirmDirty + '\n\n' + CMS.config.lang.confirmDirtyESC);
2✔
1143
        }
1144
        return true;
4✔
1145
    }
1146

1147
    /**
1148
     * Version where the modal loads an url within an iframe.
1149
     *
1150
     * @method _changeIframe
1151
     * @private
1152
     * @param {jQuery} el originated element
1153
     * @returns {Boolean|void}
1154
     */
1155
    _changeIframe(el) {
1156
        if (el.hasClass('active')) {
4✔
1157
            return false;
1✔
1158
        }
1159

1160
        var parents = el.parent().find('a');
3✔
1161

1162
        parents.removeClass('active');
3✔
1163
        el.addClass('active');
3✔
1164
        this._loadIframe({
3✔
1165
            url: el.attr('href')
1166
        });
1167
        this.ui.titlePrefix.text(el.text());
3✔
1168
    }
1169

1170
    /**
1171
     * Version where the modal loads html markup.
1172
     *
1173
     * @method _loadMarkup
1174
     * @private
1175
     * @param {Object} opts
1176
     * @param {String|HTMLNode|jQuery} opts.html html markup to render
1177
     * @param {String} opts.title modal window main title (bold)
1178
     * @param {String} [opts.subtitle] modal window secondary title (normal)
1179
     */
1180
    _loadMarkup(opts) {
1181
        this.ui.modal.removeClass('cms-modal-iframe');
30✔
1182
        this.ui.modal.addClass('cms-modal-markup');
30✔
1183
        this.ui.modalBody.removeClass('cms-loader');
30✔
1184

1185
        // set content
1186
        // empty to remove events, append to keep events
1187
        this.ui.frame.empty().append(opts.html);
30✔
1188
        this.ui.titlePrefix.text(opts.title || '');
30✔
1189
        this.ui.titleSuffix.text(opts.subtitle || '');
30✔
1190
        trap(this.ui.frame[0]);
30✔
1191
    }
1192

1193
    /**
1194
     * Called whenever default modal action is canceled.
1195
     *
1196
     * @method _cancelHandler
1197
     * @private
1198
     */
1199
    _cancelHandler() {
1200
        this.options.onClose = null;
8✔
1201
        this.close();
8✔
1202
    }
1203

1204
    /**
1205
     * Sets up keyup/keydown listeners so you're able to save whatever you're
1206
     * editing inside of an iframe by pressing `ctrl + enter` on windows and `cmd + enter` on mac.
1207
     *
1208
     * It only works with default button (e.g. action), not the `delete` button,
1209
     * even though sometimes it's the only actionable button in the modal.
1210
     *
1211
     * @method _setupCtrlEnterSave
1212
     * @private
1213
     * @static
1214
     * @param {HTMLElement} doc document element (iframe or parent window);
1215
     */
1216
    static _setupCtrlEnterSave(doc) {
1217
        var cmdPressed = false;
6✔
1218
        var mac = navigator.platform.toLowerCase().indexOf('mac') + 1;
6✔
1219

1220
        $(doc)
6✔
1221
            .on('keydown.cms.submit', function(e) {
1222
                if (e.ctrlKey && e.keyCode === KEYS.ENTER && !mac) {
22✔
1223
                    $('.cms-modal-buttons .cms-btn-action:first').trigger('click');
1✔
1224
                }
1225

1226
                if (mac) {
22✔
1227
                    if (e.keyCode === KEYS.CMD_LEFT || e.keyCode === KEYS.CMD_RIGHT || e.keyCode === KEYS.CMD_FIREFOX) {
14✔
1228
                        cmdPressed = true;
6✔
1229
                    }
1230

1231
                    if (e.keyCode === KEYS.ENTER && cmdPressed) {
14✔
1232
                        $('.cms-modal-buttons .cms-btn-action:first').trigger('click');
3✔
1233
                    }
1234
                }
1235
            })
1236
            .on('keyup.cms.submit', function(e) {
1237
                if (mac) {
22✔
1238
                    if (e.keyCode === KEYS.CMD_LEFT || e.keyCode === KEYS.CMD_RIGHT || e.keyCode === KEYS.CMD_FIREFOX) {
14✔
1239
                        cmdPressed = false;
6✔
1240
                    }
1241
                }
1242
            });
1243
    }
1244
}
1245

1246
Modal.options = {
1✔
1247
    onClose: false,
1248
    closeOnEsc: true,
1249
    minHeight: 400,
1250
    minWidth: 800,
1251
    modalDuration: 200,
1252
    resizable: true,
1253
    maximizable: true,
1254
    minimizable: true
1255
};
1256

1257
export default Modal;
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2025 Coveralls, Inc