mediawiki-extensions-Visual.../modules/ve/ui/widgets/ve.ui.LinkTargetInputWidget.js
Trevor Parscal bf5ba1ea2b Fixed documentation errors
Many of these problems were introduced in I859b5871a9d2f17d970c002067c8ff24f3513e9f

Change-Id: Ifc2dc4934f782c4ce5107e3a356e357aef754083
2013-01-22 23:38:01 +00:00

88 lines
2.1 KiB
JavaScript

/*!
* VisualEditor user interface LinkTargetInputWidget class.
*
* @copyright 2011-2012 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* Creates an ve.ui.LinkTargetInputWidget object.
*
* @class
* @constructor
* @extends ve.ui.TextInputWidget
* @param {Function} $$ jQuery for the frame the widget is in
* @param {jQuery} $overlay DOM element to add menu to
* @param {string} [name] Input name, used by HTML forms
* @param {string} [value] Input value
*/
ve.ui.LinkTargetInputWidget = function VeUiLinkTargetInputWidget( $$, $overlay, name, value ) {
// Parent constructor
ve.ui.TextInputWidget.call( this, $$, name, value );
// Properties
this.annotation = null;
// Events
this.addListenerMethod( this, 'change', 'onChange' );
// Initialization
this.$.addClass( 've-ui-linkTargetInputWidget' );
};
/* Inheritance */
ve.inheritClass( ve.ui.LinkTargetInputWidget, ve.ui.TextInputWidget );
/* Methods */
/**
* Handles change events.
*
* @method
* @param {jQuery.Event} e Event
*/
ve.ui.LinkTargetInputWidget.prototype.onChange = function ( value ) {
if ( value === '' ) {
this.annotation = null;
} else {
var annotation = new ve.dm.LinkAnnotation();
annotation.data.href = value;
this.setAnnotation( annotation );
}
};
/**
* Sets the annotation value.
*
* The input value will automatically be updated.
*
* @method
* @param {ve.dm.LinkAnnotation} annotation Link annotation
*/
ve.ui.LinkTargetInputWidget.prototype.setAnnotation = function ( annotation ) {
this.annotation = annotation;
this.setValue( this.getTargetFromAnnotation( annotation ), 'annotation' );
};
/**
* Gets the annotation value.
*
* @method
* @returns {ve.dm.LinkAnnotation} Link annotation
*/
ve.ui.LinkTargetInputWidget.prototype.getAnnotation = function () {
return this.annotation;
};
/**
* Gets a target from an annotation.
*
* @method
* @param {ve.dm.LinkAnnotation} annotation Link annotation
* @returns {string} Target
*/
ve.ui.LinkTargetInputWidget.prototype.getTargetFromAnnotation = function ( annotation ) {
return annotation.data.href;
};