/*global mw*/ /** * VisualEditor user interface LinkInspector class. * * @copyright 2011-2012 VisualEditor Team and others; see AUTHORS.txt * @license The MIT License (MIT); see LICENSE.txt */ /** * Creates an ve.ui.LinkInspector object. * * @class * @constructor * @param {ve.ui.Toolbar} toolbar */ ve.ui.LinkInspector = function ( toolbar, context ) { // Inheritance ve.ui.Inspector.call( this, toolbar, context ); var inspector = this; this.context = context; // Elements this.$clearButton = $( '
', context.inspectorDoc ) .prependTo( this.$ ); this.$.prepend( $( '
', context.inspectorDoc ) .text( ve.msg( 'visualeditor-linkinspector-title' ) ) ); // Target this.$locationInput = $( '', context.inspectorDoc ).appendTo( this.$form ); this.initialValue = null; // Events this.$clearButton.click( function () { if ( $(this).is( '.es-inspector-button-disabled' ) ) { return; } var hash, surfaceModel = inspector.context.getSurfaceView().getModel(), annotations = inspector.getAllLinkAnnotationsFromSelection(); // Clear all link annotations. for ( hash in annotations ) { surfaceModel.annotate( 'clear', annotations[hash] ); } inspector.$locationInput.val( '' ); inspector.context.closeInspector(); } ); // Bind events to location input. this.$locationInput.on( 'change mousedown keydown cut paste', function () { setTimeout( function () { // Toggle disabled class if ( inspector.$locationInput.val() !== '' ) { inspector.$acceptButton.removeClass( 'es-inspector-button-disabled' ); } else { inspector.$acceptButton.addClass( 'es-inspector-button-disabled' ); } }, 0 ); } ); // Init multiSuggest for MediaWiki if ( 'mw' in window ) { this.initMultiSuggest(); } }; /* Methods */ ve.ui.LinkInspector.prototype.getAllLinkAnnotationsFromSelection = function () { var surfaceView = this.context.getSurfaceView(), surfaceModel = surfaceView.getModel(), documentModel = surfaceModel.getDocument(), annotations, linkAnnotations = {}; annotations = documentModel.getAnnotationsFromRange( surfaceModel.getSelection(), true ); linkAnnotations = ve.dm.Document.getMatchingAnnotations ( annotations, /^link\// ); if ( !ve.isEmptyObject( linkAnnotations ) ) { return linkAnnotations; } return null; }; ve.ui.LinkInspector.prototype.getFirstLinkAnnotation = function ( annotations ) { var hash; for ( hash in annotations ) { // Use the first one with a recognized type (there should only be one, this is just in case) if ( annotations[hash].type === 'link/WikiLink' || annotations[hash].type === 'link/ExtLink' || annotations[hash].type === 'link/ExtLink/Numbered' || annotations[hash].type === 'link/ExtLink/URL' ) { return annotations[hash]; } } return null; }; // TODO: This should probably be somewhere else but I needed this here for now. ve.ui.LinkInspector.prototype.getSelectionText = function () { var i, surfaceView = this.context.getSurfaceView(), surfaceModel = surfaceView.getModel(), documentModel = surfaceModel.getDocument(), data = documentModel.getData( surfaceModel.getSelection() ), str = '', max = Math.min( data.length, 255 ); for ( i = 0; i < max; i++ ) { if ( ve.isArray( data[i] ) ) { str += data[i][0]; } else if( typeof data[i] === 'string' ) { str += data[i]; } } return str; }; /* * Method called prior to opening inspector which fixes up * selection to contain the complete annotated link range * OR unwrap outer whitespace from selection. */ ve.ui.LinkInspector.prototype.prepareOpen = function () { var surfaceView = this.context.getSurfaceView(), surfaceModel = surfaceView.getModel(), doc = surfaceModel.getDocument(), annotations = this.getAllLinkAnnotationsFromSelection(), annotation = this.getFirstLinkAnnotation( annotations ), selection = surfaceModel.getSelection(), annotatedRange, newSelection; // Trim outer space from range if any. newSelection = doc.trimOuterSpaceFromRange( selection ); if ( annotation !== null ) { annotatedRange = doc.getAnnotatedRangeFromSelection( newSelection, annotation ); // Adjust selection if it does not contain the annotated range if ( selection.start > annotatedRange.start || selection.end < annotatedRange.end ) { newSelection = annotatedRange; // if selected from right to left if ( selection.from > selection.start ) { newSelection.flip(); } } } surfaceModel.change( null, newSelection ); }; ve.ui.LinkInspector.prototype.onOpen = function () { var annotation = this.getFirstLinkAnnotation( this.getAllLinkAnnotationsFromSelection() ), initialValue = ''; if ( annotation === null ) { this.$locationInput.val( this.getSelectionText() ); this.$clearButton.addClass( 'es-inspector-button-disabled' ); } else if ( annotation.type === 'link/WikiLink' ) { // Internal link initialValue = annotation.data.title || ''; this.$locationInput.val( initialValue ); this.$clearButton.removeClass( 'es-inspector-button-disabled' ); } else { // External link initialValue = annotation.data.href || ''; this.$locationInput.val( initialValue ); this.$clearButton.removeClass( 'es-inspector-button-disabled' ); } this.initialValue = initialValue; if ( this.$locationInput.val().length === 0 ) { this.$acceptButton.addClass( 'es-inspector-button-disabled' ); } else { this.$acceptButton.removeClass( 'es-inspector-button-disabled' ); } setTimeout( ve.bind( function () { this.$locationInput.focus().select(); }, this ), 0 ); }; ve.ui.LinkInspector.prototype.onClose = function ( accept ) { var surfaceView = this.context.getSurfaceView(), surfaceModel = surfaceView.getModel(), annotations = this.getAllLinkAnnotationsFromSelection(), target = this.$locationInput.val(), hash, annotation; if ( accept ) { if ( !target ) { return; } // Clear link annotation if it exists for ( hash in annotations ) { surfaceModel.annotate( 'clear', annotations[hash] ); } surfaceModel.annotate( 'set', ve.ui.LinkInspector.getAnnotationForTarget( target ) ); } // Restore focus surfaceView.getDocument().getDocumentNode().$.focus(); }; ve.ui.LinkInspector.getAnnotationForTarget = function ( target ) { var title; // Figure out if this is an internal or external link if ( target.match( /^(https?:)?\/\// ) ) { // External link return { 'type': 'link/ExtLink', 'data': { 'href': target } }; } else { // Internal link // TODO in the longer term we'll want to have autocompletion and existence&validity // checks using AJAX try { // FIXME mw dependency title = new mw.Title( target ); if ( title.getNamespaceId() === 6 || title.getNamespaceId() === 14 ) { // File: or Category: link // We have to prepend a colon so this is interpreted as a link // rather than an image inclusion or categorization target = ':' + target; } } catch ( e ) { } return { 'type': 'link/WikiLink', 'data': { 'title': target } }; } }; ve.ui.LinkInspector.prototype.initMultiSuggest = function() { var inspector = this, context = inspector.context, $overlay = context.$iframeOverlay, options; // Multi Suggest configuration. options = { 'parent': $overlay, 'prefix': 've-ui', // Build suggestion groups in order. 'suggestions': function( params ) { var groups = {}, results = params.results, query = params.query, modifiedQuery, title, prot; // Add existing pages. if ( results.length > 0 ) { groups.internal = { label: ve.msg( 'visualeditor-linkinspector-suggest-existing-page' ), items: results, itemClass: 'existing' }; } // Run the query through the mw.Title object to handle correct capitalization. try { title = new mw.Title( query ); modifiedQuery = title.getPrefixedText(); // If page doesn't exist, add New Page group. if ( ve.inArray( modifiedQuery, results ) === -1 ) { groups['new'] = { label: ve.msg( 'visualeditor-linkinspector-suggest-new-page' ), items: [modifiedQuery], itemClass: 'new' }; } } catch ( e ) { // invalid input ve.log( e ); } // Add external groups.external = { label: ve.msg( 'visualeditor-linkinspector-suggest-external-link' ), items: [], itemClass: 'existing' }; // Find a protocol and suggest an external link. prot = query.match( ve.init.platform.getExternalLinkUrlProtocolsRegExp() ); if ( prot ) { groups.external.items = [query]; // No protocol, default to http } else { groups.external.items = ['http://' + query]; } return groups; }, // Called on succesfull input. 'input': function( callback ) { var $input = $( this ), query = $input.val(), api = new mw.Api(); // Make AJAX Request. api.get( { action: 'opensearch', search: query }, { ok: function( data ) { // Position the iframe overlay below the input. context.positionIframeOverlay( { overlay: $overlay, below: $input } ); // Build callback( { query: query, results: data[1] } ); } } ); } }; // Setup Multi Suggest this.$locationInput.multiSuggest( options ); }; /* Inheritance */ ve.extendClass( ve.ui.LinkInspector, ve.ui.Inspector );