mediawiki-extensions-Visual.../modules/ve/ce/nodes/ve.ce.GeneratedContentNode.js
Trevor Parscal c2defc9783 ve.Element refactor
Objectives:

* Move ve.ui.Element to ve.Element
* Make CE nodes inherit from ve.Element

Changes:

ve.ui.Element.js, ve.Element.js
* Move and rename
* Move ve.ui.get$$ to ve.Element.static.get$$
* Add static getDocument and getWindow methods
* Add instance getElementDocument and getElementWindow methods
* Add getTagName method, which by default reads the static tagName property, but when overridden can return a tag name based on other factors

*.php
* Updated file link

ve.ce.*Annotation.js, ve.ce.*Node.js, ve.ce.View.js, ve.ce.Document
* Added config options pass through
* Replaced passing elements through constructor with defining static tag names
* Added getTagName overrides where needed that derive tag name from model
* Refactore dom wrapper methods, now consistently using getTagName

ve.ce.Surface.js
* Removed static initialization (not needed)

ve.dm.Model.js, ve.ui.Window.js
* Added missing docs

ve.ui.GroupElement.js, ve.ui.Layout.js, ve.ui.Widget.js,
* Updated class name for elements

ve.ui.Frame.js, ve.ui.LookupInputWidget.js
* Updated location of get$$

ve.ui.js
* Move get$$ to ve.Element

ve.js
* Add auto-init of static properties to mixinClass

Change-Id: I39ae14966456903728e4d9e53f806ddce9ca2b70
2013-05-14 19:47:32 +00:00

102 lines
2.5 KiB
JavaScript

/*!
* VisualEditor ContentEditable GeneratedContentNode class.
*
* @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* ContentEditable generated content node.
*
* @class
* @abstract
* @extends ve.ce.LeafNode
* @constructor
* @param {ve.dm.GeneratedContentNode} model Model to observe
* @param {Object} [config] Config options
*/
ve.ce.GeneratedContentNode = function VeCeGeneratedContentNode( model, config ) {
// Parent constructor
ve.ce.LeafNode.call( this, model, config );
// DOM Changes
this.$.addClass( 've-ce-generatedContentNode' );
this.$.attr( 'contenteditable', false );
// Events
this.model.connect( this, { 'update': 'onUpdate' } );
// Initialization
this.onUpdate();
};
/* Inheritance */
ve.inheritClass( ve.ce.GeneratedContentNode, ve.ce.LeafNode );
/* Static Properties */
ve.ce.GeneratedContentNode.static.name = 'generatedContent';
/* Methods */
/**
* Handle update events.
*
* @method
*/
ve.ce.GeneratedContentNode.prototype.onUpdate = function () {
var store = this.model.doc.getStore(),
index = store.indexOfHash( ve.getHash( this.model ) );
if ( index !== null ) {
this.$.empty().append( store.value( index ) );
} else {
this.startGenerating();
this.generateContents()
.done( ve.bind( this.doneGenerating, this ) )
.fail( ve.bind( this.failGenerating, this ) );
}
};
/**
* Start a deferred process to generate the contents of the node.
* @returns {jQuery.Promise} Promise object
*/
ve.ce.GeneratedContentNode.prototype.generateContents = function () {
throw new Error( 've.ce.GeneratedContentNode subclass must implement generateContents' );
};
/**
* Called when the node starts generating new content.
* @method
*/
ve.ce.GeneratedContentNode.prototype.startGenerating = function () {
// TODO: add 'generating' style
};
/**
* Called when the node successfully finishes generating new content.
*
* @method
* @param {HTMLElement[]} domElements Generated content
*/
ve.ce.GeneratedContentNode.prototype.doneGenerating = function ( domElements ) {
var store = this.model.doc.getStore(),
hash = ve.getHash( this.model );
store.index( domElements, hash );
// TODO: remove 'generating' style
this.onUpdate();
};
/**
* Called when the has failed to generate new content.
* @method
*/
ve.ce.GeneratedContentNode.prototype.failGenerating = function () {
// TODO: remove 'generating' style
};
/* Registration */
ve.ce.nodeFactory.register( ve.ce.GeneratedContentNode );