mediawiki-extensions-Visual.../modules/ve/ui/tools/ve.ui.DialogButtonTool.js
Trevor Parscal 6b5310c562 ve.ui.ViewRegistry annihilation
Objectives:
* Associate models with tools, rather than dialogs and inspectors
* Move tool/model association utilities to ve.ui.ToolFactory
* Obliterate the view registry

Notes:

The only special case for leaving modelClasses definitions in place is
for the linkInspector. It uses these for selection expansion.
Because tools can now override the static canEditModel method, we can
dynamically evaluate a model, rather than be restricted to only
comparing classes. This will be useful for disabling editors for models
that are for some reason incomplete or otherwise broken and cannot be
safely edited.

Change-Id: I7adf254990112d90f1f808593a9111afc7a116b5
2013-06-26 16:52:10 -07:00

81 lines
1.8 KiB
JavaScript

/*!
* VisualEditor UserInterface DialogButtonTool class.
*
* @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* UserInterface dialog button tool.
*
* @abstract
* @class
* @extends ve.ui.ButtonTool
* @constructor
* @param {ve.ui.Toolbar} toolbar
* @param {Object} [config] Config options
*/
ve.ui.DialogButtonTool = function VeUiDialogButtonTool( toolbar, config ) {
// Parent constructor
ve.ui.ButtonTool.call( this, toolbar, config );
};
/* Inheritance */
ve.inheritClass( ve.ui.DialogButtonTool, ve.ui.ButtonTool );
/* Static Properties */
/**
* Symbolic name of dialog the button opens.
*
* @abstract
* @static
* @property
* @type {string}
* @inheritable
*/
ve.ui.DialogButtonTool.static.dialog = '';
/**
* Annotation or node models this tool is related to.
*
* Used by #canEditModel.
*
* @static
* @property {Function[]}
*/
ve.ui.DialogButtonTool.static.modelClasses = [];
/**
* @inheritdoc
*/
ve.ui.DialogButtonTool.static.canEditModel = function ( model ) {
return ve.isInstanceOfAny( model, this.modelClasses );
};
/* Methods */
/**
* Handle the button being clicked.
*
* @method
*/
ve.ui.DialogButtonTool.prototype.onClick = function () {
this.toolbar.getSurface().getDialogs().open( this.constructor.static.dialog );
};
/**
* Handle the toolbar state being updated.
*
* @method
* @param {ve.dm.Node[]} nodes List of nodes covered by the current selection
* @param {ve.dm.AnnotationSet} full Annotations that cover all of the current selection
* @param {ve.dm.AnnotationSet} partial Annotations that cover some or all of the current selection
*/
ve.ui.DialogButtonTool.prototype.onUpdateState = function ( nodes ) {
if ( nodes.length ) {
this.setActive( ve.ui.toolFactory.getToolForNode( nodes[0] ) === this.constructor );
}
};