/** * Panel is a container that has specific functionality and structural components that make it * the perfect building block for application-oriented user interfaces. * * Panels are, by virtue of their inheritance from {@link Ext.container.Container}, capable of being * configured with a {@link Ext.container.Container#layout layout}, and containing child Components. * * When either specifying child {@link #cfg-items} of a Panel, or dynamically * {@link Ext.container.Container#method-add adding} Components to a Panel, remember to consider * how you wish the Panel to arrange those child elements, and whether those child elements * need to be sized using one of Ext's built-in `{@link Ext.container.Container#layout layout}` * schemes. By default, Panels use the {@link Ext.layout.container.Auto Auto} scheme. This simply * renders child components, appending them one after the other inside the Container, * and **does not apply any sizing** at all. * * {@img Ext.panel.Panel/panel.png Panel components} * * A Panel may also contain {@link #bbar bottom} and {@link #tbar top} toolbars, along with separate * {@link Ext.panel.Header header}, {@link #fbar footer} and body sections. * * Panel also provides built-in {@link #collapsible collapsible, expandable} and {@link #closable} * behavior. Panels can be easily dropped into any {@link Ext.container.Container Container} * or layout, and the layout and rendering pipeline is * {@link Ext.container.Container#method-add completely managed by the framework}. * * **Note:** By default, the `{@link #closable close}` header tool _destroys_ the Panel resulting * in removal of the Panel and the destruction of any descendant Components. This makes the Panel * object, and all its descendants **unusable**. To enable the close tool to simply _hide_ a Panel * for later re-use, configure the Panel with `{@link #closeAction closeAction}: 'hide'`. * * Usually, Panels are used as constituents within an application, in which case, they would be used * as child items of Containers, and would themselves use Ext.Components as child * {@link #cfg-items}. However to illustrate simply rendering a Panel into the document, * here's how to do it: * * @example * Ext.create('Ext.panel.Panel', { * title: 'Hello', * width: 200, * html: '<p>World!</p>', * renderTo: Ext.getBody() * }); * * A more realistic scenario is a Panel created to house input fields which will not be rendered, * but used as a constituent part of a Container: * * @example * var filterPanel = Ext.create('Ext.panel.Panel', { * bodyPadding: 5, // Don't want content to crunch against the borders * width: 300, * title: 'Filters', * items: [{ * xtype: 'datefield', * fieldLabel: 'Start date' * }, { * xtype: 'datefield', * fieldLabel: 'End date' * }], * renderTo: Ext.getBody() * }); * * Note that the Panel above is configured to render into the document and assigned a size. * In a real world scenario, the Panel will often be added inside a Container which will use a * {@link #layout} to render, size and position its child Components. * * Panels will often use specific {@link #layout}s to provide an application with shape * and structure by containing and arranging child Components: * * @example * var resultsPanel = Ext.create('Ext.panel.Panel', { * title: 'Results', * width: 600, * height: 400, * renderTo: Ext.getBody(), * layout: { * type: 'vbox', // Arrange child items vertically * align: 'stretch', // Each takes up full width * padding: 5 * }, * items: [{ * // Results grid specified as a config object with an xtype of 'grid' * xtype: 'grid', * // One header just for show. There's no data * columns: [{header: 'Column One'}], * store: Ext.create('Ext.data.ArrayStore', {}), // A dummy empty data store * // Use 1/3 of Container's height (hint to Box layout) * flex: 1 * }, { * xtype: 'splitter' // A splitter between the two child items * }, { * // Details Panel specified as a config object (no xtype defaults to 'panel'). * title: 'Details', * bodyPadding: 5, * items: [{ * fieldLabel: 'Data item', * xtype: 'textfield' * }], // An array of form fields * flex: 2 // Use 2/3 of Container's height (hint to Box layout) * }] * }); * * The example illustrates one possible method of displaying search results. The Panel contains * a grid with the resulting data arranged in rows. Each selected row may be displayed in detail * in the Panel below. The {@link Ext.layout.container.VBox vbox} layout is used to arrange * the two vertically. It is configured to stretch child items horizontally to full width. * Child items may either be configured with a numeric height, or with a `flex` value to distribute * available space proportionately. * * This Panel itself may be a child item of, for example, a {@link Ext.tab.Panel} which * will size its child items to fit within its content area. * * Using these techniques, as long as the **layout** is chosen and configured correctly, * an application may have any level of nested containment, all dynamically sized according to * configuration, the user's preference and available * browser size. */Ext.define('Ext.panel.Panel', { extend: 'Ext.container.Container', alias: 'widget.panel', alternateClassName: 'Ext.Panel', requires: [ 'Ext.panel.Header', 'Ext.util.MixedCollection', 'Ext.toolbar.Toolbar', 'Ext.fx.Anim', 'Ext.panel.DD', 'Ext.XTemplate', 'Ext.layout.component.Dock', 'Ext.util.Memento' ], mixins: { docking: 'Ext.container.DockingContainer' }, /** * @cfg childEls * @inheritdoc */ childEls: [ 'bodyWrap', 'body' ], /* eslint-disable indent, max-len */ /** * @cfg renderTpl * @inheritdoc */ renderTpl: [ // headingEl can also be inserted in updateHeader '<tpl if="headingText">', '<div id="{id}-headingEl" data-ref="headingEl" role="heading"', ' class="', Ext.baseCSSPrefix, 'hidden-clip" style="height:0">', '{headingText}', '</div>', '</tpl>', '<tpl if="hasTabGuard">{% this.renderTabGuard(out, values, \'before\'); %}</tpl>', '<div id="{id}-bodyWrap" data-ref="bodyWrap" class="{baseCls}-bodyWrap"', '<tpl if="bodyWrapAriaAttributes">', '<tpl foreach="bodyWrapAriaAttributes"> {$}="{.}"</tpl>', '<tpl else>', ' role="presentation"', '</tpl>', '>', // If this Panel is framed, the framing template renders the docked items round the frame '{% this.renderDockedItems(out,values,0); %}', '<div id="{id}-body" data-ref="body" class="{baseCls}-body<tpl if="bodyCls"> {bodyCls}</tpl>', ' {baseCls}-body-{ui}<tpl if="uiCls">', '<tpl for="uiCls"> {parent.baseCls}-body-{parent.ui}-{.}</tpl>', '</tpl>{childElCls}"', '<tpl if="bodyAriaAttributes">', '<tpl foreach="bodyAriaAttributes"> {$}="{.}"</tpl>', '<tpl else>', ' role="presentation"', '</tpl>', '<tpl if="bodyStyle"> style="{bodyStyle}"</tpl>>', '{%this.renderContainer(out,values);%}', '</div>', '{% this.renderDockedItems(out,values,1); %}', '</div>', '<tpl if="hasTabGuard">{% this.renderTabGuard(out, values, \'after\'); %}</tpl>' ], /* eslint-enable indent, max-len */ // <editor-fold desc="Config"> // *********************************************************************************** // Begin Config // *********************************************************************************** // For performance reasons we give the following configs their default values on // the class body. This prevents the updaters from running on initialization in the // default configuration scenario headerPosition: 'top', iconAlign: 'left', titleAlign: 'left', titleRotation: 'default', titlePosition: 0, headerConfigs: { glyph: 1, icon: 1, iconAlign: 1, iconCls: 1, title: 1, titleAlign: 1, titlePosition: 1, titleRotation: 1 }, beforeRenderConfig: { /** * @cfg glyph * @inheritdoc Ext.panel.Header#cfg-glyph * @accessor */ glyph: null, /** * @cfg {'top'/'bottom'/'left'/'right'} [headerPosition='top'] * Specify as `'top'`, `'bottom'`, `'left'` or `'right'`. * @accessor */ headerPosition: null, /** * @cfg icon * @inheritdoc Ext.panel.Header#cfg-icon * @accessor */ icon: null, /** * @cfg [iconAlign='left'] * @inheritdoc Ext.panel.Header#cfg-iconAlign * @accessor */ iconAlign: null, /** * @cfg iconCls * @inheritdoc Ext.panel.Header#cfg-iconCls * @accessor */ iconCls: null, /** * @cfg title * @inheritdoc Ext.panel.Header#cfg-title * @localdoc When a `title` is specified, the {@link Ext.panel.Header} will * automatically be created and displayed unless {@link #header} is set to `false`. * @accessor */ title: null, /** * @cfg [titleAlign='left'] * @inheritdoc Ext.panel.Header#cfg-titleAlign * @accessor */ titleAlign: null, /** * @cfg [titlePosition=0] * @inheritdoc Ext.panel.Header#cfg-titlePosition * @accessor * @since 6.5.1 */ titlePosition: null, /** * @cfg [titleRotation='default'] * @inheritdoc Ext.panel.Header#cfg-titleRotation * @accessor */ titleRotation: null }, /** * @cfg {Boolean/Number} animCollapse * `true` to animate the transition when the panel is collapsed, `false` to skip the animation * (defaults to `true` if the {@link Ext.fx.Anim} class is available, otherwise `false`). * May also be specified as the animation duration in milliseconds. */ animCollapse: Ext.enableFx, /** * @cfg {Boolean} bodyBorder * A shortcut to add or remove the border on the body of a panel. In the classic theme * this only applies to a panel which has the {@link #frame} configuration set to `true`. * @since 2.3.0 */ /** * @cfg {String/String[]} bodyCls * A CSS class, space-delimited string of classes, or array of classes to be applied * to the panel's body element. The following examples are all valid: * * bodyCls: 'foo' * bodyCls: 'foo bar' * bodyCls: ['foo', 'bar'] */ /** * @cfg {Number/String} [bodyPadding=undefined] * A shortcut for setting a padding style on the body element. The value can either be * a number to be applied to all sides, or a normal css string describing padding. */ /** * @cfg {String/Object/Function} bodyStyle * Custom CSS styles to be applied to the panel's body element, which can be supplied * as a valid CSS style string, an object containing style property name/value pairs * or a function that returns such a string or object. * For example, these two formats are interpreted to be equivalent: * * bodyStyle: 'background:#ffc; padding:10px;' * * bodyStyle: { * background: '#ffc', * padding: '10px' * } * * @since 2.3.0 */ /** * @cfg {Boolean} border * Specify as `false` to render the Panel with zero width borders. * * Leaving the value as `true` uses the selected theme's * {@link Ext.panel.Panel#$panel-border-width} * * Defaults to `false` when using or extending Neptune. * * **Note:** is ignored when {@link #frame} is set to **true**. */ border: true, /** * @cfg {Boolean} closable * True to display the 'close' tool button and allow the user to close the window, * false to hide the button and disallow closing the window. * * By default, when close is requested by clicking the close button in the header, * the {@link #method-close} method will be called. This will * _{@link Ext.Component#method-destroy destroy}_ the Panel and its content * meaning that it may not be reused. * * To make closing a Panel _hide_ the Panel so that it may be reused, set {@link #closeAction} * to 'hide'. * @accessor */ closable: false, /** * @cfg {String} closeAction * The action to take when the close header tool is clicked: * * - **`'{@link #method-destroy}'`** : * * {@link #method-remove remove} the window from the DOM and * {@link Ext.Component#method-destroy destroy} it and all descendant Components. * The window will **not** be available to be redisplayed via the {@link #method-show} method. * * - **`'{@link #method-hide}'`** : * * {@link #method-hide} the window by setting visibility to hidden and applying negative * offsets. The window will be available to be redisplayed via the {@link #method-show} * method. * * **Note:** This behavior has changed! setting *does* affect the {@link #method-close} method * which will invoke the appropriate closeAction. */ closeAction: 'destroy', /** * @cfg {String} closeToolText * Text to be announced by screen readers when the **close** * {@link Ext.panel.Tool tool} is focused. Will also be set as the close tool's * {@link Ext.panel.Tool#cfg-tooltip tooltip} text. * * **Note:** Applicable when the panel is {@link #closable}: true * @locale */ closeToolText: 'Close panel', /** * @cfg {Boolean} collapsed * `true` to render the panel collapsed, `false` to render it expanded. */ collapsed: false, /** * @cfg {String} collapsedCls * A CSS class to add to the panel's element after it has been collapsed. */ collapsedCls: 'collapsed', /** * @cfg {String} collapseDirection * The direction to collapse the Panel when the toggle button is clicked. * * Defaults to the {@link #cfg-headerPosition} * * **Important: This config is _ignored_ for {@link #collapsible} Panels which are direct child * items of a {@link Ext.layout.container.Border border layout}.** * * Specify as `'top'`, `'bottom'`, `'left'` or `'right'`. */ /** * @cfg {Boolean} collapseFirst * `true` to make sure the collapse/expand toggle button always renders first (to the left of) * any other tools in the panel's title bar, `false` to render it last. */ collapseFirst: true, /** * @cfg {Boolean} collapsible * True to make the panel collapsible and have an expand/collapse toggle Tool added * into the header tool button area. False to keep the panel sized either statically, * or by an owning layout manager, with no toggle Tool. * When a panel is used in a {@link Ext.layout.container.Border border layout}, the * {@link #floatable} option can influence the behavior of collapsing. * See {@link #collapseMode} and {@link #collapseDirection} */ collapsible: undefined, /** * @cfg {String} collapseMode * **Important: this config is only effective for {@link #collapsible} Panels which are direct * child items of a {@link Ext.layout.container.Border border layout}.** * * When _not_ a direct child item of a {@link Ext.layout.container.Border border layout}, * then the Panel's header remains visible, and the body is collapsed to zero dimensions. * If the Panel has no header, then a new header (orientated correctly depending on the * {@link #collapseDirection}) will be inserted to show a the title and a re-expand tool. * * When a child item of a {@link Ext.layout.container.Border border layout}, this config * has three possible values: * * - `undefined` - When collapsed, a placeholder {@link Ext.panel.Header Header} is injected * into the layout to represent the Panel and to provide a UI with a Tool to allow the user * to re-expand the Panel. * * - `"header"` - The Panel collapses to leave its header visible as when not inside a * {@link Ext.layout.container.Border border layout}. * * - `"mini"` - The Panel collapses without a visible header. */ /** * @cfg {String} collapseToolText * Text to be announced by screen readers when **collapse** * {@link Ext.panel.Tool tool} is focused. Will also be set as the collapse tool's * {@link Ext.panel.Tool#cfg-tooltip tooltip} text. * * **Note:** Applicable when the panel is {@link #collapsible}: true * @locale */ collapseToolText: 'Collapse panel', /** * @cfg {String} expandToolText * Text to be announced by screen readers when **expand** {@link Ext.panel.Tool tool} * is focused. Will also be set as the expand tool's * {@link Ext.panel.Tool#cfg-tooltip tooltip} text. * * **Note:** Applicable when the panel is {@link #collapsible}: true * @locale */ expandToolText: 'Expand panel', /** * @cfg {Boolean} constrain * True to constrain the panel within its containing element, false to allow it to fall outside * of its containing element. By default floating components such as Windows will be rendered to * `document.body`. To render and constrain the window within another element specify * {@link #renderTo}. Optionally the header only can be constrained using * {@link #constrainHeader}. */ constrain: false, /** * @cfg {Boolean} constrainHeader * True to constrain the panel header within its containing element (allowing the panel body * to fall outside of its containing element) or false to allow the header to fall outside * its containing element. * Optionally the entire panel can be constrained using {@link #constrain}. */ constrainHeader: false, // @cmd-auto-dependency {aliasPrefix: "widget.", typeProperty: "xtype"} /** * @cfg {Object/Object[]} dockedItems * A component or series of components to be added as docked items to this panel. The docked * items can be docked to either the top, right, left or bottom of a panel. This is typically * used for things like toolbars or tab bars: * * var panel = new Ext.panel.Panel({ * dockedItems: [{ * xtype: 'toolbar', * dock: 'top', * items: [{ * text: 'Docked to the top' * }] * }] * }); */ dockedItems: null, /** * @cfg {String} buttonAlign * The alignment of any buttons added to this panel. Valid values are 'right', 'left' * and 'center' (defaults to 'right' for buttons/fbar, 'left' for other toolbar types). * * **NOTE:** The preferred way to specify toolbars is to use the dockedItems config. * Instead of buttonAlign you would add the layout: { pack: 'start' | 'center' | 'end' } option * to the dockedItem config. */ // @cmd-auto-dependency {aliasPrefix: "widget.", typeProperty: "xtype", defaultType: "toolbar"} /** * @cfg {Object/Object[]} tbar * Convenience config. Short for 'Top Bar'. * * tbar: [ * { xtype: 'button', text: 'Button 1' } * ] * * is equivalent to * * dockedItems: [{ * xtype: 'toolbar', * dock: 'top', * items: [ * { xtype: 'button', text: 'Button 1' } * ] * }] */ tbar: null, // @cmd-auto-dependency {aliasPrefix: "widget.", typeProperty: "xtype", defaultType: "toolbar"} /** * @cfg {Object/Object[]} bbar * Convenience config. Short for 'Bottom Bar'. * * bbar: [ * { xtype: 'button', text: 'Button 1' } * ] * * is equivalent to * * dockedItems: [{ * xtype: 'toolbar', * dock: 'bottom', * items: [ * { xtype: 'button', text: 'Button 1' } * ] * }] */ bbar: null, // @cmd-auto-dependency {aliasPrefix: "widget.", typeProperty: "xtype", defaultType: "toolbar"} /** * @cfg {Object/Object[]} fbar * Convenience config used for adding items to the bottom of the panel. Short for Footer Bar. * * fbar: [ * { type: 'button', text: 'Button 1' } * ] * * is equivalent to * * dockedItems: [{ * xtype: 'toolbar', * dock: 'bottom', * ui: 'footer', * defaults: { * minWidth: 200 * }, * items: [ * { xtype: 'component', flex: 1 }, * { xtype: 'button', text: 'Button 1' } * ] * }] * * The {@link #minButtonWidth} is used as the default * {@link Ext.button.Button#minWidth minWidth} for each of the buttons in the fbar. */ fbar: null, // @cmd-auto-dependency {aliasPrefix: "widget.", typeProperty: "xtype", defaultType: "toolbar"} /** * @cfg {Object/Object[]} lbar * Convenience config. Short for 'Left Bar' (left-docked, vertical toolbar). * * lbar: [ * { xtype: 'button', text: 'Button 1' } * ] * * is equivalent to * * dockedItems: [{ * xtype: 'toolbar', * dock: 'left', * items: [ * { xtype: 'button', text: 'Button 1' } * ] * }] */ lbar: null, // @cmd-auto-dependency {aliasPrefix: "widget.", typeProperty: "xtype", defaultType: "toolbar"} /** * @cfg {Object/Object[]} rbar * Convenience config. Short for 'Right Bar' (right-docked, vertical toolbar). * * rbar: [ * { xtype: 'button', text: 'Button 1' } * ] * * is equivalent to * * dockedItems: [{ * xtype: 'toolbar', * dock: 'right', * items: [ * { xtype: 'button', text: 'Button 1' } * ] * }] */ rbar: null, /** * @cfg {Object[]} buttons * Convenience config used for adding buttons docked to the bottom of the panel. This is a * synonym for the {@link #fbar} config. * * buttons: [ * { text: 'Button 1' } * ] * * is equivalent to * * dockedItems: [{ * xtype: 'toolbar', * dock: 'bottom', * ui: 'footer', * defaults: { * minWidth: 200 * }, * items: [ * { xtype: 'component', flex: 1 }, * { xtype: 'button', text: 'Button 1' } * ] * }] * * The {@link #minButtonWidth} is used as the default * {@link Ext.button.Button#minWidth minWidth} for each of the buttons in the buttons toolbar. */ buttons: null, /** * @cfg draggable * @inheritdoc * @localdoc **NOTE:** The private {@link Ext.panel.DD} class is used instead of * ComponentDragger when {@link #simpleDrag} is false (_default_). In this case you * may pass a config for {@link Ext.dd.DragSource}. * * See also {@link #dd}. */ /** * @cfg {Boolean} floatable * **Important: This config is only effective for {@link #collapsible} Panels which are direct * child items of a {@link Ext.layout.container.Border border layout}.** * * true to allow clicking a collapsed Panel's {@link #placeholder} to display the Panel floated * above the layout, false to force the user to fully expand a collapsed region by clicking * the expand button to see it again. */ floatable: true, /** * @cfg {Boolean} frame * True to apply a frame to the panel. * * **Note:** `frame: true` overrides {@link #border border:false} */ frame: false, /** * @cfg {Boolean} frameHeader * True to apply a frame to the panel panels header (if 'frame' is true). */ frameHeader: true, /** * @cfg {Boolean/Object} header * Pass as `false` to prevent a Header from being created and shown. * * Pass as a config object (optionally containing an `xtype`) to custom-configure this Panel's * header. * * See {@link Ext.panel.Header} for all the options that may be specified here. * * A {@link Ext.panel.Header panel header} is a {@link Ext.container.Container} which contains * the Panel's {@link #title} and {@link #tools}. You may also configure the Panel's `header` * option with its own child items which go *before* the {@link #tools} * * By default the panel {@link #title} is inserted after items configured in this config, * but before any tools. To insert the title at any point in the full array, specify the * {@link Ext.panel.Header#cfg-titlePosition titlePosition} config: * * new Ext.panel.Panel({ * title: 'Test', * tools: [{ * type: 'refresh' * }, { * type: 'help' * }], * titlePosition: 2 // Title will come AFTER the two tools * ... * }); * */ /** * @cfg {String} headerOverCls * Optional CSS class to apply to the header element on mouseover */ /** * @cfg {Boolean} hideCollapseTool * `true` to hide the expand/collapse toggle button when `{@link #collapsible} == true`, * `false` to display it. */ hideCollapseTool: false, /** * @cfg {Boolean} [manageHeight=true] When true, the dock component layout writes * height information to the panel's DOM elements based on its shrink wrap height * calculation. This ensures that the browser respects the calculated height. * When false, the dock component layout will not write heights on the panel or its * body element. In some simple layout cases, not writing the heights to the DOM may * be desired because this allows the browser to respond to direct DOM manipulations * (like animations). */ manageHeight: true, /** * @cfg {String} maskElement * * The name of the element property in this Panel to mask when masked by a LoadMask. * * Defaults to `"el"` to indicate that any LoadMask should be rendered into this Panel's * encapsulating element. * * This could be configured to be `"body"` so that only the body is masked and toolbars * and the header are still mouse-accessible. */ maskElement: 'el', /** * @cfg {Number} minButtonWidth * Minimum width of all footer toolbar buttons in pixels. If set, this will be used * as the default value for the {@link Ext.button.Button#minWidth} config of each Button * added to the **footer toolbar** via the {@link #fbar} or {@link #buttons} configurations. * It will be ignored for buttons that have a minWidth configured some other way, * e.g. in their own config object or via the {@link Ext.container.Container#defaults defaults} * of their parent container. */ minButtonWidth: 75, /** * @cfg {Boolean} overlapHeader * True to overlap the header in a panel over the framing of the panel itself. This is needed * when `frame: true` (and is done automatically for you). Otherwise it is undefined. * If you manually add rounded corners to a panel header which does not have `frame: true`, * this will need to be set to true. */ /** * @cfg {Ext.Component/Object} placeholder * **Important: This config is only effective for {@link #collapsible} Panels which are direct * child items of a {@link Ext.layout.container.Border border layout} when not using * the `'header'` {@link #collapseMode}.** * * **Optional.** A Component (or config object for a Component) to show in place of this Panel * when this Panel is collapsed by a {@link Ext.layout.container.Border border layout}. * Defaults to a generated {@link Ext.panel.Header Header} containing a * {@link Ext.panel.Tool Tool} to re-expand the Panel. */ /** * @cfg {Number} [placeholderCollapseHideMode=Ext.Element.VISIBILITY] * The {@link Ext.dom.Element#setVisibilityMode mode} for hiding collapsed panels when * using {@link #collapseMode} "placeholder". */ // placeholderCollapseHideMode: Ext.Element.VISIBILITY, /** * @cfg {Boolean} preventHeader * @deprecated 4.1.0 Use {@link #header} instead. * Prevent a Header from being created and shown. */ preventHeader: false, /** * @cfg {Boolean} maintainTitlePosition * For panels that are collapsed to the left or right, * {@link Ext.panel.Header#titlePosition} may be temporarily changed for UI consistency. * Setting this config to true will force the specified titlePosition to be maintained * @since 6.5.1 */ maintainTitlePosition: false, /** * @cfg [shrinkWrap=2] * @inheritdoc * @localdoc ##Panels (subclasses and instances) * * By default, when a panel is configured to shrink wrap in a given dimension, only * the panel's "content" (items and html content inside the panel body) contributes * to its size, and the content of docked items is ignored. Optionally you can use * the {@link #shrinkWrapDock} config to allow docked items to contribute to the * panel's size as well. For example, if shrinkWrap and shrinkWrapDock are both set * to true, the width of the panel would be the width of the panel's content and the * panel's header text. */ /** * @cfg {Boolean/Number} shrinkWrapDock * Allows for this panel to include the {@link #dockedItems} when trying to determine * the overall size of the panel. This option is only applicable when this panel is * also shrink wrapping in the same dimensions. See {@link Ext.Panel#shrinkWrap} for * an explanation of the configuration options. */ shrinkWrapDock: false, /** * @cfg {Boolean} [simpleDrag=false] * When {@link #cfg-draggable} is `true`, Specify this as `true` to cause the `draggable` * config to work the same as it does in {@link Ext.window.Window Window}. This Panel * just becomes movable. No DragDrop instances receive any notifications. * For example: * * @example * var win = Ext.create('widget.window', { * height: 300, * width: 300, * title: 'Constraining Window', * closable: false, * items: { * title: "Floating Panel", * width: 100, * height: 100, * floating: true, * draggable: true, * constrain: true, * simpleDrag: true * } * }); * win.show(); * // Floating components begin life hidden * win.child('[title=Floating Panel]').show(); * */ /** * @cfg stateEvents * @inheritdoc Ext.state.Stateful#cfg-stateEvents * @localdoc By default the following stateEvents are added: * * - {@link #event-resize} - _(added by Ext.Component)_ * - {@link #event-collapse} * - {@link #event-expand} */ /** * @cfg {Boolean} titleCollapse * `true` to allow expanding and collapsing the panel (when `{@link #collapsible} = true`) * by clicking anywhere in the header bar, `false`) to allow it only by clicking to tool * button). When a panel is used in a {@link Ext.layout.container.Border border layout}, * the {@link #floatable} option can influence the behavior of collapsing. */ titleCollapse: undefined, /** * @cfg {Object[]/Ext.panel.Tool[]} tools * An array of {@link Ext.panel.Tool} configs/instances to be added to the header tool area. * The tools are stored as child components of the header container. They can be accessed using * {@link #down} and {#query}, as well as the other component methods. The toggle tool * is automatically created if {@link #collapsible} is set to true. * * Note that, apart from the toggle tool which is provided when a panel is collapsible, * these tools only provide the visual button. Any required functionality must be provided * by adding handlers that implement the necessary behavior. * * Example usage: * * tools: [{ * type:'refresh', * tooltip: 'Refresh form Data', * // hidden:true, * handler: function(event, toolEl, panelHeader) { * // refresh logic * } * }, * { * type:'help', * tooltip: 'Get Help', * callback: function(panel, tool, event) { * // show help here * } * }] * * The difference between `handler` and `callback` is the signature. For details on * the distinction, see {@link Ext.panel.Tool}. */ /** * @cfg {String} defaultButton * Reference name of the component to act as the default button for this Panel. * Default button is activated by pressing Enter key while focus is contained within * the Panel's {@link #defaultButtonTarget}. * * The most obvious use for `defaultButton` is submitting a form: * * var loginWindow = new Ext.window.Window({ * autoShow: true, * width: 300, * layout: 'form', * title: 'Enter login information', * referenceHolder: true, * defaultFocus: 'textfield', * defaultButton: 'okButton', * * items: [{ * xtype: 'textfield', * fieldLabel: 'User name' * }, { * xtype: 'textfield', * fieldLabel: 'Password' * }], * * buttons: [{ * reference: 'okButton', * text: 'Login', * handler: function() { * Ext.Msg.alert('Submit', 'Your login is being processed'); * } * }] * }); */ /** * @cfg {String} [defaultButtonTarget] Name of the element that will be the target of * {@link #defaultButton} keydown listener. The default element is Panel body, which * means that pressing Enter key while focus is on docked items will not fire `defaultButton` * action. * * If you want `defaultButton` action to fire in docked items, set this config to `"el"`. */ // *********************************************************************************** // End Config // *********************************************************************************** // </editor-fold> // <editor-fold desc="Properties"> // *********************************************************************************** // Begin Properties // *********************************************************************************** /** * @cfg baseCls * @inheritdoc */ baseCls: Ext.baseCSSPrefix + 'panel', /** * @property {Ext.dom.Element} body * The Panel's body {@link Ext.dom.Element Element} which may be used to contain HTML content. * The content may be specified in the {@link #html} config, or it may be loaded using the * {@link #loader} config. Read-only. * * If this is used to load visible HTML elements in either way, then * the Panel may not be used as a Layout for hosting nested Panels. * * If this Panel is intended to be used as the host of a Layout (See {@link #cfg!layout} * then the body Element must not be loaded or changed - it is under the control * of the Panel's Layout. * * @readonly */ bodyPosProps: { x: 'x', y: 'y' }, /** * @cfg componentLayout * @inheritdoc */ componentLayout: 'dock', /** * @property contentPaddingProperty * @inheritdoc */ contentPaddingProperty: 'bodyPadding', emptyArray: [], /** * @property {Boolean} isPanel * `true` in this class to identify an object as an instantiated Panel, or subclass thereof. */ isPanel: true, /** * @property defaultBindProperty * @inheritdoc */ defaultBindProperty: 'title', // *********************************************************************************** // End Properties // *********************************************************************************** // </editor-fold> // <editor-fold desc="Events"> // *********************************************************************************** // Begin Events // *********************************************************************************** /** * @event beforeclose * Fires before the user closes the panel. Return false from any listener to stop * the close event being fired * @param {Ext.panel.Panel} panel The Panel object */ /** * @event beforecollapse * Fires before this panel is collapsed. Return false to prevent the collapse. * @param {Ext.panel.Panel} p The Panel being collapsed. * @param {String} direction . The direction of the collapse. One of * * - Ext.Component.DIRECTION_TOP * - Ext.Component.DIRECTION_RIGHT * - Ext.Component.DIRECTION_BOTTOM * - Ext.Component.DIRECTION_LEFT * * @param {Boolean} animate True if the collapse is animated, else false. */ /** * @event beforeexpand * Fires before this panel is expanded. Return false to prevent the expand. * @param {Ext.panel.Panel} p The Panel being expanded. * @param {Boolean} animate True if the expand is animated, else false. */ /** * @event close * Fires when the user closes the panel. * @param {Ext.panel.Panel} panel The Panel object */ /** * @event collapse * Fires after this Panel has collapsed. * @param {Ext.panel.Panel} p The Panel that has been collapsed. */ /** * @event expand * Fires after this Panel has expanded. * @param {Ext.panel.Panel} p The Panel that has been expanded. */ /** * @event float * Fires after a collapsed Panel has been "floated" by clicking on * it's header. Only applicable when the Panel is an item in a * {@link Ext.layout.container.Border Border Layout}. */ /** * @event glyphchange * Fired when the Panel glyph has been changed by the {@link #setGlyph} method. * @param {Ext.panel.Panel} this * @param {Number/String} newGlyph * @param {Number/String} oldGlyph */ /** * @event iconalignchange * Fires after the Panel iconAlign has been set or changed. * @param {Ext.panel.Panel} this The Panel which has the iconAlign changed. * @param {String} newIconAlign * @param {String} oldIconAlign * @since 6.5.1 */ /** * @event iconchange * Fires after the Panel icon has been set or changed. * @param {Ext.panel.Panel} this The Panel which has the icon changed. * @param {String} newIcon The path to the new icon image. * @param {String} oldIcon The path to the previous panel icon image. */ /** * @event iconclschange * Fires after the Panel iconCls has been set or changed. * @param {Ext.panel.Panel} this The Panel which has the iconCls changed. * @param {String} newIconCls The new iconCls. * @param {String} oldIconCls The previous panel iconCls. */ /** * @event titlealignchange * Fires after the Panel titleAlign has been set or changed. * @param {Ext.panel.Panel} this the Panel which has the titleAlign changed. * @param {String} newTitleAlign * @param {String} oldTitleAlign * @since 6.5.1 */ /** * @event titlechange * Fires after the Panel title has been set or changed. * @param {Ext.panel.Panel} this the Panel which has been resized. * @param {String} newTitle The new title. * @param {String} oldTitle The previous panel title. */ /** * @event titlepositionchange * Fires after the Panel titlePosition has been set or changed. * @param {Ext.panel.Panel} this the Panel which has the titlePosition changed. * @param {String} newTitlePosition * @param {String} oldTitlePosition * @since 6.5.1 */ /** * @event titlerotationchange * Fires after the Panel titleRotation has been set or changed. * @param {Ext.panel.Panel} this the Panel which has the titleRotation changed. * @param {String} newTitleRotation * @param {String} oldTitleRotation * @since 6.5.1 */ /** * @event unfloat * Fires after a "floated" Panel has returned to it's collapsed state * as a result of the mouse leaving the Panel. Only applicable when * the Panel is an item in a * {@link Ext.layout.container.Border Border Layout}. */ // *********************************************************************************** // End Events // *********************************************************************************** // </editor-fold> // <editor-fold desc="Component Methods"> // *********************************************************************************** // Begin Methods // *********************************************************************************** /** * Adds a CSS class to the body element. If not rendered, the class will * be added when the panel is rendered. * @param {String/String[]} cls The class to add * @return {Ext.panel.Panel} this */ addBodyCls: function(cls) { var me = this, body = me.rendered ? me.body : me.getProtoBody(); body.addCls(cls); return me; }, /** * Add tools to this panel {@link Ext.panel.Header header} * * panel.addTool({ * type: 'gear', * handler: function() { * // .... * } * }); * * panel.addTool([{ * type: 'gear', * handler: 'viewControllerGearMethod' * }, { * type: 'save', * handler: 'viewControllerSaveMethod' * }]); * * By default the tools will be accessible via keyboard, with the exception of * automatically added collapse/expand and close tools. * * If you implement keyboard equivalents of your tools' actions elsewhere and do not * want the tools to participate in keyboard navigation, you can make them * presentational instead: * * panel.addTool({ * type: 'mytool', * focusable: false, * ariaRole: 'presentation' * // ... * }); * * @param {Object/Object[]/Ext.panel.Tool/Ext.panel.Tool[]} tools The tool or tools to * add. */ addTool: function(tools) { if (!Ext.isArray(tools)) { tools = [tools]; } // eslint-disable-next-line vars-on-top var me = this, header = me.header, len = tools.length, curTools = me.tools, t, tool; if (!header || !header.isHeader) { header = null; if (!curTools) { me.tools = curTools = []; } } for (t = 0; t < len; t++) { tool = tools[t]; if (typeof tool !== 'string' && !tool.isTool) { tool = Ext.apply({}, tool); } tool.toolOwner = me; if (header) { header.addTool(tool); } else { // only modify the tools array if the header isn't created, // otherwise, defer to the header to manage curTools.push(tool); } } me.updateHeader(); }, /** * @method * @protected * @template * Template method to be implemented in subclasses to add their tools after * the collapsible tool. */ addTools: Ext.emptyFn, getClosable: function() { return this.closable; }, setClosable: function(closable) { var me = this, tab = me.tab; closable = !!closable; if (me.closable !== closable) { me.closable = closable; if (tab) { tab.setClosable(closable); } } }, setCollapsible: function(collapsible) { var me = this, current = me.collapsible, collapseTool = me.collapseTool; me.collapsible = collapsible; if (collapsible && !current) { me.updateCollapseTool(); collapseTool = me.collapseTool; if (collapseTool) { collapseTool.show(); } } else if (!collapsible && current) { if (collapseTool) { collapseTool.hide(); } } }, /** * @method addUIClsToElement * @inheritdoc */ addUIClsToElement: function(cls) { var me = this, result = me.callParent(arguments); me.addBodyCls([Ext.baseCSSPrefix + cls, me.baseCls + '-body-' + cls, me.baseCls + '-body-' + me.ui + '-' + cls]); return result; }, /** * Invoked after the Panel is Collapsed. * * @param {Boolean} animated * * @template * @protected */ afterCollapse: function(animated) { var me = this, ownerLayout = me.ownerLayout; me.isCollapsingOrExpanding = 0; me.updateCollapseTool(); // The x-animating-size class sets overflow:hidden so that overflowing // content is clipped during animation. if (animated) { me.removeCls(Ext.baseCSSPrefix + 'animating-size'); } if (ownerLayout) { ownerLayout.afterCollapse(me, animated); } me.setHiddenDocked(); me.fireEvent('collapse', me); }, /** * Invoked after the Panel is Expanded. * * @param {Boolean} animated * * @template * @protected */ afterExpand: function(animated) { var me = this, ownerLayout = me.ownerLayout; me.isCollapsingOrExpanding = 0; me.updateCollapseTool(); // The x-animating-size class sets overflow:hidden so that overflowing // content is clipped during animation. if (animated) { me.removeCls(Ext.baseCSSPrefix + 'animating-size'); } if (ownerLayout) { ownerLayout.afterExpand(me, animated); } me.fireEvent('expand', me); me.fireHierarchyEvent('expand'); }, doDestroy: function() { var me = this; if (me.slideOutTask) { me.slideOutTask.cancel(); } Ext.destroy( me.placeholder, me.ghostPanel, me.dd, me.accordionHeaderKeyNav, me.accordionBodyKeyNav, me.defaultButtonKeyNav ); me.destroyDockedItems(); me.callParent(); }, beforeRender: function() { var me = this, wasCollapsed; // Ensure the protoBody exists so that initOverflow gets right answer from getOverflowEl. // If this Panel was applied to an existing element (such as being used as a Viewport) // then it will not have been created. me.getProtoBody(); me.callParent(); // Add class-specific header tools. // Panel adds collapsible and closable. me.initTools(); // Dock the header/title unless we are configured specifically not to create a header. // If the panel participates in a border layout it should have the ARIA role of 'region'. // In that case we need to render a heading element even if the panel is configured // not to have a header. if (!(me.preventHeader || (me.header === false)) || me.isViewportBorderChild) { me.updateHeader(); } me.afterHeaderInit = true; // If we are rendering collapsed, we still need to save and modify various configs if (me.collapsed) { if (me.isPlaceHolderCollapse()) { if (!me.hidden) { me.setHiddenState(true); // This will insert the placeholder Component into the ownerCt's // child collection. // Its getRenderTree call which is calling this will then iterate again and // recreate the child items array to include the new Component. // Prevent the first collapse from firing me.preventCollapseFire = true; me.placeholderCollapse(); delete me.preventCollapseFire; wasCollapsed = me.collapsed; // Temporarily clear the flag so that the header is rendered // with a collapse tool in it. // Placeholder collapse panels never really collapse, they just hide. // The tool is always a collapse tool. me.collapsed = false; } } else { me.beginCollapse(); me.addClsWithUI(me.collapsedCls); } } // Restore the flag if we are being rendered initially placeholder collapsed. if (wasCollapsed) { me.collapsed = wasCollapsed; } }, /** * @private * Memento Factory method * @param {String} name Name of the Memento (used as prefix for named Memento) */ getMemento: function(name) { var me = this; if (name && typeof name === 'string') { name += 'Memento'; return me[name] || (me[name] = new Ext.util.Memento(me)); } }, /** * @private * Called before the change from default, configured state into the collapsed state. * This method may be called at render time to enable rendering in an initially collapsed state, * or at runtime when an existing, fully laid out Panel may be collapsed. * It basically saves configs which need to be clobbered for the duration of the collapsed * state. */ beginCollapse: function() { var me = this, lastBox = me.lastBox, rendered = me.rendered, collapseMemento = me.getMemento('collapse'), sizeModel = me.getSizeModel(), header = me.header, reExpander; // When we collapse a panel, the panel is in control of one dimension (depending on // collapse direction) and sets that on the component. We must restore the user's // original value (including non-existence) when we expand. Using this technique, we // mimic setCalculatedSize for the dimension we do not control and setSize for the // one we do (only while collapsed). // Additionally, the panel may have a shrink wrapped width and/or height. For shrinkWrapped // panels this can be problematic, since a collapsed, shrink-wrapped panel has no way // of determining its width (or height if the collapse direction is horizontal). It is // therefore necessary to capture both the width and height regardless of collapse direction // This allows us to set a configured width or height on the panel when it is collapsed, // and it will be restored to an unconfigured-width shrinkWrapped state on expand. collapseMemento.capture(['height', 'minHeight', 'width', 'minWidth']); if (lastBox) { collapseMemento.capture(me.restoreDimension(), lastBox, 'last.'); } // If the panel has a shrinkWrapped height/width and is already rendered, configure // its width/height as its calculated width/height, so that the collapsed header // will have the same width or height as the panel did before it was collapsed. // If the shrinkWrapped panel has not yet been rendered, as will be the case when a panel // is initially configured with collapsed:true, we attempt to use the configured // width/height, and fall back to minWidth or minHeight if width/height has not been // configured, and fall back to a value of 100 if a minWidth/minHeight has not been // configured. if (me.collapsedVertical()) { if (sizeModel.width.shrinkWrap) { me.width = rendered ? me.getWidth() : me.width || me.minWidth || 100; } delete me.height; me.minHeight = 0; } else if (me.collapsedHorizontal()) { if (sizeModel.height.shrinkWrap) { me.height = rendered ? me.getHeight() : me.height || me.minHeight || 100; } delete me.width; me.minWidth = 0; } if (me.ownerCt) { me.ownerCt.getLayout().beginCollapse(me); } // Get a reExpander header. This will return the Panel Header if the Header // is in the correct orientation // If we are using the Header as the reExpander, change its UI to collapsed state if (!me.isPlaceHolderCollapse() && header !== false) { if (header === (reExpander = me.getReExpander())) { header.collapseImmune = true; header.getInherited().collapseImmune = true; header.addClsWithUI(me.getHeaderCollapsedClasses(header)); // Ensure that the reExpander has the correct framing applied. if (header.rendered) { header.updateFrame(); } } else if (reExpander.el) { // We're going to use a temporary reExpander: show it. reExpander.el.show(); reExpander.hidden = false; } } if (me.resizer) { me.resizer.disable(); } if (me.rendered) { me.ariaEl.dom.setAttribute('aria-expanded', false); // In accordion layout, panel body has the role of tabpanel // and needs to be updated accordingly when the panel is collapsed if (me.isAccordionPanel) { me.body.dom.setAttribute('aria-hidden', true); } } }, beginDrag: function() { if (this.floatingDescendants) { this.floatingDescendants.hide(); } }, beginExpand: function() { var me = this, lastBox = me.lastBox, collapseMemento = me.getMemento('collapse'), restoreDimension = me.restoreDimension(), header = me.header, reExpander; if (collapseMemento) { collapseMemento.restore(['minHeight', 'minWidth', restoreDimension]); if (lastBox) { collapseMemento.restore(restoreDimension, true, lastBox, 'last.'); } } if (me.ownerCt) { me.ownerCt.getLayout().beginExpand(me); } if (!me.isPlaceHolderCollapse() && header !== false) { // If we have been using our Header as the reExpander then restore the Header // to expanded UI if (header === (reExpander = me.getReExpander())) { delete header.collapseImmune; delete header.getInherited().collapseImmune; header.removeClsWithUI(me.getHeaderCollapsedClasses(header)); // Ensure that the reExpander has the correct framing applied. if (header.rendered) { header.expanding = true; header.updateFrame(); delete header.expanding; } } else { // We've been using a temporary reExpander: hide it. reExpander.hidden = true; reExpander.el.hide(); } } if (me.resizer) { me.resizer.enable(); } if (me.rendered) { me.ariaEl.dom.setAttribute('aria-expanded', true); // In accordion layout, panel body has the role of tabpanel // and needs to be updated accordingly when the panel is expanded if (me.isAccordionPanel) { me.body.dom.setAttribute('aria-hidden', false); } } }, bridgeToolbars: function() { var me = this, docked = [], minButtonWidth = me.minButtonWidth, fbar, fbarDefaults, fbarIsButtons; function initToolbar(toolbar, pos, useButtonAlign, disableFocusableContainer) { if (Ext.isArray(toolbar)) { toolbar = { xtype: 'toolbar', items: toolbar }; } else if (!toolbar.isComponent) { // Incoming toolbar config can be a property on the prototype toolbar = Ext.apply({}, toolbar); } if (!toolbar.xtype) { toolbar.xtype = 'toolbar'; } toolbar.dock = pos; if (disableFocusableContainer) { toolbar.focusableContainer = false; } // Legacy support for buttonAlign (only used by buttons/fbar) if (useButtonAlign) { toolbar.layout = Ext.apply({ // default to 'end' (right-aligned) if me.buttonAlign is undefined or invalid pack: { left: 'start', center: 'center' }[me.buttonAlign] || 'end' }, toolbar.layout); } return toolbar; } if (me.tbar) { docked.push(initToolbar(me.tbar, 'top')); me.tbar = null; } if (me.bbar) { docked.push(initToolbar(me.bbar, 'bottom')); me.bbar = null; } if (me.buttons) { me.fbar = me.buttons; me.buttons = null; fbarIsButtons = true; } if (me.fbar) { fbar = initToolbar(me.fbar, 'bottom', true, fbarIsButtons); // only we useButtonAlign fbar.ui = 'footer'; // Apply the minButtonWidth config to buttons in the toolbar if (minButtonWidth) { fbarDefaults = fbar.defaults; fbar.defaults = function(config) { var defaults = fbarDefaults || {}, // no xtype or a button instance isButton = !config.xtype || config.isButton, cls; // Here we have an object config with an xtype, check if it's a button // or a button subclass if (!isButton) { cls = Ext.ClassManager.getByAlias('widget.' + config.xtype); if (cls) { isButton = cls.prototype.isButton; } } if (isButton && !('minWidth' in defaults)) { defaults = Ext.apply({ minWidth: minButtonWidth }, defaults); } return defaults; }; } docked.push(fbar); me.fbar = null; } if (me.lbar) { docked.push(initToolbar(me.lbar, 'left')); me.lbar = null; } if (me.rbar) { docked.push(initToolbar(me.rbar, 'right')); me.rbar = null; } if (me.dockedItems) { if (me.dockedItems.isMixedCollection) { me.addDocked(docked); } else { if (!Ext.isArray(me.dockedItems)) { me.dockedItems = [me.dockedItems]; } me.dockedItems = me.dockedItems.concat(docked); } } else { me.dockedItems = docked; } }, /** * Closes the Panel. By default, this method, removes it from the DOM, * {@link Ext.Component#method-destroy destroy}s the Panel object and all its descendant * Components. The {@link #beforeclose beforeclose} event is fired before the * close happens and will cancel the close action if it returns false. * * **Note:** This method is also affected by the {@link #closeAction} setting. * For more explicit control use {@link #method-destroy} and {@link #method-hide} methods. */ close: function() { if (this.fireEvent('beforeclose', this) !== false) { this.doClose(); } }, /** * Collapses the panel body so that the body becomes hidden. Docked Components parallel * to the border towards which the collapse takes place will remain visible. Fires the * {@link #beforecollapse} event which will cancel the collapse action if it returns false. * * @param {String} [direction] The direction to collapse towards. Must be one of * * - Ext.Component.DIRECTION_TOP * - Ext.Component.DIRECTION_RIGHT * - Ext.Component.DIRECTION_BOTTOM * - Ext.Component.DIRECTION_LEFT * * Defaults to {@link #collapseDirection}. * * @param {Boolean/Number} [animate] True to animate the transition, else false * (defaults to the value of the {@link #animCollapse} panel config). May * also be specified as the animation duration in milliseconds. * @return {Ext.panel.Panel} this */ collapse: function(direction, animate) { var me = this, collapseDir = direction || me.collapseDirection, ownerCt = me.ownerCt, layout = me.ownerLayout, rendered = me.rendered; if (me.isCollapsingOrExpanding) { return me; } if (arguments.length < 2) { animate = me.animCollapse; } if (me.collapsed || me.fireEvent('beforecollapse', me, direction, animate) === false) { return me; } if (layout && layout.onBeforeComponentCollapse) { if (layout.onBeforeComponentCollapse(me) === false) { return me; } } if (rendered && ownerCt && me.isPlaceHolderCollapse()) { return me.placeholderCollapse(direction, animate); } me.collapsed = collapseDir; if (rendered) { me.beginCollapse(); } me.getInherited().collapsed = true; me.fireHierarchyEvent('collapse'); if (rendered) { me.doCollapseExpand(1, animate); } return me; }, collapsedHorizontal: function() { var dir = this.getCollapsed(); return dir === 'left' || dir === 'right'; }, collapsedVertical: function() { var dir = this.getCollapsed(); return dir === 'top' || dir === 'bottom'; }, /** * converts a collapsdDir into an anchor argument for Element.slideIn * overridden in rtl mode to switch "l" and "r" */ convertCollapseDir: function(collapseDir) { return collapseDir.substr(0, 1); }, createGhost: function(cls) { var me = this, header = me.header, frame = me.frame && !me.alwaysFramed; return { xtype: 'panel', hidden: false, header: header ? { titleAlign: header.getTitleAlign() } : null, ui: frame ? me.ui.replace(/-framed$/, '') : me.ui, id: me.id + '-ghost', renderTo: Ext.getBody(), // The ghost's opacity causes the resize handles to obscure the frame in // IE, so always force resizable to be false. resizable: false, // The ghost must not be draggable (the actual class instantiated // may be draggable in its prototype) draggable: false, // Tools are explicitly copied. closable: false, focusable: false, floating: true, alignOnScroll: false, shadow: false, frame: frame, shim: me.shim, alwaysFramed: me.alwaysFramed, overlapHeader: me.overlapHeader, headerPosition: me.getHeaderPosition(), titleRotation: me.getTitleRotation(), baseCls: me.baseCls, getRefOwner: function() { return me.getRefOwner(); }, cls: me.baseCls + '-ghost ' + (cls || '') }; }, createReExpander: function(direction, defaults) { var me = this, isLeft = direction === 'left', isRight = direction === 'right', isVertical = isLeft || isRight, ownerCt = me.ownerCt, header = me.header, result = Ext.apply({ hideMode: 'offsets', title: me.getTitle(), titleAlign: me.getTitleAlign(), titlePosition: me.getTitlePosition(), vertical: isVertical, textCls: me.headerTextCls, icon: me.getIcon(), iconCls: me.getIconCls(), iconAlign: me.getIconAlign(), glyph: me.getGlyph(), baseCls: me.self.prototype.baseCls + '-header', ui: me.ui, frame: me.frame && me.frameHeader, ignoreParentFrame: me.frame || me.overlapHeader, ignoreBorderManagement: me.frame || me.ignoreHeaderBorderManagement, indicateDrag: me.draggable, collapseImmune: true, ariaRole: me.ariaRole, preventRefocus: true, ownerCt: (ownerCt && me.collapseMode === 'placeholder') ? ownerCt : me, ownerLayout: me.componentLayout, forceOrientation: true, margin: me.margin, // When placeholder is focused, focus the expander tool. // TODO: When https://sencha.jira.com/browse/EXTJS-19718 is // fixed, this should not be needed. // placeholder is a FocusableContainer defaultFocus: 'tool[isDefaultExpandTool]' }, defaults); // If we're in mini mode, set the placeholder size to only 1px since // we don't need it to show up. if (me.collapseMode === 'mini') { if (isVertical) { result.width = 1; } else { result.height = 1; } } if (header) { Ext.apply(result, { focusableContainer: header.focusableContainer, activeChildTabIndex: header.activeChildTabIndex, inactiveChildTabIndex: header.inactiveChildTabIndex, allowFocusingDisabledChildren: header.allowFocusingDisabledChildren }); } // Create the re expand tool // For UI consistency reasons, collapse:left reExpanders, and region: 'west' placeHolders // have the re expand tool at the *top* with a bit of space. if (!me.hideCollapseTool) { if (!me.maintainTitlePosition && (isLeft || (isRight && me.isPlaceHolderCollapse()))) { // adjust the title position if the collapse tool needs to be at the // top of a vertical header result.titlePosition = 1; } result.tools = [{ xtype: 'tool', type: 'expand-' + me.getOppositeDirection(direction), isDefaultExpandTool: true, uiCls: ['top'], handler: me.toggleCollapse, scope: me, tooltip: me.expandToolText }]; } result = new Ext.panel.Header(result); result.addClsWithUI(me.getHeaderCollapsedClasses(result)); result.expandTool = result.down('tool[isDefaultExpandTool=true]'); return result; }, /** * @private */ doClose: function() { this.fireEvent('close', this); this[this.closeAction](); }, doCollapseExpand: function(flags, animate) { var me = this, originalAnimCollapse = me.animCollapse, ownerLayout = me.ownerLayout; // we need to temporarily set animCollapse to the animate value here because ContextItem // uses the animCollapse property to determine if the collapse/expand should be animated me.animCollapse = animate; // Flag used by the layout ContextItem to impose an animation policy based upon the // collapse direction and the animCollapse setting. me.isCollapsingOrExpanding = flags; // The x-animating-size class sets overflow:hidden so that overflowing // content is clipped during animation. if (animate) { me.addCls(Ext.baseCSSPrefix + 'animating-size'); } if (ownerLayout && !animate) { ownerLayout.onContentChange(me); } else { me.updateLayout({ isRoot: true }); } // set animCollapse back to its original value me.animCollapse = originalAnimCollapse; return me; }, endDrag: function() { if (this.floatingDescendants) { this.floatingDescendants.show(); } }, /** * Expands the panel body so that it becomes visible. Fires the {@link #beforeexpand} * event which will cancel the expand action if it returns false. * @param {Boolean} [animate] True to animate the transition, else false * (defaults to the value of the {@link #animCollapse} panel config). May * also be specified as the animation duration in milliseconds. * @return {Ext.panel.Panel} this */ expand: function(animate) { var me = this, layout = me.ownerLayout, rendered = me.rendered; if (me.isCollapsingOrExpanding) { return me; } if (!arguments.length) { animate = me.animCollapse; } if (!me.collapsed && !me.floatedFromCollapse) { return me; } if (me.fireEvent('beforeexpand', me, animate) === false) { return me; } if (layout && layout.onBeforeComponentExpand) { if (layout.onBeforeComponentExpand(me) === false) { return me; } } delete me.getInherited().collapsed; if (rendered && me.isPlaceHolderCollapse()) { return me.placeholderExpand(animate); } me.restoreHiddenDocked(); if (rendered) { me.beginExpand(); } me.collapsed = false; if (me.rendered) { me.doCollapseExpand(2, animate); } return me; }, findReExpander: function(direction) { var me = this, c = Ext.Component, dockedItems = me.dockedItems.items, dockedItemCount = dockedItems.length, comp, i; // never use the header if we're in collapseMode mini if (me.collapseMode === 'mini') { return; } switch (direction) { case c.DIRECTION_TOP: case c.DIRECTION_BOTTOM: // Attempt to find a reExpander Component (docked in a horizontal orientation) // Also, collect all other docked items which we must hide after collapse. for (i = 0; i < dockedItemCount; i++) { comp = dockedItems[i]; if (!comp.hidden) { if (comp.isHeader && (!comp.dock || comp.dock === 'top' || comp.dock === 'bottom')) { return comp; } } } break; case c.DIRECTION_LEFT: case c.DIRECTION_RIGHT: // Attempt to find a reExpander Component (docked in a vertical orientation) // Also, collect all other docked items which we must hide after collapse. for (i = 0; i < dockedItemCount; i++) { comp = dockedItems[i]; if (!comp.hidden) { if (comp.isHeader && (comp.dock === 'left' || comp.dock === 'right')) { return comp; } } } break; default: throw new Error('Panel#findReExpander must be passed a valid collapseDirection'); } }, floatCollapsedPanel: function() { var me = this, placeholder = me.placeholder, splitter = me.splitter, phBox = Ext.util.Region.from(placeholder.getBox(false, true)), floatCls = Ext.panel.Panel.floatCls, collapsed = me.collapsed, layoutOwner = me.ownerCt || me, slideDirection, myBox, hoverlisteners = { mouseleave: me.onMouseLeaveFloated, mouseenter: me.onMouseEnterFloated, scope: me, destroyable: true }; if (me.isSliding) { return; } // Already floated if (me.el.hasCls(floatCls)) { me.slideOutFloatedPanel(); return; } me.isSliding = true; // Lay out in fully expanded mode to ensure we are at the correct size, // and collect our expanded box placeholder.el.hide(); placeholder.hidden = true; me.el.show(); me.setHiddenState(false); me.collapsed = false; layoutOwner.updateLayout(); // Then go back immediately to collapsed state from which to initiate the float into view. placeholder.el.show(); placeholder.hidden = false; me.el.hide(); me.setHiddenState(true); me.collapsed = collapsed; layoutOwner.updateLayout(); myBox = me.getBox(false, true); if (me.fireEvent('beginfloat', me) === false) { return; } me.slideOutTask = me.slideOutTask || new Ext.util.DelayedTask(me.slideOutFloatedPanel, me); // Tap/mousedown/mousemove outside the floated element, its placeholder, // or its splitter slides it back. me.pointerLeaveListener = Ext.getDoc().on({ mousedown: me.onFloatedPointerEvent, mousemove: me.onFloatedPointerEvent, scope: me, destroyable: true }); if (!me.placeholderListener) { me.placeholderListener = placeholder.on({ resize: me.onPlaceholderResize, scope: me, destroyable: true }); } me.phHoverListeners = placeholder.el.on(hoverlisteners); me.elHoverListeners = me.el.on(hoverlisteners); me.el.addCls(floatCls); me.floated = collapsed; // Hide collapse tool in header if there is one (we might be headerless) if (me.collapseTool) { me.collapseTool.el.hide(); } if (splitter) { phBox = phBox.union(splitter.getBox(false, true)); } switch (me.collapsed) { case 'top': me.width = phBox.width; me.setLocalXY(myBox.x, myBox.y + phBox.height); break; case 'right': me.height = phBox.height; me.setLocalXY(myBox.x - phBox.width, myBox.y); break; case 'bottom': me.width = phBox.width; me.setLocalXY(myBox.x, myBox.y - phBox.height); break; case 'left': me.height = phBox.height; me.setLocalXY(myBox.x + phBox.width, myBox.y); break; } slideDirection = me.convertCollapseDir(me.collapsed); // Remember how we are really collapsed so we can restore it, but also so we can // become a layoutRoot while we are floated: me.floatedFromCollapse = me.collapsed; me.collapsed = false; me.setHiddenState(false); me.el.slideIn(slideDirection, { preserveScroll: true, duration: Ext.Number.from(me.animCollapse, Ext.fx.Anim.prototype.duration), listeners: { afteranimate: function() { me.isSliding = false; me.fireEvent('endfloat', me); me.fireEvent('float', me); } } }); }, onFloatedPointerEvent: function(event) { var me = this; // If any pointer event occurs inside the component tree, cancel any slideOut. // This includes if we are slid out and the pointer is inside the region // because locked grids have pointer-events: none to allow interaction with // the Y scroller below them. if (me.owns(