@qooxdoo/framework/source/class/qx/ui/progressive/structure/Default.js

The JS Framework for Coders

/* ************************************************************************

   qooxdoo - the new era of web development

   http://qooxdoo.org

   Copyright:
     2008 Derrell Lipman

   License:
     MIT: https://opensource.org/licenses/MIT
     See the LICENSE file in the project's top-level directory for details.

   Authors:
     * Derrell Lipman (derrell)

************************************************************************ */

/**
 * Structure definition for Progressive
 */
qx.Class.define("qx.ui.progressive.structure.Default", {
  extend: qx.ui.progressive.structure.Abstract,

  /**
   * The default structure for use by Progressive.  It includes a header, a
   * footer, and a pane.
   *
   * @param header {qx.ui.progressive.headfoot.Abstract|null}
   *   The heading to apply to the Progressive structure.  If null, then no
   *   header will be visible.
   *
   * @param footer {qx.ui.progressive.headfoot.Abstract|null}
   *   The footer to apply to the Progressive structure.  If null then no
   *   footer will be visible.
   *
   * @param pane {qx.ui.core.Widget|null}
   *   The container to use as the pane, applied to the Progressive
   *   structure.  If null, a qx.ui.core.Widget will be instantiated for
   *   use as the pane.
   */
  construct(header, footer, pane) {
    super(pane);

    // If no header was specified, use null header
    if (!header) {
      this.__nullHeader = new qx.ui.progressive.headfoot.Null();
      this.__header = this.__nullHeader;
    } else {
      this.__nullHeader = null;
      this.__header = header;
    }

    // If no footer was specified, use a null footer
    if (!footer) {
      this.__nullFooter = new qx.ui.progressive.headfoot.Null();
      this.__footer = this.__nullFooter;
    } else {
      this.__nullFooter = null;
      this.__footer = footer;
    }
  },

  members: {
    __header: null,
    __footer: null,
    __nullHeader: null,
    __nullFooter: null,

    // overridden
    applyStructure(progressive) {
      // Tell the header/footer components who their Progressive is
      this.__header.join(progressive);
      this.__footer.join(progressive);

      // Add the header, pane, and footer to the Progressive.
      progressive.add(this.__header);
      progressive.add(this.getPane(), { flex: 1 });
      progressive.add(this.__footer);
    },

    /**
     * Return the header
     *
     * @return {qx.ui.progressive.headfoot.Abstract}
     */
    getHeader() {
      return this.__header;
    },

    /**
     * Return the footer
     *
     * @return {qx.ui.progressive.headfoot.Abstract}
     */
    getFooter() {
      return this.__footer;
    }
  },

  destruct() {
    if (this.__nullHeader) {
      this.__nullHeader.dispose();
      this.__nullHeader = null;
    }

    if (this.__nullFooter) {
      this.__nullFooter.dispose();
      this.__nullFooter = null;
    }

    this.__header = this.__footer = null;
  }
});