wikimedia/mediawiki-core

View on GitHub
resources/src/mediawiki.Upload.Dialog.js

Summary

Maintainability
A
2 hrs
Test Coverage
( function () {

    /**
     * @classdesc Controls a {@link mw.Upload.BookletLayout BookletLayout}.
     *
     * ## Usage
     *
     * To use, set up a {@link OO.ui.WindowManager window manager} like for normal
     * dialogs:
     * ```
     * var uploadDialog = new mw.Upload.Dialog();
     * var windowManager = new OO.ui.WindowManager();
     * $( document.body ).append( windowManager.$element );
     * windowManager.addWindows( [ uploadDialog ] );
     * windowManager.openWindow( uploadDialog );
     * ```
     *
     * The dialog's closing promise can be used to get details of the upload.
     *
     * If you want to use a different {@link OO.ui.BookletLayout}, for example the
     * {@link mw.ForeignStructuredUpload.BookletLayout}, like in the case of the upload
     * interface in VisualEditor, you can pass it in through the `bookletClass` config option:
     * ```
     * var uploadDialog = new mw.Upload.Dialog( {
     *     bookletClass: mw.ForeignStructuredUpload.BookletLayout
     * } );
     * ```
     *
     * @class mw.Upload.Dialog
     * @extends OO.ui.ProcessDialog
     *
     * @constructor
     * @description Create an instance of `mw.Upload.Dialog`.
     * @param {Object} [config] Configuration options
     * @param {Function} [config.bookletClass=mw.Upload.BookletLayout] Booklet class to be
     *     used for the steps
     * @param {Object} [config.booklet] Booklet constructor configuration
     */
    mw.Upload.Dialog = function ( config ) {
        // Config initialization
        config = $.extend( {
            bookletClass: mw.Upload.BookletLayout
        }, config );

        // Parent constructor
        mw.Upload.Dialog.super.call( this, config );

        // Initialize
        this.bookletClass = config.bookletClass;
        this.bookletConfig = config.booklet;
    };

    /* Setup */

    OO.inheritClass( mw.Upload.Dialog, OO.ui.ProcessDialog );

    /* Static Properties */

    /**
     * @inheritdoc
     * @property {string} name
     */
    mw.Upload.Dialog.static.name = 'mwUploadDialog';

    /**
     * @inheritdoc
     * @property {Function|string} title
     */
    mw.Upload.Dialog.static.title = mw.msg( 'upload-dialog-title' );

    /**
     * @inheritdoc
     * @property {Object[]} actions
     */
    mw.Upload.Dialog.static.actions = [
        {
            flags: 'safe',
            action: 'cancel',
            label: mw.msg( 'upload-dialog-button-cancel' ),
            modes: [ 'upload', 'insert' ]
        },
        {
            flags: 'safe',
            action: 'cancelupload',
            label: mw.msg( 'upload-dialog-button-back' ),
            modes: [ 'info' ]
        },
        {
            flags: [ 'primary', 'progressive' ],
            label: mw.msg( 'upload-dialog-button-done' ),
            action: 'insert',
            modes: 'insert'
        },
        {
            flags: [ 'primary', 'progressive' ],
            label: mw.msg( 'upload-dialog-button-save' ),
            action: 'save',
            modes: 'info'
        },
        {
            flags: [ 'primary', 'progressive' ],
            label: mw.msg( 'upload-dialog-button-upload' ),
            action: 'upload',
            modes: 'upload'
        }
    ];

    /* Methods */

    /**
     * @ignore
     * @inheritdoc
     */
    mw.Upload.Dialog.prototype.initialize = function () {
        // Parent method
        mw.Upload.Dialog.super.prototype.initialize.call( this );

        this.uploadBooklet = this.createUploadBooklet();
        this.uploadBooklet.connect( this, {
            set: 'onUploadBookletSet',
            uploadValid: 'onUploadValid',
            infoValid: 'onInfoValid'
        } );

        this.$body.append( this.uploadBooklet.$element );
    };

    /**
     * Create an upload booklet.
     *
     * @protected
     * @return {mw.Upload.BookletLayout} An upload booklet
     */
    mw.Upload.Dialog.prototype.createUploadBooklet = function () {
        // eslint-disable-next-line new-cap
        return new this.bookletClass( $.extend( {
            $overlay: this.$overlay
        }, this.bookletConfig ) );
    };

    /**
     * @ignore
     * @inheritdoc
     */
    mw.Upload.Dialog.prototype.getBodyHeight = function () {
        return 600;
    };

    /**
     * Handle panelNameSet events from the upload booklet.
     *
     * @protected
     * @param {OO.ui.PageLayout} page Current page
     */
    mw.Upload.Dialog.prototype.onUploadBookletSet = function ( page ) {
        this.actions.setMode( page.getName() );
        this.actions.setAbilities( { upload: false, save: false } );
    };

    /**
     * Handle uploadValid events.
     *
     * {@link OO.ui.ActionSet#setAbilities Sets abilities}
     * for the dialog accordingly.
     *
     * @protected
     * @param {boolean} isValid The panel is complete and valid
     */
    mw.Upload.Dialog.prototype.onUploadValid = function ( isValid ) {
        this.actions.setAbilities( { upload: isValid } );
    };

    /**
     * Handle infoValid events.
     *
     * {@link OO.ui.ActionSet#setAbilities Sets abilities}
     * for the dialog accordingly.
     *
     * @protected
     * @param {boolean} isValid The panel is complete and valid
     */
    mw.Upload.Dialog.prototype.onInfoValid = function ( isValid ) {
        this.actions.setAbilities( { save: isValid } );
    };

    /**
     * @ignore
     * @inheritdoc
     */
    mw.Upload.Dialog.prototype.getSetupProcess = function ( data ) {
        return mw.Upload.Dialog.super.prototype.getSetupProcess.call( this, data )
            .next( function () {
                return this.uploadBooklet.initialize();
            }, this );
    };

    /**
     * @ignore
     * @inheritdoc
     */
    mw.Upload.Dialog.prototype.getActionProcess = function ( action ) {
        var dialog = this;

        if ( action === 'upload' ) {
            return new OO.ui.Process( this.uploadBooklet.uploadFile() );
        }
        if ( action === 'save' ) {
            return new OO.ui.Process( this.uploadBooklet.saveFile() );
        }
        if ( action === 'insert' ) {
            return new OO.ui.Process( function () {
                dialog.close( dialog.upload );
            } );
        }
        if ( action === 'cancel' ) {
            return new OO.ui.Process( this.close().closed );
        }
        if ( action === 'cancelupload' ) {
            return new OO.ui.Process( this.uploadBooklet.initialize() );
        }

        return mw.Upload.Dialog.super.prototype.getActionProcess.call( this, action );
    };

    /**
     * @ignore
     * @inheritdoc
     */
    mw.Upload.Dialog.prototype.getTeardownProcess = function ( data ) {
        return mw.Upload.Dialog.super.prototype.getTeardownProcess.call( this, data )
            .next( function () {
                this.uploadBooklet.clear();
            }, this );
    };
}() );