mediawiki-extensions-Visual.../modules/ve/ce/nodes/ve.ce.GeneratedContentNode.js
Roan Kattouw dc798befcf Copy DOM elements properly, into the correct document
* Provide a utility for copying an array of DOM elements into a
  different document
* Copy the DOM elements returned in toDomElements(), otherwise weird
  issues arise when the same data is converted to DOM twice

Change-Id: Ie927420624f0d4af0692e18d1bc6f952c8013d61
2013-06-18 15:40:33 -07:00

93 lines
2.2 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
*
* @constructor
*/
ve.ce.GeneratedContentNode = function VeCeGeneratedContentNode() {
// DOM Changes
this.$.addClass( 've-ce-generatedContentNode' );
this.$.attr( 'contenteditable', false );
// Events
this.model.connect( this, { 'update': 'onUpdate' } );
// Initialization
this.onUpdate();
};
/* Methods */
/**
* Handle update events.
*
* @method
*/
ve.ce.GeneratedContentNode.prototype.onUpdate = function () {
var doc = this.getElementDocument(),
store = this.model.doc.getStore(),
index = store.indexOfHash( ve.getHash( this.model ) );
if ( index !== null ) {
if ( this.live ) {
this.emit( 'teardown' );
}
this.$.empty().append(
ve.copyDomElements( store.value( index ), doc )
);
if ( this.live ) {
this.emit( 'setup' );
}
} 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
};