mediawiki-extensions-CodeEd.../modules/jquery.codeEditor.js
Fomafix d4a5b7eddf Adapt toolbar icon change to change 19789d76 in WikiEditor
Bug: T125201
Change-Id: I58c1d246d3fbb8031e3be482f349a0538c44152c
2016-01-29 11:07:47 +00:00

830 lines
25 KiB
JavaScript

/* Ace syntax-highlighting code editor extension for wikiEditor */
/*global require, ace, confirm, prompt */
( function ( $, mw ) {
$.wikiEditor.modules.codeEditor = {
/**
* Core Requirements
*/
req: [ 'codeEditor' ],
/**
* Compatability map
*/
browsers: {
msie: [ [ '>=', 8 ] ],
ipod: [ [ '>=', 6 ] ],
iphone: [ [ '>=', 6 ] ],
android: [ [ '>=', 4 ] ]
},
/**
* Configuration
*/
cfg: {
//
},
/**
* API accessible functions
*/
api: {
//
},
/**
* Event handlers
*/
evt: {
//
},
/**
* Internally used functions
*/
fn: {
}
};
$.wikiEditor.extensions.codeEditor = function ( context ) {
var saveAndExtend,
textSelectionFn,
hasErrorsOnSave = false,
selectedLine = 0,
cookieEnabled,
returnFalse = function () { return false; },
extIconPath = mw.config.get( 'wgCodeEditorAssetsPath', mw.config.get( 'wgExtensionAssetsPath' ) ) + '/CodeEditor/images/',
api = new mw.Api();
// Initialize state
cookieEnabled = parseInt( mw.cookie.get( 'codeEditor-' + context.instance + '-showInvisibleChars' ), 10 );
context.showInvisibleChars = ( cookieEnabled === 1 );
cookieEnabled = parseInt( mw.cookie.get( 'codeEditor-' + context.instance + '-lineWrappingActive' ), 10 );
context.lineWrappingActive = ( cookieEnabled === 1 );
context.showSearchReplace = 0;
/*
* Event Handlers
*
* WikiEditor inspects the 'evt' object for event names and uses them if present as additional
* event handlers that fire before the default handling.
* To prevent WikiEditor from running its own handling, handlers should return false.
*
* This is also where we can attach some extra information to the events.
*/
context.evt = $.extend( context.evt, {
keydown: returnFalse,
change: returnFalse,
delayedChange: returnFalse,
cut: returnFalse,
paste: returnFalse,
ready: returnFalse,
codeEditorSubmit: function () {
context.evt.codeEditorSync();
if ( hasErrorsOnSave ) {
hasErrorsOnSave = false;
return confirm( mw.msg( 'codeeditor-save-with-errors' ) );
}
},
codeEditorSave: function () {
var i,
annotations = context.codeEditor.getSession().getAnnotations();
for ( i = 0; i < annotations.length; i++ ) {
if ( annotations[ i ].type === 'error' ) {
hasErrorsOnSave = true;
break;
}
}
},
codeEditorSync: function () {
context.$textarea.val( context.$textarea.textSelection( 'getContents' ) );
}
} );
context.codeEditorActive = mw.user.options.get( 'usecodeeditor' ) !== '0';
/**
* Internally used functions
*/
context.fn = $.extend( context.fn, {
codeEditorToolbarIcon: function () {
return extIconPath + ( context.codeEditorActive ? 'editor.png' : 'editor-off.png' );
},
invisibleCharsToolbarIcon: function () {
return extIconPath + ( context.showInvisibleChars ? 'markup.png' : 'markup-off.png' );
},
lineWrappingToolbarIcon: function () {
return extIconPath + ( context.lineWrappingActive ? 'wrapping.png' : 'wrapping-off.png' );
},
changeCookieValue: function ( cookieName, value ) {
mw.cookie.set(
'codeEditor-' + context.instance + '-' + cookieName,
value
);
},
aceGotoLineColumn: function () {
var lineinput = prompt( 'Enter line number:', 'line:column' ),
matches = lineinput.split( ':' ),
line = 0,
column = 0;
if ( matches.length > 0 ) {
line = parseInt( matches[ 0 ], 10 ) || 0;
line--;
}
if ( matches.length > 1 ) {
column = parseInt( matches[ 1 ], 10 ) || 0;
column--;
}
context.codeEditor.navigateTo( line, column );
// Scroll up a bit to give some context
context.codeEditor.scrollToRow( line - 4 );
},
setupCodeEditorToolbar: function () {
var toggleEditor,
toggleInvisibleChars,
toggleSearchReplace,
toggleLineWrapping,
indent, outdent, gotoLine;
toggleEditor = function ( context ) {
context.codeEditorActive = !context.codeEditorActive;
context.fn.setCodeEditorPreference( context.codeEditorActive );
context.fn.updateCodeEditorToolbarButton();
if ( context.codeEditorActive ) {
// set it back up!
context.fn.setupCodeEditor();
} else {
context.fn.disableCodeEditor();
}
};
toggleInvisibleChars = function ( context ) {
context.showInvisibleChars = !context.showInvisibleChars;
context.fn.changeCookieValue( 'showInvisibleChars', context.showInvisibleChars ? 1 : 0 );
context.fn.updateInvisibleCharsButton();
context.codeEditor.setShowInvisibles( context.showInvisibleChars );
};
toggleSearchReplace = function ( context ) {
context.showSearchReplace = !context.showSearchReplace;
if ( context.showSearchReplace ) {
ace.config.loadModule( 'ace/ext/searchbox', function ( e ) {
// ace.editor.searchBox.show();
e.Search( context.codeEditor, !0 );
} );
} else {
context.codeEditor.searchBox.hide();
}
};
toggleLineWrapping = function ( context ) {
context.lineWrappingActive = !context.lineWrappingActive;
context.fn.changeCookieValue( 'lineWrappingActive', context.lineWrappingActive ? 1 : 0 );
context.fn.updateLineWrappingButton();
context.codeEditor.getSession().setUseWrapMode( context.lineWrappingActive );
};
indent = function ( context ) {
context.codeEditor.execCommand( 'indent' );
};
outdent = function ( context ) {
context.codeEditor.execCommand( 'outdent' );
};
gotoLine = function ( context ) {
context.codeEditor.execCommand( 'gotolinecolumn' );
};
context.api.addToToolbar( context, {
section: 'main',
groups: {
'codeeditor-main': {
tools: {
codeEditor: {
labelMsg: 'codeeditor-toolbar-toggle',
type: 'button',
icon: context.fn.codeEditorToolbarIcon(),
action: {
type: 'callback',
execute: toggleEditor
}
}
}
},
'codeeditor-format': {
tools: {
indent: {
labelMsg: 'codeeditor-indent',
type: 'button',
icon: extIconPath + 'indent.png',
action: {
type: 'callback',
execute: indent
}
},
outdent: {
labelMsg: 'codeeditor-outdent',
type: 'button',
icon: extIconPath + 'outdent.png',
action: {
type: 'callback',
execute: outdent
}
}
}
},
'codeeditor-style': {
tools: {
invisibleChars: {
labelMsg: 'codeeditor-invisibleChars-toggle',
type: 'button',
icon: context.fn.invisibleCharsToolbarIcon(),
action: {
type: 'callback',
execute: toggleInvisibleChars
}
},
lineWrapping: {
labelMsg: 'codeeditor-lineWrapping-toggle',
type: 'button',
icon: context.fn.lineWrappingToolbarIcon(),
action: {
type: 'callback',
execute: toggleLineWrapping
}
},
gotoLine: {
labelMsg: 'codeeditor-gotoline',
type: 'button',
icon: extIconPath + 'gotoline.png',
action: {
type: 'callback',
execute: gotoLine
}
},
toggleSearchReplace: {
labelMsg: 'codeeditor-searchReplace-toggle',
type: 'button',
icon: extIconPath + 'search-replace.png',
action: {
type: 'callback',
execute: toggleSearchReplace
}
}
}
}
}
} );
$( '.group-codeeditor-style' ).prependTo( '.section-main' );
$( '.group-codeeditor-format' ).prependTo( '.section-main' );
$( '.group-codeeditor-main' ).prependTo( '.section-main' );
},
updateButtonIcon: function ( targetName, iconFn ) {
var target = '.tool[rel=' + targetName + ']',
$icon = context.modules.toolbar.$toolbar.find( target );
$icon.css( 'background-image', 'url(' + iconFn() + ')' );
},
updateCodeEditorToolbarButton: function () {
context.fn.updateButtonIcon( 'codeEditor', context.fn.codeEditorToolbarIcon );
},
updateInvisibleCharsButton: function () {
context.fn.updateButtonIcon( 'invisibleChars', context.fn.invisibleCharsToolbarIcon );
},
updateLineWrappingButton: function () {
context.fn.updateButtonIcon( 'lineWrapping', context.fn.lineWrappingToolbarIcon );
},
setCodeEditorPreference: function ( prefValue ) {
// Do not try to save options for anonymous user
if ( mw.user.isAnon() ) {
return;
}
// Abort any previous request
api.abort();
api.saveOption( 'usecodeeditor', prefValue ? 1 : 0 )
.fail( function ( code, result ) {
var message;
if ( code === 'http' && result.textStatus === 'abort' ) {
// Request was aborted. Ignore error
return;
}
message = 'Failed to set code editor preference: ' + code;
if ( result.error && result.error.info ) {
message += '\n' + result.error.info;
}
mw.log.warn( message );
} );
},
/**
* Sets up the iframe in place of the textarea to allow more advanced operations
*/
setupCodeEditor: function () {
var box, lang, basePath, container, editdiv, session, AceLangMode;
box = context.$textarea;
lang = mw.config.get( 'wgCodeEditorCurrentLanguage' );
basePath = mw.config.get( 'wgExtensionAssetsPath', '' );
if ( basePath.substring( 0, 2 ) === '//' ) {
// ACE uses web workers, which have importScripts, which don't like relative links.
// This is a problem only when the assets are on another server, so this rewrite should suffice
// Protocol relative
basePath = window.location.protocol + basePath;
}
ace.config.set( 'basePath', basePath + '/CodeEditor/modules/ace' );
if ( lang ) {
// Ace doesn't like replacing a textarea directly.
// We'll stub this out to sit on top of it...
// line-height is needed to compensate for oddity in WikiEditor extension, which zeroes the line-height on a parent container
container = context.$codeEditorContainer = $( '<div style="position: relative"><div class="editor" style="line-height: 1.5em; top: 0; left: 0; right: 0; bottom: 0; position: absolute;"></div></div>' ).insertAfter( box );
editdiv = container.find( '.editor' );
box.css( 'display', 'none' );
container.height( box.height() );
// Non-lazy loaded dependencies: Enable code completion
ace.require( 'ace/ext/language_tools' );
// Load the editor now
context.codeEditor = ace.edit( editdiv[ 0 ] );
context.codeEditor.getSession().setValue( box.val() );
box.textSelection( 'register', textSelectionFn );
// Disable some annoying commands
context.codeEditor.commands.removeCommand( 'replace' ); // ctrl+R
context.codeEditor.commands.removeCommand( 'transposeletters' ); // ctrl+T
context.codeEditor.commands.removeCommand( 'gotoline' ); // ctrl+L
context.codeEditor.setReadOnly( box.prop( 'readonly' ) );
context.codeEditor.setShowInvisibles( context.showInvisibleChars );
// The options to enable
context.codeEditor.setOptions( {
enableBasicAutocompletion: true,
enableSnippets: true
} );
context.codeEditor.commands.addCommand( {
name: 'gotolinecolumn',
bindKey: { mac: 'Command-Shift-L', windows: 'Ctrl-Alt-L' },
exec: context.fn.aceGotoLineColumn,
readOnly: true
} );
box.closest( 'form' )
.submit( context.evt.codeEditorSubmit )
.find( '#wpSave' ).click( context.evt.codeEditorSave );
session = context.codeEditor.getSession();
// Use proper tabs
session.setUseSoftTabs( false );
session.setUseWrapMode( context.lineWrappingActive );
if ( mw.hook ) {
mw.hook( 'codeEditor.configure' ).fire( session );
}
ace.config.loadModule( 'ace/mode/' + lang, function () {
AceLangMode = require( 'ace/mode/' + lang ).Mode;
session.setMode( new AceLangMode() );
} );
// Use jquery.ui.resizable so user can make the box taller too
container.resizable( {
handles: 's',
minHeight: box.height(),
resize: function () {
context.codeEditor.resize();
}
} );
$( '.wikiEditor-ui-toolbar' ).addClass( 'codeEditor-ui-toolbar' );
if ( selectedLine > 0 ) {
// Line numbers in CodeEditor are zero-based
context.codeEditor.navigateTo( selectedLine - 1, 0 );
// Scroll up a bit to give some context
context.codeEditor.scrollToRow( selectedLine - 4 );
}
context.fn.setupStatusBar();
// Let modules know we're ready to start working with the content
context.fn.trigger( 'ready' );
}
},
/**
* Turn off the code editor view and return to the plain textarea.
* May be needed by some folks with funky browsers, or just to compare.
*/
disableCodeEditor: function () {
// Kills it!
context.$textarea.closest( 'form' )
.off( 'submit', context.evt.codeEditorSubmit )
.find( '#wpSave' ).off( 'click', context.evt.codeEditorSave );
// Save contents
context.$textarea.textSelection( 'unregister' );
context.$textarea.val( textSelectionFn.getContents() );
// @todo fetch cursor, scroll position
// Drop the fancy editor widget...
context.fn.removeStatusBar();
context.$codeEditorContainer.remove();
context.$codeEditorContainer = undefined;
context.codeEditor = undefined;
// Restore textarea
context.$textarea.show();
// Restore toolbar
$( '.wikiEditor-ui-toolbar' ).removeClass( 'codeEditor-ui-toolbar' );
// @todo restore cursor, scroll position
},
/**
* Start monitoring the fragment of the current window for hash change
* events. If the hash is already set, handle it as a new event.
*/
codeEditorMonitorFragment: function () {
function onHashChange() {
var regexp, result;
regexp = /#mw-ce-l(\d+)/;
result = regexp.exec( window.location.hash );
if ( result === null ) {
return;
}
selectedLine = parseInt( result[ 1 ], 10 );
if ( context.codeEditor && selectedLine > 0 ) {
// Line numbers in CodeEditor are zero-based
context.codeEditor.navigateTo( selectedLine - 1, 0 );
// Scroll up a bit to give some context
context.codeEditor.scrollToRow( selectedLine - 4 );
}
}
onHashChange();
$( window ).on( 'hashchange', onHashChange );
},
/**
* This creates a Statusbar, that allows you to see a count of the
* errors, warnings and the warning of the current line, as well as
* the position of the cursor.
*/
setupStatusBar: function () {
var shouldUpdateAnnotations,
shouldUpdateSelection,
shouldUpdateLineInfo,
nextAnnotation,
delayedUpdate,
editor = context.codeEditor,
lang = require( 'ace/lib/lang' ),
$errors = $( '<span class="codeEditor-status-worker-cell ace_gutter-cell ace_error">0</span>' ),
$warnings = $( '<span class="codeEditor-status-worker-cell ace_gutter-cell ace_warning">0</span>' ),
$infos = $( '<span class="codeEditor-status-worker-cell ace_gutter-cell ace_info">0</span>' ),
$message = $( '<div>' ).addClass( 'codeEditor-status-message' ),
$lineAndMode = $( '<div>' ).addClass( 'codeEditor-status-line' ),
$workerStatus = $( '<div>' )
.addClass( 'codeEditor-status-worker' )
.attr( 'title', mw.msg( 'codeeditor-next-annotation' ) )
.append( $errors )
.append( $warnings )
.append( $infos );
context.$statusBar = $( '<div>' )
.addClass( 'codeEditor-status' )
.append( $workerStatus )
.append( $message )
.append( $lineAndMode );
/* Help function to concatenate strings with different separators */
function addToStatus( status, str, separator ) {
if ( str ) {
status.push( str, separator || '|' );
}
}
/**
* Update all the information in the status bar
*/
function updateStatusBar() {
var i, c, r,
status,
annotation,
errors = 0,
warnings = 0,
infos = 0,
distance,
shortestDistance = Infinity,
closestAnnotation,
currentLine = editor.selection.lead.row,
annotations = editor.getSession().getAnnotations(),
closestType;
// Reset the next annotation
nextAnnotation = null;
for ( i = 0; i < annotations.length; i++ ) {
annotation = annotations[ i ];
distance = Math.abs( currentLine - annotation.row );
if ( distance < shortestDistance ) {
shortestDistance = distance;
closestAnnotation = annotation;
}
if ( nextAnnotation === null && annotation.row > currentLine ) {
nextAnnotation = annotation;
}
switch ( annotations[ i ].type ) {
case 'error':
errors++;
break;
case 'warning':
warnings++;
break;
case 'info':
infos++;
break;
}
}
// Wrap around to the beginning for nextAnnotation
if ( nextAnnotation === null && annotations.length > 0 ) {
nextAnnotation = annotations[ 0 ];
}
// Update the annotation counts
if ( shouldUpdateAnnotations ) {
$errors.text( errors );
$warnings.text( warnings );
$infos.text( infos );
}
// Show the message of the current line, if we have not already done so
if ( closestAnnotation &&
currentLine === closestAnnotation.row &&
closestAnnotation !== $message.data( 'annotation' ) ) {
$message.data( 'annotation', closestAnnotation );
closestType =
closestAnnotation.type.charAt( 0 ).toUpperCase() +
closestAnnotation.type.slice( 1 );
$message.text( closestType + ': ' + closestAnnotation.text );
} else if ( $message.data( 'annotation' ) !== null &&
( !closestAnnotation || currentLine !== closestAnnotation.row ) ) {
// If we are on a different line without an annotation, then blank the message
$message.data( 'annotation', null );
$message.text( '' );
}
// The cursor position has changed
if ( shouldUpdateSelection || shouldUpdateLineInfo ) {
// Adapted from Ajax.org's ace/ext/statusbar module
status = [];
if ( editor.$vimModeHandler ) {
addToStatus( status, editor.$vimModeHandler.getStatusText() );
} else if ( editor.commands.recording ) {
addToStatus( status, 'REC' );
}
c = editor.selection.lead;
addToStatus( status, ( c.row + 1 ) + ':' + c.column, '' );
if ( !editor.selection.isEmpty() ) {
r = editor.getSelectionRange();
addToStatus( status, '(' + ( r.end.row - r.start.row ) + ':' + ( r.end.column - r.start.column ) + ')' );
}
status.pop();
$lineAndMode.text( status.join( '' ) );
}
shouldUpdateLineInfo = shouldUpdateSelection = shouldUpdateAnnotations = false;
}
// Function to delay/debounce updates for the StatusBar
delayedUpdate = lang.delayedCall( function () {
updateStatusBar( editor );
}.bind( this ) );
/**
* Click handler that allows you to skip to the next annotation
*/
$workerStatus.on( 'click', function ( e ) {
if ( nextAnnotation ) {
context.codeEditor.navigateTo( nextAnnotation.row, nextAnnotation.column );
// Scroll up a bit to give some context
context.codeEditor.scrollToRow( nextAnnotation.row - 3 );
e.preventDefault();
}
} );
editor.getSession().on( 'changeAnnotation', function () {
shouldUpdateAnnotations = true;
delayedUpdate.schedule( 100 );
} );
editor.on( 'changeStatus', function () {
shouldUpdateLineInfo = true;
delayedUpdate.schedule( 100 );
} );
editor.on( 'changeSelection', function () {
shouldUpdateSelection = true;
delayedUpdate.schedule( 100 );
} );
// Force update
shouldUpdateLineInfo = shouldUpdateSelection = shouldUpdateAnnotations = true;
updateStatusBar( editor );
context.$statusBar.insertAfter( $( '.wikiEditor-ui-view-wikitext .wikiEditor-ui-bottom' ) );
},
removeStatusBar: function () {
context.codeEditor.getSession().removeListener( 'changeAnnotation' );
context.codeEditor.removeListener( 'changeSelection' );
context.codeEditor.removeListener( 'changeStatus' );
context.nextAnnotation = null;
context.$statusBar = null;
$( '.codeEditor-status' ).remove();
}
} );
/**
* Override the base functions in a way that lets
* us fall back to the originals when we turn off.
*/
saveAndExtend = function ( base, extended ) {
$.map( extended, function ( func, name ) {
var orig;
if ( name in base ) {
orig = base[ name ];
base[ name ] = function () {
if ( context.codeEditorActive ) {
return func.apply( this, arguments );
}
if ( orig ) {
return orig.apply( this, arguments );
}
throw new Error( 'CodeEditor: no original function to call for ' + name );
};
} else {
base[ name ] = func;
}
} );
};
saveAndExtend( context.fn, {
saveCursorAndScrollTop: function () {
// Stub out textarea behavior
return;
},
restoreCursorAndScrollTop: function () {
// Stub out textarea behavior
return;
},
saveSelection: function () {
mw.log( 'codeEditor stub function saveSelection called' );
},
restoreSelection: function () {
mw.log( 'codeEditor stub function restoreSelection called' );
},
/**
* Scroll an element to the top of the iframe
*/
scrollToTop: function () {
mw.log( 'codeEditor stub function scrollToTop called' );
}
} );
/**
* Compatibility with the $.textSelection jQuery plug-in. When the iframe is in use, these functions provide
* equivalant functionality to the otherwise textarea-based functionality.
*/
textSelectionFn = {
/* Needed for search/replace */
getContents: function () {
return context.codeEditor.getSession().getValue();
},
setContents: function ( newContents ) {
context.codeEditor.getSession().setValue( newContents );
},
/**
* Gets the currently selected text in the content
* DO NOT CALL THIS DIRECTLY, use $.textSelection( 'functionname', options ) instead
*/
getSelection: function () {
return context.codeEditor.getCopyText();
},
/**
* Inserts text at the begining and end of a text selection, optionally inserting text at the caret when
* selection is empty.
* DO NOT CALL THIS DIRECTLY, use $.textSelection( 'functionname', options ) instead
*/
encapsulateSelection: function ( options ) {
var sel, range, selText, isSample, text;
// Does not yet handle 'ownline', 'splitlines' option
sel = context.codeEditor.getSelection();
range = sel.getRange();
selText = textSelectionFn.getSelection();
isSample = false;
if ( !selText ) {
selText = options.peri;
isSample = true;
} else if ( options.replace ) {
selText = options.peri;
}
text = options.pre;
text += selText;
text += options.post;
context.codeEditor.insert( text );
if ( isSample && options.selectPeri && !options.splitlines ) {
// May esplode if anything has newlines, be warned. :)
range.setStart( range.start.row, range.start.column + options.pre.length );
range.setEnd( range.start.row, range.start.column + selText.length );
sel.setSelectionRange( range );
}
return context.$textarea;
},
/**
* Gets the position (in resolution of bytes not nessecarily characters) in a textarea
* DO NOT CALL THIS DIRECTLY, use $.textSelection( 'functionname', options ) instead
*/
getCaretPosition: function () {
mw.log( 'codeEditor stub function getCaretPosition called' );
},
/**
* Sets the selection of the content
* DO NOT CALL THIS DIRECTLY, use $.textSelection( 'functionname', options ) instead
*
* @param {Object} options
*/
setSelection: function ( options ) {
var doc, lines, offsetToPos, start, end, sel, range;
// Ace stores positions for ranges as row/column pairs.
// To convert from character offsets, we'll need to iterate through the document
doc = context.codeEditor.getSession().getDocument();
lines = doc.getAllLines();
offsetToPos = function ( offset ) {
var row, col, pos;
row = 0;
col = 0;
pos = 0;
while ( row < lines.length && pos + lines[ row ].length < offset ) {
pos += lines[ row ].length;
pos++; // for the newline
row++;
}
col = offset - pos;
return { row: row, column: col };
};
start = offsetToPos( options.start );
end = offsetToPos( options.end );
sel = context.codeEditor.getSelection();
range = sel.getRange();
range.setStart( start.row, start.column );
range.setEnd( end.row, end.column );
sel.setSelectionRange( range );
return context.$textarea;
},
/**
* Scroll a textarea to the current cursor position. You can set the cursor position with setSelection()
* DO NOT CALL THIS DIRECTLY, use $.textSelection( 'functionname', options ) instead
*/
scrollToCaretPosition: function () {
mw.log( 'codeEditor stub function scrollToCaretPosition called' );
return context.$textarea;
}
};
/* Setup the editor */
context.fn.setupCodeEditorToolbar();
if ( context.codeEditorActive ) {
context.fn.setupCodeEditor();
}
};
}( jQuery, mediaWiki ) );