mediawiki-extensions-Visual.../modules/ve/ce/nodes/ve.ce.ListNode.js
Trevor Parscal 8d33a3de0d Major Documentation Cleanup
* Made method descriptions imperative: "Do this" rather than "Does this"
* Changed use of "this object" to "the object" in method documentation
* Added missing documentation
* Fixed incorrect documentation
* Fixed incorrect debug method names (as in those VeDmClassName tags we add to functions so they make sense when dumped into in the console)
* Normalized use of package names throughout
* Normalized class descriptions
* Removed incorrect @abstract tags
* Added missing @method tags
* Lots of other minor cleanup

Change-Id: I4ea66a2dd107613e2ea3a5f56ff54d675d72957e
2013-01-16 15:37:59 -08:00

101 lines
2.2 KiB
JavaScript

/*!
* VisualEditor ContentEditable ListNode class.
*
* @copyright 2011-2012 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* ContentEditable list node.
*
* @class
* @extends ve.ce.BranchNode
* @constructor
* @param {ve.dm.ListNode} model Model to observe
*/
ve.ce.ListNode = function VeCeListNode( model ) {
// Parent constructor
ve.ce.BranchNode.call( this, 'list', model, ve.ce.BranchNode.getDomWrapper( model, 'style' ) );
// Events
this.model.addListenerMethod( this, 'update', 'onUpdate' );
};
/* Inheritance */
ve.inheritClass( ve.ce.ListNode, ve.ce.BranchNode );
/* Static Properties */
/**
* Node rules.
*
* @see ve.ce.NodeFactory
* @static
* @property
*/
ve.ce.ListNode.rules = {
'canBeSplit': false
};
/**
* Mapping of list style values and DOM wrapper element types.
*
* @static
* @property
*/
ve.ce.ListNode.domWrapperElementTypes = {
'bullet': 'ul',
'number': 'ol'
};
/* Methods */
/**
* Handle model update events.
*
* If the style changed since last update the DOM wrapper will be replaced with an appropriate one.
*
* @method
*/
ve.ce.ListNode.prototype.onUpdate = function () {
this.updateDomWrapper( 'style' );
};
/**
* Handle splice events.
*
* This is used to solve a rendering bug in Firefox.
* @see ve.ce.BranchNode.prototype.onSplice
*
* @method
*/
ve.ce.ListNode.prototype.onSplice = function () {
// Call parent implementation
ve.ce.BranchNode.prototype.onSplice.apply( this, Array.prototype.slice.call( arguments, 0 ) );
// There's a bug in Firefox where numbered lists aren't renumbered after in/outdenting
// list items. Force renumbering by requesting the height, which causes a reflow
this.$.css( 'height' );
};
/**
* Check if a slug be placed after the node.
*
* @method
* @returns {boolean} A slug can be placed after the node
*/
ve.ce.ListNode.prototype.canHaveSlugAfter = function () {
if ( this.getParent().getType() === 'listItem' ) {
// Nested lists should not have slugs after them
return false;
} else {
// Call the parent's implementation
return ve.ce.BranchNode.prototype.canHaveSlugAfter.call( this );
}
};
/* Registration */
ve.ce.nodeFactory.register( 'list', ve.ce.ListNode );