mediawiki-extensions-VisualEditor/modules/ve/es/nodes/ve.es.DocumentNode.js

/**
 * Creates an ve.es.DocumentNode object.
 * 
 * @class
 * @constructor
 * @extends {ve.es.BranchNode}
 * @param {ve.dm.DocumentNode} documentModel Document model to view
 * @param {ve.es.Surface} surfaceView Surface view this view is a child of
 */
ve.es.DocumentNode = function( model, surfaceView ) {
	// Inheritance
	ve.es.BranchNode.call( this, model );

	// Properties
	this.surfaceView = surfaceView;

	// DOM Changes
	this.$.addClass( 'es-documentView' );
};

/* Static Members */


/**
 * Mapping of symbolic names and splitting rules.
 * 
 * Each rule is an object with a self and children property. Each of these properties may contain
 * one of two possible values:
 *     Boolean - Whether a split is allowed
 *     Null - Node is a leaf, so there's nothing to split
 * 
 * @example Paragraph rules
 *     {
 *         'self': true
 *         'children': null
 *     }
 * @example List rules
 *     {
 *         'self': false,
 *         'children': true
 *     }
 * @example ListItem rules
 *     {
 *         'self': true,
 *         'children': false
 *     }
 */
ve.es.DocumentNode.splitRules = {};

/* Methods */

/**
 * Get the document offset of a position created from passed DOM event
 * 
 * @method
 * @param e {Event} Event to create ve.Position from
 * @returns {Integer} Document offset
 */
ve.es.DocumentNode.prototype.getOffsetFromEvent = function( e ) {
	var position = ve.Position.newFromEventPagePosition( e );
	return this.getOffsetFromRenderedPosition( position );
};

ve.es.DocumentNode.splitRules.document = {
	'self': false,
	'children': true
};

/* Inheritance */

ve.extendClass( ve.es.DocumentNode, ve.es.BranchNode );