mediawiki-extensions-Visual.../modules/syntaxhighlight/ve.ce.MWSyntaxHighlightNode.js
Tongbo Sui 62ec9d92e2 SyntaxHighlight node support
Update: Switched to generic ve.ui.Toolbar and ve.ui.Tool for consistency
with VE in general. Changed searchbox to floating and hidden by default.
Call for search using shortcut key. Overriden ESC key.

Node handler for <syntaxhighlight>'s Rdfa type.
Embedded in VisualEditor.php with its own ResourceLoader module.
Use $wgVisualEditorEnableExperimentalCode in LocalSettings.php
to load the module.

Supported languages (for testing): text, javascript

Features:
(1) Internal mechanisms:
	(1.1) Tokenizer. Tokenize input code string.
	(1.2) Highlighter. Highlight based on predefined rules.
	(1.3) Syntax checker. Validate based on predefined rules.
(2) SimpleSurface:
	(2.1) Auto indenter. Works with (){}[] blocks.
	(2.2) Reformatter. Reformats spaces and remove trailing
	whitespaces.
	(2.3) Language selection dropdown.
	(2.4) Basic editing. Insert, deletion, selection.
	(2.5) Clipboard & edit history support.
		(2.5.1) Undo (Ctrl + Z), redo (Ctrl + Y)
		(2.5.2) Copy (Ctrl + C), cut (Ctrl + X), paste (Ctrl + V)
	(2.6) Search & replace. Ctrl + F to quickly move focus to search
	box.

Bug 47742

Change-Id: I4adede9e05fd2236cee50ce03f597e8ff6b1914d
2013-10-02 11:01:06 -07:00

132 lines
3.8 KiB
JavaScript

/*!
* VisualEditor ContentEditable MWSyntaxHighlightNode class.
*
* @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* ContentEditable MediaWiki syntaxhighlight node.
*
* @class
* @extends ve.ce.LeafNode
* @mixins ve.ce.FocusableNode
* @mixins ve.ce.ProtectedNode
* @mixins ve.ce.GeneratedContentNode
*
* @constructor
* @param {ve.dm.MWSyntaxHighlightNode} model Model to observe
* @param {Object} [config] Config options
*/
ve.ce.MWSyntaxHighlightNode = function VeCeMWSyntaxHighlightNode( model, config ) {
// Parent constructor
ve.ce.LeafNode.call( this, model, config );
// Mixin constructors
ve.ce.FocusableNode.call( this );
ve.ce.ProtectedNode.call( this );
ve.ce.GeneratedContentNode.call( this );
// DOM Changes
this.$.addClass( 've-ce-MWSyntaxHighlightNode mwSyntaxHighlight' );
// Helpers
this.highlighter = null;
this.tokenizer = null;
// Events
this.model.connect( this, { 'update': 'update' } );
// Initialization
this.update();
};
/* Inheritance */
ve.inheritClass( ve.ce.MWSyntaxHighlightNode, ve.ce.LeafNode );
ve.mixinClass( ve.ce.MWSyntaxHighlightNode, ve.ce.FocusableNode );
ve.mixinClass( ve.ce.MWSyntaxHighlightNode, ve.ce.ProtectedNode );
ve.mixinClass( ve.ce.MWSyntaxHighlightNode, ve.ce.GeneratedContentNode );
/* Static Properties */
ve.ce.MWSyntaxHighlightNode.static.name = 'mwSyntaxHighlight';
ve.ce.MWSyntaxHighlightNode.static.tagName = 'div';
ve.ce.MWSyntaxHighlightNode.static.renderHtmlAttributes = true;
/* Methods */
/**
* Called when the node starts generating new content.
* @method
*/
ve.ce.MWSyntaxHighlightNode.prototype.startGenerating = function () {
var lang = this.model.getAttribute( 'lang' );
// Properties
this.$wrapper = this.$$( '<div>' );
this.$code = this.$$( '<pre>' );
// Initialization
this.$wrapper
.addClass( lang + ' source-' + lang )
.append( this.$code );
// TODO perhaps replace with a prettier loading bar
this.$code.text( '[ Generating code preview... ]' );
this.highlighter = new ve.ce.MWSyntaxHighlightHighlighter( lang );
this.tokenizer = new ve.dm.MWSyntaxHighlightTokenizer();
};
/**
* Start a deferred process to generate the contents of the node.
* @returns {jQuery.Promise} Promise object
*/
ve.ce.MWSyntaxHighlightNode.prototype.generateContents = function () {
var data = this.model.getAttribute( 'body' ),
tokens = this.tokenizer.tokenize(data);
if ( this.highlighter.isSupportedLanguage() ){
if ( this.highlighter.isEnabledLanguage() ){
this.highlighter.initialize();
tokens = this.highlighter.mark(tokens, data, false);
this.$code.html(this.highlighter.displaySimple(tokens));
} else {
this.$code.html(this.highlighter.displaySimple(tokens));
this.$code.append( '>>>Support for this language is not enabled. Preview in plaintext.' );
}
} else {
this.$code.html(this.highlighter.displaySimple(tokens));
this.$code.append( '>>>This language is not supported. Preview in plaintext.' );
}
return this.$wrapper.promise();
};
/**
* Called when the has failed to generate new content.
* @method
*/
ve.ce.MWSyntaxHighlightNode.prototype.failGenerating = function () {
// TODO perhaps replace with a prettier sad face
this.$code.text( '[ Unable to generate code preview for this piece. ]' );
this.generatingPromise = null;
};
/**
* Called when the node successfully finishes generating new content.
*
* @method
* @param {jQuery} domElements jQuery object Generated content
*/
ve.ce.MWSyntaxHighlightNode.prototype.doneGenerating = function ( domElements ) {
var store = this.model.doc.getStore(),
hash = ve.getHash( this.model );
store.index( domElements.toArray() , hash );
this.render( domElements.toArray() );
this.generatingPromise = null;
};
/* Registration */
ve.ce.nodeFactory.register( ve.ce.MWSyntaxHighlightNode );