mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/VisualEditor
synced 2024-11-15 18:39:52 +00:00
a56e795f58
Objectives: * Split ve.Surface into ve.Editor and ve.ui.Surface * Move actions, triggers and commands to ve.ui * Move toolbar wrapping, floating, shadow and actions functionality to configurable options of ve.ui.Toolbar * Make ve.ce.Surface and ve.ui.Surface inherit ve.Element and use this.$$ for iframe friendliness * Make the toolbar separately initialized so it's possible to have a surface without one, as well as control where the toolbar is Some change notes: VisualEditor.php * Added standalone module for mediawiki integrated unit testing ve.ce.Surface.js * Remove requirement to pass in an attached container to construct object * Inherit ve.Element and use this.$$ instead of $ * Make getSelectionRect iframe friendly * Move most of the initialize stuff to a new initialize method to be called after the surface is attached to the DOM ve.init.mw.ViewPageTarget.js * Merge toolbar functions into setup/teardown methods * Add toolbar manually (since it's not added by the surface anymore) ve.init.sa.Target.js * Update new init procedure for editor, surface and toolbar separately * Move toolbar floating stuff to ve.Toolbar Change-Id: If91a9d6e76a8be8d1b5a2566394765a37d29a8a7
109 lines
2.8 KiB
JavaScript
109 lines
2.8 KiB
JavaScript
/*!
|
|
* VisualEditor user interface PagedDialog class.
|
|
*
|
|
* @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt
|
|
* @license The MIT License (MIT); see LICENSE.txt
|
|
*/
|
|
|
|
/**
|
|
* Paged dialog.
|
|
*
|
|
* A paged dialog has an outline in the left third, and a series of pages in the right two-thirds.
|
|
* Pages can be added using the #addPage method, and later accessed using `this.pages[name]` or
|
|
* through the #getPage method.
|
|
*
|
|
* @class
|
|
* @abstract
|
|
* @extends ve.ui.Dialog
|
|
*
|
|
* @constructor
|
|
* @param {ve.ui.Surface} surface
|
|
*/
|
|
ve.ui.PagedDialog = function VeUiPagedDialog( surface ) {
|
|
// Parent constructor
|
|
ve.ui.Dialog.call( this, surface );
|
|
|
|
// Properties
|
|
this.pages = {};
|
|
};
|
|
|
|
/* Inheritance */
|
|
|
|
ve.inheritClass( ve.ui.PagedDialog, ve.ui.Dialog );
|
|
|
|
/* Methods */
|
|
|
|
/**
|
|
* Handle frame ready events.
|
|
*
|
|
* @method
|
|
*/
|
|
ve.ui.PagedDialog.prototype.initialize = function () {
|
|
// Call parent method
|
|
ve.ui.Dialog.prototype.initialize.call( this );
|
|
|
|
// Properties
|
|
this.outlinePanel = new ve.ui.PanelLayout( { '$$': this.$$, 'scroll': true } );
|
|
this.pagesPanel = new ve.ui.StackPanelLayout( { '$$': this.$$ } );
|
|
this.layout = new ve.ui.GridLayout(
|
|
[this.outlinePanel, this.pagesPanel], { '$$': this.$$, 'widths': [1, 2] }
|
|
);
|
|
this.outlineWidget = new ve.ui.OutlineWidget( { '$$': this.$$ } );
|
|
|
|
// Events
|
|
this.outlineWidget.connect( this, { 'select': 'onOutlineSelect' } );
|
|
|
|
// Initialization
|
|
this.outlinePanel.$.append( this.outlineWidget.$ ).addClass( 've-ui-pagedDialog-outlinePanel' );
|
|
this.pagesPanel.$.addClass( 've-ui-pagedDialog-pagesPanel' );
|
|
this.$body.append( this.layout.$ );
|
|
};
|
|
|
|
/**
|
|
* Handle outline select events.
|
|
*
|
|
* @method
|
|
* @param {ve.ui.OptionWidget} item Selected item
|
|
*/
|
|
ve.ui.PagedDialog.prototype.onOutlineSelect = function ( item ) {
|
|
if ( item ) {
|
|
this.pagesPanel.showItem( this.pages[item.getData()] );
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Add a page to the dialog.
|
|
*
|
|
* @method
|
|
* @param {string} name Symbolic name of page
|
|
* @param {jQuery|string} [label] Page label
|
|
* @param {string} [icon] Symbolic name of icon
|
|
* @chainable
|
|
*/
|
|
ve.ui.PagedDialog.prototype.addPage = function ( name, label, icon ) {
|
|
var config = { '$$': this.$$, 'icon': icon, 'label': label || name };
|
|
|
|
// Create and add page panel and outline item
|
|
this.pages[name] = new ve.ui.PanelLayout( config );
|
|
this.pagesPanel.addItems( [this.pages[name]] );
|
|
this.outlineWidget.addItems( [ new ve.ui.OutlineItemWidget( name, config ) ] );
|
|
|
|
// Auto-select first item when nothing is selected yet
|
|
if ( !this.outlineWidget.getSelectedItem() ) {
|
|
this.outlineWidget.selectItem( this.outlineWidget.getClosestSelectableItem( 0 ) );
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Get a page by name.
|
|
*
|
|
* @method
|
|
* @param {string} name Symbolic name of page
|
|
* @returns {ve.ui.PanelLayout|undefined} Page, if found
|
|
*/
|
|
ve.ui.PagedDialog.prototype.getPage = function ( name ) {
|
|
return this.pages[name];
|
|
};
|