mediawiki-extensions-Visual.../modules/ve-mw/ui/actions/ve.ui.MWLinkAction.js

142 lines
4.2 KiB
JavaScript
Raw Normal View History

/*!
* VisualEditor UserInterface MWLinkAction class.
*
* @copyright 2011-2015 VisualEditor Team and others; see http://ve.mit-license.org
*/
/**
* Link action.
*
* Opens either MWLinkAnnotationInspector or MWLinkNodeInspector depending on what is selected.
*
* @class
* @extends ve.ui.LinkAction
* @constructor
* @param {ve.ui.Surface} surface Surface to act on
*/
ve.ui.MWLinkAction = function VeUiMWLinkAction( surface ) {
// Parent constructor
ve.ui.MWLinkAction.super.call( this, surface );
};
/* Inheritance */
OO.inheritClass( ve.ui.MWLinkAction, ve.ui.LinkAction );
/* Static Properties */
/**
* List of allowed methods for the action.
*
* @static
* @property
*/
ve.ui.MWLinkAction.static.methods = ve.ui.MWLinkAction.super.static.methods.concat( [ 'open', 'autolinkMagicLink' ] );
/* Methods */
/**
* Match the trailing punctuation set used for autolinks in wikitext.
* Closing parens are only stripped if open parens are missing from the
* candidate text, so that URLs with embedded matched parentheses (like
* wiki articles with disambiguation text) autolink nicely.
*
* @method
* @inheritdoc
*/
ve.ui.MWLinkAction.prototype.getTrailingPunctuation = function ( candidate ) {
// This is:
// * the "trailing punctuation" character set from
// Parse.php::makeFreeExternalLink(): [,;.:!?] and sometimes [)]
// * extended with characters banned by EXT_LINK_URL_CLASS: []<>"
// * further extended with international close quotes: "'”’›»“‘‹«」』
// https://en.wikipedia.org/wiki/Quotation_mark
return /\(/.test( candidate ) ?
/[,;.:!?\[\]<>\"\'”’›»“‘‹«」』]+$/ :
/[,;.:!?\[\]<>\"\'”’›»“‘‹«」』)]+$/;
};
/**
* @method
* @inheritdoc
* @return {ve.dm.MWExternalLinkAnnotation} The annotation to use.
*/
ve.ui.MWLinkAction.prototype.getLinkAnnotation = function ( linktext ) {
var title, targetData,
href = linktext;
// Is this a "magic link"?
if ( ve.dm.MWMagicLinkNode.static.validateContent( linktext ) ) {
return ve.dm.MWMagicLinkNode.static.annotationFromContent( linktext );
}
// Is this an internal link?
targetData = ve.dm.MWInternalLinkAnnotation.static.getTargetDataFromHref(
href,
this.surface.getModel().getDocument().getHtmlDocument()
);
if ( targetData.isInternal ) {
title = mw.Title.newFromText( targetData.title );
return ve.dm.MWInternalLinkAnnotation.static.newFromTitle( title );
}
// It's an external link.
return new ve.dm.MWExternalLinkAnnotation( {
type: 'link/mwExternal',
attributes: { href: href }
} );
};
/**
* Autolink the selected RFC/PMID/ISBN, which may have trailing punctuation
* followed by whitespace.
*
* @see ve.ui.LinkAction#autolinkUrl
* @method
* @return {boolean}
* True if the selection is a valid RFC/PMID/ISBN and the autolink action
* was executed; otherwise false.
*/
ve.ui.MWLinkAction.prototype.autolinkMagicLink = function () {
return this.autolink( function ( linktext ) {
return ve.dm.MWMagicLinkNode.static.validateContent( linktext );
} );
};
/**
* Open either the 'link' or 'linkNode' window, depending on what is selected.
*
* @method
* @return {boolean} Action was executed
*/
ve.ui.MWLinkAction.prototype.open = function () {
var fragment = this.surface.getModel().getFragment(),
selectedNode = fragment.getSelectedNode(),
windowName = 'link';
if ( selectedNode instanceof ve.dm.MWNumberedExternalLinkNode ) {
windowName = 'linkNode';
} else if ( selectedNode instanceof ve.dm.MWMagicLinkNode ) {
windowName = 'linkMagicNode';
}
this.surface.execute( 'window', 'open', windowName );
return true;
};
/* Registration */
ve.ui.actionFactory.register( ve.ui.MWLinkAction );
ve.ui.commandRegistry.register(
new ve.ui.Command(
'autolinkMagicLink', ve.ui.MWLinkAction.static.name, 'autolinkMagicLink',
{ supportedSelections: [ 'linear' ] }
)
);
ve.ui.sequenceRegistry.register(
// This regexp doesn't have to be precise; we'll validate the magic
// link in #autolinkMagicLink above.
// The trailing \S* covers any trailing punctuation, which will be
// stripped before validating the link.
new ve.ui.Sequence( 'autolinkMagicLink', 'autolinkMagicLink', /\b(RFC|PMID|ISBN)\s+[0-9]([- 0-9]*[0-9Xx])?\S*(\s|\n\n)$/, 0, true )
);